pdfdeck: render deck files to pdf

pdfdeck makes pdf files from deck markup.

command options:

pdfdeck [options] file...

Options     Default                                            Description
..................................................................................................
-sans       helvetica                                          Sans Serif font
-serif      times                                              Serif font
-mono       courier                                            Monospace font
-symbol     zapfdingbats                                       Symbol font

-layers     image:rect:ellipse:curve:arc:line:poly:text:list   Drawing order
-grid       0                                                  Draw a grid at specified %
-pages      1-1000000                                          Pages to output (first-last)
-pagesize   Letter                                             Page size (w,h) or Letter, Legal,
                                                               Tabloid, A[3-5], ArchA, 4R, Index)

-fontdir    $HOME/deckfonts                                    Font directory
-outdir     Current directory                                  Output directory
-stdout     false                                              Output to standard output
-sw         false                                              Use strict text wrapping
-author     ""                                                 Document author
-title      ""                                                 Document title
....................................................................................................

Fonts

pdfdeck assumes a set of standard fonts (Times, Helvetica, Courier, and Zapf Dingbats) are available. These fonts and other TrueType fonts (Noto, Fira, Charter, Go fonts, etc) are available in the deckfonts repository. pdfdeck also uses the DECKFONTS environment variable to indicate where fonts are stored (by default deckfonts directory in the home directory:

export DECKFONTS=$HOME/deckfonts
cd $HOME
git clone https://github.com/ajstarks/deckfonts
...
pdfdeck foo.xml # (use helvetica as the default)
pdfdeck -sans NotoSans-Regular -serif NotoSerif-Regular -mono NotoMono-Regular foo.xml

Example uses

pdfdeck foo.xml                                # read deck markup in foo.xml, make foo.pdf
pdfdeck -sans Go-Regular -mono Go-Mono foo.xml # use Go fonts
pdfdeck -fontdir /path/to/fonts foo.xml        # use an alternative font directory
pdfdeck -pages 10-12 foo.xml                   # only render pages 10, 11, and 12
pdfdeck -pagesize A4 foo.xml                   # use A4 page size

You can also read from a pipeline (for example output from the decksh command)

decksh foo.dsh | pdfdeck -stdout - > f.pdf     # get data from another command, write to stdout