See the repository here for more information. See releases for examples of PDF, DOCX and HTML. See blog post for more information regarding this. See example for a HTML example.
- Install MikTeX or MacTeX
- Install Pandoc
- Install Pandoc-Citeproc (Optional)
- Install Miniconda
You can install both pandoc and pandoc-citeproc using the conda
package manager.
However, conda
has an older version of pandoc and pandoc-citeproc.
I've tested this with Pandoc 1.19.2.1.
pandoc-citeproc
is only required if you are interested in generating citations using the PDF target.
The TeX target does not use the pandoc-citeproc, and uses biblatex instead.
There are minor differences in how the citations look when Pandoc generates it using pandoc-citeproc versus when it is generated using biblatex.
I tend to use the PDF target when writing the paper and use the TeX target once the final version is required.
Mac
Users can install Pandoc and Pandoc-Citeproc using brew
(recommended).
$ brew install pandoc pandoc-citeproc
$ pandoc --version
pandoc 2.2
Compiled with pandoc-types 1.17.4.2, texmath 0.10.1.2, skylighting 0.7.1
Default user data directory: /Users/$USER/.pandoc
Copyright (C) 2006-2018 John MacFarlane
Web: http://pandoc.org
This is free software; see the source for copying conditions.
There is no warranty, not even for merchantability or fitness
for a particular purpose.
$ pandoc-citeproc --version
pandoc-citeproc 0.14.3.1
Setup the Python environment for pandoc filters (optional but recommended)
Open a terminal
conda create -n python3-pandoc-env python=3 -y
source activate python3-pandoc-env
pip install pandoc-fignos
pip install pandoc-eqnos
pip install pandoc-tablenos
Windows
You need to install Make
to use the Makefile
on Windows.
Git Bash is recommended for using Make
.
Installing Pandoc is straightforward on Windows. You can download the binary from the link above. You can install pandoc-citeproc using conda.
activate python3-pandoc-env
conda install pandoc-citeproc
You can install pandoc using conda as well. This may be an older version of Pandoc though.
activate python3-pandoc-env
conda install pandoc
Setup the Python environment for pandoc filters (optional but recommended)
Open a Command Prompt
conda create -n python3-pandoc-env python=3 -y
activate python3-pandoc-env
pip install pandoc-fignos
pip install pandoc-eqnos
pip install pandoc-tablenos
Make sure that you have MikTeX or MacTeX, and Pandoc installed correctly.
# Mac:
source activate python3-pandoc-env
# Windows:
activate python3-pandoc-env
make pdf
# OR
make tex
- Change
journal: true
toconference: true
for a conference version of the paper. - Add packages to
package:
to add more packages to the tex file.
Please feel free to open issues to report bugs or submit pull requests to add features.