zint/docs
gitlost 607e4ed33a EAN/UPC: add quiet zone indicators option (API output_options
`EANUPC_GUARD_WHITESPACE`, CLI `--guardwhitespace`) (ticket #287)
EAN-2/EAN-5: HRT now at top instead of at bottom for standalones,
  following BWIPP
CLI: batch mode: don't close input if stdin
EAN/UPC: fix excess 1X to right of add-ons
Composites: fix excess whitespace; fix quiet zone calcs to allow
  for linear shifting
CLI: use own (Wine) version of `CommandLineToArgvW()` to avoid
  loading "shell32.dll"
Move "font.h" -> "raster_font.h"
EPS/SVG: use new `out_putsf()` func to output floats, avoiding
  trailing zeroes & locale dependency
EPS: simplify "TR" formula
SVG: change font from "Helvetica, sans serif" to "OCR-B, monospace";
  use single "<path>" instead of multiple "<rect>"s to draw boxes
  (reduces file size)
Add `EMBED_VECTOR_FONT` to `output_options` (CLI `--embedfont`) to
  enable embedding of font in vector output - currently only for
  SVG output of EAN/UPC
GUI: use "OCR-B" font for EAN/UPC and "Arimo" for all others (was
  "Helvetica" for both); paint background of screen preview light
  grey so as contrasts with whitespace and quiet zones
EMF: prefix funcs with `emf_`; simplify string `halign` handling
large: rename `large_int` -> `large_uint`
CODE128/common: move `c128_hrt_cpy_iso8859_1()` to
  `hrt_cpy_iso8859_1()` and add `ZINT_WARN_HRT_TRUNCATED` warning
  (for future use)
Various symbologies: replace `printf()` with `fputs()`
  (symbol->debug)
QRCODE: better assert(), removing a NOLINT (2 left)
CLI: add some more barcode synonyms for DBAR
common: various fiddlings
CMake: don't include png.c unless ZINT_USE_PNG (avoids clang
  warning)
2023-06-12 01:25:55 +01:00
..
images EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +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 Update URL for manual (no longer ASPX) 2022-08-23 10:53:56 +01:00
Makefile - Add new symbology BARCODE_UPU_S10 2022-12-09 14:51:26 +00:00
manual.pmd EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +01:00
manual.txt EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +01:00
README - DOTCODE, QRCODE, RMQR: return warning if ECI or Structured Append used in 2022-09-28 21:58:57 +01:00
zint_images.sh EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +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 EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +01:00
zint.1.pmd EAN/UPC: add quiet zone indicators option (API output_options 2023-06-12 01:25:55 +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.19.2/pandoc-2.19.2-1-amd64.deb
    sudo dpkg -i pandoc-2.19.2-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.19.2/pandoc-2.19.2-linux-amd64.tar.gz
    tar xf pandoc-2.19.2-linux-amd64.tar.gz
    sudo mv -i pandoc-2.19.2/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 ???