5.1.3.4. pdf

The pdf is provided by the builders latexpdf and latexpdfja which are based on latex.

Figure: Theme ‘pdf’

configuration

The current example implementation contains the files within the default path:

setupddocx/configurations/sphinx/pdf

file	remark
docsrc/conf.py	adds configuration variables
docsrc/conf.tex	adds configuration to the latex builder
docsrc/_static/custom.css	sets some custom colors and sizes
docsrc/_static/favicon.ico	provides a demo favicon, requires ICO
docsrc/_static/logo.png	provides a demo logo, requires PNG

call

The call creates a PDF document within the local directory doc

python setup.py  -q  \
   build_docx  \
      --conf-dir setupdocx/configurations/pdf/ \
      --docname setupdocx-pdf \
   install_docx \
      --dist-dir doc \
      --docname=setupdocx-pdf

# cut-and-paste for execution
# for readability split acros multiple lines