zint-barcode-generator/docs
gitlost 7246d67175 gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing
`iso3166list` linter and adjusting all others to allow for
  multiple optional linters (by checking `data_len` vs `offset`)
library: change invalid `input_mode` reset to return warning;
  split func table into 2 - func declarations without prototype
  will be error in C23;
  make invalid symbology check a separate function using a table
  and call near beginning of `ZBarcode_Encode_Segs()`;
  in `ZBarcode_BarcodeName()` save some bytes by simplifying
  name table and removing "BARCODE_" prefix from entries
output: fix pack logic to use pragma by default (actually more
  portable than `__attribute__`)
common.h: remove C99 detection which was artifice of specifying
  "-std=", and rejig layout to be more logical
BWIPP: update to latest version
general: change `ZINT_VERSION_BUILD` tests to `#if`s
general: further fiddling with some tables to save a few bytes
CLI: change function arg `optarg` -> `arg` so doesn't shadow
  global
general: library now compilable with Comp Cert C (though as it
  doesn't support `alloca()` will have multiple memory leaks)
2024-06-27 23:00:13 +01:00
..
images Version 2.13.0 2023-12-18 09:44:47 +00:00
templates gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
inc_before_body_html.html Remove bitmap_byte_length member from zint_symbol 2023-07-18 11:11:50 +01:00
inc_before_body_pdf.tex GRIDMATRIX: default char set is GB 2312 only, not Latin-1 with GB 2312 alt 2022-05-19 10:17:51 +01:00
inc_header_pdf.tex Remove bitmap_byte_length member from zint_symbol 2023-07-18 11:11:50 +01:00
inc_header_txt.tex Update URL for manual (no longer ASPX) 2022-08-23 10:53:56 +01:00
Makefile general: use explicit float consts rather than calced ones 2024-01-09 18:38:21 +00:00
manual.html gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
manual.pmd gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
manual.txt gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
README gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
zint.1 gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
zint.1.pmd gs1/gs1_lint: update to latest gs1-syntax-dictionary, removing 2024-06-27 23:00:13 +01:00
zint_images.sh Actually change SVG font to "Arimo, Arial, sans-serif" ([607e4ed]) 2023-06-13 18:12:20 +01:00
zint_org_uk.py Transition to Python script for HTML generation, also correcting pandoc theme issue 2022-07-19 17:11:33 +01:00
zint_org_uk.sh Harmonise manual versions and add auto-formatting tool for Zint.org.uk website 2022-07-19 12:33:51 +01:00

% docs/README 2024-06-27

For generation of "docs/manual.pdf" and "docs/manual.txt" from "manual.pmd" using a recent version of pandoc

On Ubuntu/Debian (tested on Ubuntu 22.04)

    wget https://github.com/jgm/pandoc/releases/download/3.2.1/pandoc-3.2.1-1-amd64.deb
    sudo dpkg -i pandoc-3.2.1-1-amd64.deb
    sudo apt install python3-pip
    pip install pandoc-tablenos --user
    export PATH=~/.local/bin:"$PATH"
	# Temporary fix for version regex - see https://github.com/tomduck/pandoc-xnos/pull/29
	python -m pip install --force-reinstall \
	    git+https://github.com/tomduck/pandoc-xnos@284474574f51888be75603e7d1df667a0890504d#egg=pandoc-xnos
    sudo apt install librsvg2-bin
    sudo apt install texlive-xetex
    sudo apt install texlive-lang-cjk
    sudo apt install fonts-wqy-microhei
    make

On Fedora (tested on Fedora Linux 38 (Workstation Edition))

    wget https://github.com/jgm/pandoc/releases/download/3.2.1/pandoc-3.2.1-linux-amd64.tar.gz
    tar xf pandoc-3.2.1-linux-amd64.tar.gz
    sudo mv -i pandoc-3.2.1/bin/pandoc /usr/local/bin
    sudo dnf install python3-pip
    pip install pandoc-tablenos --user
    export PATH=~/.local/bin:"$PATH"
	# Temporary fix for version regex - see https://github.com/tomduck/pandoc-xnos/pull/29
	python -m pip install --force-reinstall \
	    git+https://github.com/tomduck/pandoc-xnos@284474574f51888be75603e7d1df667a0890504d#egg=pandoc-xnos
    sudo dnf install librsvg2-tools.x86_64
    sudo dnf install texlive-xetex
    sudo dnf install texlive-ctex.noarch
    sudo dnf install texlive-framed.noarch
    sudo dnf install texlive-fvextra.noarch
    sudo dnf install texlive-mdwtools.noarch
    sudo dnf install texlive-sectsty.noarch
    sudo dnf install texlive-xecjk.noarch
    sudo dnf install texlive-tex-gyre.noarch
    sudo dnf install wqy-microhei-fonts.noarch
    make

On Windows

    Not compatible.