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

To use other TrueType fonts, place them in the DECKFONTS directory and specify using the command options:

cp FancyFont.ttf $DECKFONTS
pdfdeck -sans FancyFont foo.xml

Alternatively you can obtain fonts from the gofpdf package. To use the standard fonts (assuming the DECKFONTS variable has been set, and gofpdf is in GOPATH):

cp $GOPATH/src/github.com/jung-kurt/gofpdf/font/*.json $DECKFONTS
cp $GOPATH/src/github.com/jung-kurt/gofpdf/font/*.ttf $DECKFONTS

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