mirrors/zint
2
0
Fork 0
mirror of https://github.com/zint/zint synced 2024-11-16 20:57:25 +13:00
Code Issues Actions Packages Projects Releases Wiki Activity
8a31508163
zint/docs
History
gitlost 8a31508163 zint.1.pmd: fix tab.
2022-05-24 22:12:57 +01:00
..
images GRIDMATRIX: default char set is GB 2312 only, not Latin-1 with GB 2312 alt 2022-05-19 10:17:51 +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 manual.txt: use tablenos filter also; fix tools/update-version.php 2022-05-24 00:21:44 +01:00
manual.pmd Bump version to 2.11.0.9 (dev) 2022-05-24 21:52:02 +01:00
manual.txt zint.1.pmd: fix guarddescent arg (may be float) (sigh). 2022-05-24 21:54:44 +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 zint.1.pmd: fix guarddescent arg (may be float) (sigh). 2022-05-24 21:54:44 +01:00
zint.1.pmd zint.1.pmd: fix tab. 2022-05-24 22:12:57 +01:00

README 

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 ???