A simple pandoc setup to compile a book from markdown sources into html pages and pdf based on pandoc and python filters.
Features:
- Tufte-inspired layout with sidenotes
- Latex formulas via katex plugin
- Environments
- HTML and PDF output
Check out fairmlbook.org for a real example.
- Insall pandoc v2.2 or higher and pandoc-citeproc
- Make sure you have python 2.7 installed with pandocfilters package
- Clone the repository
- Customize your book by setting up variables in
Makefile
. - Type
make
to build both pdf and html files.
- To build html only, type
make html
. - To build pdf only, type
make pdf
.
Find the compiled results in publish/
directory.
pandoc
v2.2 or higherpython
2.7 withpandocfilters
installed
The workflow was developed and tested with:
- pandoc v2.2, python 2.7, Ubuntu 18.04 LTS
assets
-- Put all files linked to from the sources herecss
-- All css filesfilters
-- Pandoc filterssources
-- This is where the source files live. Go here to edit.templates
-- Pandoc template filespublish
-- Contains compiled pages and pdfs ready for publishing. DO NOT EDIT.
The setup is based on:
See Issues
tab for current issues and ways of contributing to the project.
Thank you.