For contributions please edit the .tex file. The .md files are generated from it.
To rebuild the .pdf from the command line, run latexmk -xelatex HaxeDoc.tex
.
A recent version of TeX Live should provide latexmk and all needed packages
and their dependencies:
- xelatex
- cleveref
- courier
- framed
- fullpage
- geometry
- graphicx
- hyperref
- listings
- palatino
- tikz, tkz-euclide, tkz-qtree
- todonotes
- underscore
- xcolor
You can use the following defines when using convert
for additional features.
-D compileEnv
Generates images from custom LaTeX environments too complex for Markdown (specifically theflowchart
environment at the time of writing). Skips already existing images.-D recompileEnv
Generates images even if they already exist at their destination (most useful forconvert
development).-D keepEnvPDF
Keeps the LaTeX generated PDF files. They're placed next to generated images with the same name.-D keepEnvTemp
Keeps the generated temporary directory for LaTeX compilation. Useful for debugging / development purposes.
At the time of writing, compileEnv
depends on the following.
xelatex
being in path. TeX Live 2013 version should be sufficient. Used to compile custom LaTeX environment snippets to PDF.mudraw
being in path. This is a part of MuPDF. Used for rendering PDF to a PNG image.pandoc
being in path. Used for generating .epub file.ebook-convert
being in path. This is a part of calibre. Used for converting .epub to .mobi.- Source Sans Pro and Source Code Pro fonts being installed.