Pandoc Configuration and Support Files

Description

A collection of support files for use with Pandoc, and specifically for helping to turn pandoc markdown files into nice HTML, LaTeX, and PDF output. These files go in your

~/.pandoc/

PDF	HTML	Word

Notes

What's included?

• Some Pandoc templates for an article in PDF (vita LaTeX), HTML, or Microsoft Word. These go in

  ~/.pandoc/templates

  . These can be be pointed to directly with the

  --template=

  switch as appropriate. The

  latex.template

  and

  xelatex.template

  depend on the style files in latex-custom-kjh. The Word reference documents depend on you having Myriad Pro and Minion Pro installed.
• In R, knitr's

  knit()

  function will turn

  .Rmd

  files into

  .md

  files. The configuration file in the

  knitr/

  folder is an example to help you produce HTML or

  .tex

  using knitr's

  pandoc()

  helper function.
• The CSL files in the

  csl/

  folder format the bibliography generated by pandoc and citeproc. (For simplicity we avoid dealing with biblatex directly at all.) The

  chicago-syllabus.csl

  file makes a tiny change to a standard Chicago Notes CSL file so you can use it to output citation information in the body text of a document. This makes it useful for lists of references in CVs and course syllabuses. The other two files are APSA and AJPS standard files from the main CSL styles repository.
• The Makefile in the

  makefile/

  folder helps you generate HTML, LaTeX, and PDF output from your markdown files in a convenient way. It is meant to go in the folder where you are writing your paper. It looks for

  .md

  files in the working directory and converts them to nice HTML, PDF, and LaTeX files using the templates provided here, the style files in latex-custom-kjh, and the bibliography files in socbibs. You can of course change the bibliography and template files as desired.
• The

  pandoc

  commands produced by the current version of the

  Makefile

  include switches that invoke two pandoc filters that do additional processing on the bibliography and cross-references in the document. You should install pandoc-crossref and pandoc-citeproc-preamble to make these work.
• The md-article-starter repository is a basic project folder you can clone that gives you a template for an article written in Markdown and a

  Makefile

  to produce

  .html

  ,

  .tex

  or

  .pdf

  output from it. For R users there is an rmd-article-starter as well, which begins with an

  .Rmd

  file.

Contact

Kieran Healy,

@kjhealy