The workflow (source files, pandoc filters) for kallipos brings together several submodules and builds the content of the markdown version of the book.
Files are edited at their respective repos and then imported here:
git submodule update --remote --merge
The source files are read from the text folder,
which is a git submodule, ie a link to another repo.
You might need to edit the figure lua filter to point at the current folder .
There is a bash script make_latex.sh which can be modified
in order to prepare the desired output format.
The bash file has been prepared for MacOS X cli.
It has also been tested succesfully in Arch Linux by editing the syntax (or simply removing) the sed command
In order to prepare a PDF with the LaTeX toolchain,
just add a latex folder with a template and master file.
Have a look at indicative latex template and output PDF
It is strongly advised to use the official latex install,
instead of the latex version in your *nix distribution, and install packages as needed with tlmgr
The source files in the text folder are formated with
custom tags for figures, epigraphs, and file inclusion:
- The include filter needs to be called again if there are nested includes.
- The figure filter should be called after everything has been included.
- The custom tags are translated with lua filters to the desired output format (e.g., latex, html, docx), with pandoc.
- Remove filters enable to clear unwanted tags and features.
pandoc --lua-filter=extras.lua text/mi-ch02.md --to markdown | pandoc --lua-filter=extras.lua --to markdown | pandoc --lua-filter=epigraph.lua --to markdown | pandoc --lua-filter=figure.lua --to markdown | less
Some of the include files provide cross-references to figures and to bibliography and should be processed last.
pandoc --filter pandoc-fignos text/mi-ch02.md --to markdown | pandoc --citeproc --bibliography=biblio.bib --to latex | less