pandoc-thesis

Write your PhD thesis using pandoc (Markdown, LaTeX).

This is a small set of scripts/templates I prepared to start writing my PhD thesis using Markdown through pandoc.

Requirements / Credits

• pandoc
• python with jinja2 installed
• the classicthesis LaTeX package
• Biber (or BibLaTeX)
• a thesis to write :)

How to

1. Write your content in markdown files (.md).
2. Edit the Makefile and run make.
3. ???
4. Profit!

The Makefile contains the following code:

all: thesis_skeleton.latex appendix.tex
    pandoc *.md ref-appendix/references.tex \
	--include-before-body=frontback/dedication.tex \
	--include-before-body=frontback/acknowledgements.tex \
	--include-before-body=frontback/abstract.tex \
	--include-after-body=ref-appendix/appendix.tex \
	--atx-headers \
	--latex-engine=pdflatex --template=thesis_skeleton.latex \
	--bibliography=thesis.bib --csl=acm-sigchi-proceedings-extended-abstract-format.csl \
	-V bibfile='thesis' \
	-V bibtitle='Bibliography' \
	-V documentclass='scrbook' \
	-V fontfamily='libertine' \
	-V author='Eduardo Graells-Garrido' \
	-V year='2015' \
	-V department='DTIC' \
	-V university='Universitat Pompeu Fabra' \
	-V title='Biased Behavior on Web Activities: From Understanding to Unbiased Visual Exploration' \
	-V supervisor='Prof. Dr. Ricardo Baeza-Yates, Universitat Pompeu Fabra \\ Dr. Mounia Lalmas, Yahoo Labs' \
	-V university_logo='img/logo_upf.png' \
	-f markdown -o thesis.pdf

Explanation

As you can see, I have several .tex files in the folders frontback and ref-appendix. The names of those folders are self-describing. They need to be in LaTeX instead of Markdown because pandoc does not process them. The exception is the appendix.tex file: actually, you have an appendix.md file, which is converted previously by pandoc to LaTeX.

All chapters and parts of the thesis should be in .md files. I name them with numbers, like 01_introduction.md, 02_background.md, and thus I'm able to use a wildcard *.md to read the files.

You need to edit the -V attributes in the Makefile to suit your needs.

And that's it! You are done with your thesis. At least with the preparation of the code structure. Now you can worry about the content only :)

Note

Edit the ClassicThesis.tex template according to your needs. In my case, the title page is formatted according to the requirements of my university. You can also edit the template_gen.py script to change some options of the main LaTeX template.