2022-05-19 05:17:51 -04:00
|
|
|
# Makefile for generating "manual.txt" and "manual.pdf" from "manual.pmd" using pandoc
|
|
|
|
|
# Copyright (C) 2022 <rstuart114@gmail.com>
|
|
|
|
|
#
|
|
|
|
|
# Requires a recent version of pandoc, plus pandoc-tablenos, xelatex and various other packages - see "README"
|
|
|
|
|
# .svg images generated by "zint_images.sh"
|
|
|
|
|
|
|
|
|
|
SOURCE = manual.pmd
|
|
|
|
|
OUT_PDF = manual.pdf
|
|
|
|
|
OUT_TXT = manual.txt
|
|
|
|
|
INC_HEADER_PDF = inc_header_pdf.tex
|
|
|
|
|
INC_BEFORE_BODY_PDF = inc_before_body_pdf.tex
|
|
|
|
|
INCLUDES_PDF = $(INC_HEADER_PDF) $(INC_BEFORE_BODY_PDF)
|
|
|
|
|
INC_PDF = --include-in-header $(INC_HEADER_PDF) --include-before-body $(INC_BEFORE_BODY_PDF)
|
|
|
|
|
INCLUDES_TXT = inc_header_txt.tex
|
|
|
|
|
INC_TXT = --include-in-header $(INCLUDES_TXT)
|
2022-05-22 16:33:45 -04:00
|
|
|
SOURCE_MAN_PAGE = zint.1.pmd
|
|
|
|
|
OUT_MAN_PAGE = zint.1
|
2022-05-19 05:17:51 -04:00
|
|
|
IMAGES = \
|
|
|
|
|
images/zint.png \
|
|
|
|
|
images/zint-qt.png \
|
|
|
|
|
images/gui_main.png \
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-02 16:39:01 -05:00
|
|
|
images/gui_delete.png \
|
|
|
|
|
images/gui_zap.png \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/gui_menus.png \
|
|
|
|
|
images/gui_composite.png \
|
|
|
|
|
images/gui_segs.png \
|
|
|
|
|
images/gui_aztec.png \
|
|
|
|
|
images/gui_appearance.png \
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-02 16:39:01 -05:00
|
|
|
images/gui_scaling.png \
|
|
|
|
|
images/gui_set_printing_scale.png \
|
|
|
|
|
images/gui_black_eye.png \
|
|
|
|
|
images/gui_white_eye.png \
|
|
|
|
|
images/gui_swap.png \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/gui_colour.png \
|
|
|
|
|
images/gui_data_dialog.png \
|
|
|
|
|
images/gui_sequence.png \
|
|
|
|
|
images/gui_export.png \
|
|
|
|
|
images/gui_cli_equivalent.png \
|
|
|
|
|
images/pdf417_heightperrow.svg \
|
|
|
|
|
images/code128_box.svg \
|
|
|
|
|
images/qrcode_box.svg \
|
|
|
|
|
images/code128_green.svg \
|
|
|
|
|
images/code128_green_alpha.svg \
|
|
|
|
|
images/code128_rotate90.svg \
|
|
|
|
|
images/datamatrix_euro.svg \
|
|
|
|
|
images/datamatrix_big5.svg \
|
|
|
|
|
images/qrcode_binary_utf8.svg \
|
|
|
|
|
images/codeone_s_dotty.svg \
|
|
|
|
|
images/aztec_segs.svg \
|
|
|
|
|
images/datamatrix_structapp.svg \
|
|
|
|
|
images/code128_small_bold.svg \
|
|
|
|
|
images/code11.svg \
|
|
|
|
|
images/c25standard.svg \
|
|
|
|
|
images/c25iata.svg \
|
|
|
|
|
images/c25ind.svg \
|
|
|
|
|
images/c25inter.svg \
|
|
|
|
|
images/c25logic.svg \
|
|
|
|
|
images/itf14.svg \
|
|
|
|
|
images/itf14_border0.svg \
|
|
|
|
|
images/dpleit.svg \
|
|
|
|
|
images/dpident.svg \
|
|
|
|
|
images/upca.svg \
|
|
|
|
|
images/upca_5.svg \
|
|
|
|
|
images/upce.svg \
|
|
|
|
|
images/eanx13.svg \
|
|
|
|
|
images/eanx5.svg \
|
|
|
|
|
images/eanx8_5.svg \
|
|
|
|
|
images/isbnx.svg \
|
|
|
|
|
images/plessey.svg \
|
|
|
|
|
images/msi_plessey.svg \
|
|
|
|
|
images/telepen.svg \
|
|
|
|
|
images/telepen_num.svg \
|
|
|
|
|
images/code39.svg \
|
|
|
|
|
images/excode39.svg \
|
|
|
|
|
images/code93.svg \
|
|
|
|
|
images/pzn.svg \
|
|
|
|
|
images/logmars.svg \
|
|
|
|
|
images/code32.svg \
|
|
|
|
|
images/hibc_39.svg \
|
|
|
|
|
images/vin.svg \
|
|
|
|
|
images/codabar.svg \
|
|
|
|
|
images/pharma.svg \
|
|
|
|
|
images/code128.svg \
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-02 16:39:01 -05:00
|
|
|
images/code128ab.svg \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/gs1_128.svg \
|
|
|
|
|
images/ean14.svg \
|
|
|
|
|
images/nve18.svg \
|
|
|
|
|
images/hibc_128.svg \
|
|
|
|
|
images/dpd.svg \
|
|
|
|
|
images/dbar_omn.svg \
|
|
|
|
|
images/dbar_truncated.svg \
|
|
|
|
|
images/dbar_ltd.svg \
|
|
|
|
|
images/dbar_exp.svg \
|
|
|
|
|
images/koreapost.svg \
|
|
|
|
|
images/channel.svg \
|
2022-07-21 07:29:53 -04:00
|
|
|
images/bc412.svg \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/code128_stacked.svg \
|
|
|
|
|
images/code128_stacked_sep2.svg \
|
|
|
|
|
images/codablockf.svg \
|
|
|
|
|
images/code16k.svg \
|
|
|
|
|
images/pdf417.svg \
|
|
|
|
|
images/pdf417comp.svg \
|
|
|
|
|
images/micropdf417.svg \
|
|
|
|
|
images/dbar_stk.svg \
|
|
|
|
|
images/dbar_omnstk.svg \
|
|
|
|
|
images/dbar_expstk.svg \
|
|
|
|
|
images/code49.svg \
|
|
|
|
|
images/eanx_cc_a.svg \
|
|
|
|
|
images/eanx_cc_b.svg \
|
|
|
|
|
images/gs1_128_cc_c.svg \
|
|
|
|
|
images/pharma_two.svg \
|
|
|
|
|
images/postnet.svg \
|
|
|
|
|
images/planet.svg \
|
|
|
|
|
images/auspost.svg \
|
|
|
|
|
images/ausroute.svg \
|
|
|
|
|
images/ausreply.svg \
|
|
|
|
|
images/ausredirect.svg \
|
|
|
|
|
images/kix.svg \
|
|
|
|
|
images/rm4scc.svg \
|
2022-12-08 08:48:31 -05:00
|
|
|
images/mailmark_4s.svg \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/usps_imail.svg \
|
|
|
|
|
images/japanpost.svg \
|
|
|
|
|
images/hibc_dm.svg \
|
2022-12-08 08:48:31 -05:00
|
|
|
images/mailmark_2d.svg \
|
2022-05-19 05:17:51 -04:00
|
|
|
images/qrcode.svg \
|
|
|
|
|
images/microqr.svg \
|
|
|
|
|
images/rmqr.svg \
|
|
|
|
|
images/upnqr.svg \
|
|
|
|
|
images/maxicode.svg \
|
|
|
|
|
images/aztec.svg \
|
|
|
|
|
images/azrune.svg \
|
|
|
|
|
images/codeone.svg \
|
|
|
|
|
images/gridmatrix.svg \
|
|
|
|
|
images/dotcode.svg \
|
|
|
|
|
images/hanxin.svg \
|
|
|
|
|
images/ultra.svg \
|
|
|
|
|
images/fim.svg \
|
|
|
|
|
images/flat.svg \
|
|
|
|
|
images/daft_rm4scc.svg
|
|
|
|
|
MAIN_FONT = mainfont="TeX Gyre Pagella"
|
|
|
|
|
MONO_FONT = monofont="Liberation Mono"
|
|
|
|
|
CJK_FONT = CJKmainfont="WenQuanYi Micro Hei Mono"
|
2022-05-22 16:33:45 -04:00
|
|
|
PDF_OPTS = --pdf-engine=xelatex --filter pandoc-tablenos -M tablenos-warning-level=0 \
|
2022-07-19 12:11:33 -04:00
|
|
|
--highlight-style=haddock -V colorlinks -V geometry:margin=20mm -V papersize=a4 -V csquotes=true --dpi=300
|
2022-05-22 16:33:45 -04:00
|
|
|
TEX_MAN_PAGE = zint.1.tex
|
2022-05-23 19:21:44 -04:00
|
|
|
TXT_OPTS = --filter pandoc-tablenos -M tablenos-warning-level=0 --columns 80 --eol=lf -t plain
|
2022-05-22 16:33:45 -04:00
|
|
|
MAN_PAGE_OPTS = -s -t man
|
2022-05-19 05:17:51 -04:00
|
|
|
|
2022-05-22 16:33:45 -04:00
|
|
|
all : $(OUT_PDF) $(OUT_TXT) $(OUT_MAN_PAGE)
|
2022-05-19 05:17:51 -04:00
|
|
|
|
2022-05-22 16:33:45 -04:00
|
|
|
$(OUT_PDF) : $(SOURCE) $(SOURCE_MAN_PAGE) $(HIGHLIGHT_THEME) $(INC_HEADER_PDF) $(INC_BEFORE_BODY_PDF) $(IMAGES) Makefile
|
|
|
|
|
pandoc $(SOURCE_MAN_PAGE) -f markdown \
|
|
|
|
|
$(PDF_OPTS) \
|
|
|
|
|
-o $(TEX_MAN_PAGE)
|
|
|
|
|
sed -i -e 's/section{/subsection{/' $(TEX_MAN_PAGE) # Convert man page sections to subsections
|
2022-05-19 05:17:51 -04:00
|
|
|
pandoc $(SOURCE) -f markdown $(INC_PDF) --toc --toc-depth=4 \
|
2022-05-22 16:33:45 -04:00
|
|
|
-V $(MAIN_FONT) -V $(MONO_FONT) -V $(CJK_FONT) -V block-headings \
|
2022-05-19 05:17:51 -04:00
|
|
|
$(PDF_OPTS) \
|
2022-05-22 16:33:45 -04:00
|
|
|
--include-after-body $(TEX_MAN_PAGE) \
|
2022-05-19 05:17:51 -04:00
|
|
|
-o $(OUT_PDF)
|
|
|
|
|
|
2022-05-22 16:33:45 -04:00
|
|
|
$(OUT_TXT) : $(SOURCE) $(SOURCE_MAN_PAGE) $(INCLUDES_TXT) Makefile
|
|
|
|
|
pandoc $(SOURCE) $(SOURCE_MAN_PAGE) -f markdown $(INC_TXT) --toc --toc-depth=4 \
|
2022-05-19 05:17:51 -04:00
|
|
|
-V $(MAIN_FONT) -V $(MONO_FONT) -V $(CJK_FONT) \
|
|
|
|
|
$(TXT_OPTS) \
|
|
|
|
|
-o $(OUT_TXT)
|
2022-05-22 16:33:45 -04:00
|
|
|
# Indent Man Page sections in TOC and remove trailing spaces
|
|
|
|
|
sed -i \
|
|
|
|
|
-e 's/^\(- [A-Z][A-Z ]*\)$$/ \1/' \
|
|
|
|
|
-e 's/ *$$//' \
|
|
|
|
|
$(OUT_TXT)
|
|
|
|
|
|
|
|
|
|
$(OUT_MAN_PAGE) : $(SOURCE_MAN_PAGE) Makefile
|
|
|
|
|
pandoc $(SOURCE_MAN_PAGE) -f markdown \
|
|
|
|
|
$(MAN_PAGE_OPTS) \
|
|
|
|
|
-o $(OUT_MAN_PAGE)
|