kallipos version of pibook

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:

After cloning this repo run: git submodule update --init --recursive

After editing a file in a submodule run: 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

Source files preprocessing

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.
• The pandoc-fignos filter has not been updated yet to work with pandoc 3, but it does work with previous versions.

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