zint/docs
gitlost 5e2044ff2e CODE128: reduce extended latch cut-off from 5 to 4 for better
encodation in certain cases (and no pessimizations found so far),
  props lyngklip (BWIPP);
  fix extended char latching when exactly 3 extended chars at end;
  count code set C (not digits) in loop deciding when to
  shift/latch to extended for better estimate
AZTEC: return warning if ECC < 5% (due to bit-stuffing when version
  given); return error if > 22 layers (Zint 26) for Reader
  Initialisation symbol requested for better error message
AZTEC/HANXIN/QRCODE: consolidate different ECC data size tables
  into one indexed by ECC
DBAR_EXP: check for reduced length <= 77 up front for better error
  message
HANXIN: use `malloc()` rather than `z_alloca()` for large binary
  array
QRCODE: `ecc_level` now 0-based (not 1-based)
MICROQR: consolidate different version end routines into one
  `microqr_end()` and use new `microqr_data` table to simplify code
MICROPDF417: use table for max codewords per column
library: centralize all error messages using new `errtxt()`,
  `errtxtf()`, `errtxt_adj()` funcs that protect `symbol->errtxt`
  from overflow, & try to make error messages more consistent
  thru-out, adding more feedback info to many, & use positional
  args "%n$" in prep for l10n (maybe);
  `is_sane/is_sane_lookup()` -> `not_sane/not_sane_lookup()`,
  returning 1-based position (zero on failure) instead of bool;
  `long` ints -> plain `int` (except those dealing with `ftell()`,
  `fread()` etc) as depend on int being 32-bits already
GUI: in "grpDATF.ui" use "PlainText" rather than "RichText" for
  tracker ratio examples as height of text messing up sometimes
manual: clarify Codablock-F length maximum & add examples
docs: README: pandoc 3.5, Ubuntu 24.04
CMake: use "-Wpedantic" for Clang only as GNU complains about
  `errtxtf()` positional args "%n$"
2024-10-27 21:33:33 +00: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 CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00:00
manual.pmd CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00:00
manual.txt CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00:00
README CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00: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
zint.1 CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00:00
zint.1.pmd CODE128: reduce extended latch cut-off from 5 to 4 for better 2024-10-27 21:33:33 +00:00

% docs/README 2024-10-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 and Ubuntu 24.04)

    wget https://github.com/jgm/pandoc/releases/download/3.5/pandoc-3.5-1-amd64.deb
    sudo dpkg -i pandoc-3.5-1-amd64.deb
For Ubuntu 22.04 (python < 3.12)
    sudo apt install python3-pip
    pip install pandoc-tablenos --user
Else for Ubuntu 24.04 (one way around "externally-managed-environment" error, PEP 668)
	sudo apt install python3-full
	python3 -m venv ~/py_envs
	source ~/py_envs/bin/activate
	pip install pandoc-tablenos
Then
    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) and Fedora Linux 40 (Workstation Edition))

    wget https://github.com/jgm/pandoc/releases/download/3.5/pandoc-3.5-linux-amd64.tar.gz
    tar xf pandoc-3.5-linux-amd64.tar.gz
    sudo mv -i pandoc-3.5/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.