~mrshll1001/phd-thesis

My old PhD thesis
178be702 — Matt Marshall 1 year, 2 months ago
Integrated viva noted for archival
Ressurected the markdown revision report and ported over last minute change from submitted version of appendices
Final edits and submitted revised version

refs

main
browse  log 

clone

read-only
https://git.sr.ht/~mrshll1001/phd-thesis
read/write
git@git.sr.ht:~mrshll1001/phd-thesis

You can also use your local clone with git send-email.

#Thesis

My PhD Thesis. The script used to generate the final versions is over at mrshll100/markdown-thesis

#For readers

Source is in markdown, run build.py to build for various formats. You can build by either entire thesis + format or chapter + format. It's basically a wrapper for a complex pandoc command and will therefore accept all formats pandoc can convert to from markdown. PDF rendering is done via HTML5 as LaTeX doesn't like SVG files naturally.

e.g. ./build.py chapter 1 html produces a HTML rendering of Chapter 1, ./build.py chapter 6 odt will give you an OpenDocument file of Chapter 6.

There are two special options:

  • build.py chapters $FORMAT generates every chapter individually in the given format.
  • build.py website generates a website with coversheet. Used for thesis.mrshll.uk

Scripts will build into an out directory and then a subdirectory for their specific format e.g. out/html or out/odt. /out is ignored by git, so you need to run a build script to acquire the desired format.

/templates currently contains the coversheet template used by the website command but may in future contain custom LaTeX templates for nice PDF rendering. Pandoc is run with the --self-contained flag to pull in any resources to the output file.

#For me writing it

  • Make sure to grab a copy of BetterBibTeX for Zotero to handle generating nicer citation keys.
  • BetterBibTeX is great, but its default citation key format has changed three times since beginning this thesis so you'll need to fiddle with it.
  • Preferences -> BetterBibTeX and then change citation key format to [auth:lower][shorttitle3_3][year]