zint/docs
gitlost e30e1f9651 RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
  certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
  rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
  button, independently movable picker (NULL parent), preview colour changes,
  preview Data Window changes, add clear data (del) buttons, add zap button
  and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
  UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
  various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-09 21:52:02 +01:00
..
images RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +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 CLI: return ZINT_ERROR_INVALID_OPTION instead of 1 on bad option and 2022-05-22 21:33:45 +01:00
inc_header_txt.tex GRIDMATRIX: default char set is GB 2312 only, not Latin-1 with GB 2312 alt 2022-05-19 10:17:51 +01:00
Makefile RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +01:00
manual.pmd RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +01:00
manual.txt RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +01:00
pygments.theme GRIDMATRIX: default char set is GB 2312 only, not Latin-1 with GB 2312 alt 2022-05-19 10:17:51 +01:00
README zint.1.pmd: fix whitesp info, other tweaks; manual.pmd tweak 2022-05-20 09:42:19 +01:00
zint_images.sh GRIDMATRIX: default char set is GB 2312 only, not Latin-1 with GB 2312 alt 2022-05-19 10:17:51 +01:00
zint.1 RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +01:00
zint.1.pmd RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7 2022-06-09 21:52:02 +01:00

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/2.18/pandoc-2.18-1-amd64.deb
    sudo dpkg -i pandoc-2.18-1-amd64.deb
    sudo apt install python3-pip
    pip install pandoc-tablenos --user
    export PATH=~/.local/bin:"$PATH"
    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 36 (Workstation Edition))

    wget https://github.com/jgm/pandoc/releases/download/2.18/pandoc-2.18-linux-amd64.tar.gz
    tar xf pandoc-2.18-linux-amd64.tar.gz
    sudo mv -i pandoc-2.18/bin/pandoc /usr/local/bin
    sudo dnf install python3-pip
    pip install pandoc-tablenos --user
    export PATH=~/.local/bin:"$PATH"
    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

Install https://github.com/jgm/pandoc/releases/download/2.18/pandoc-2.18-windows-x86_64.msi

From command prompt run as administrator

    choco install make
    choco install rsvg-convert
    choco install python
    choco install miktex

    pip install pandoc-tablenos --user

From normal command prompt run from zint "docs" directory

    set "PATH=<location-of-pandoc-tablenos>:%PATH%"
    # e.g. set "PATH=%userprofile%\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\Scripts:%PATH%"

TODO
??? Various font errors Helvetica, TeX Gyre Pagella which miktex can't handle (ok may be non-activated Windows issue) ???
??? pandoc-tablenos filter craps out ???