A simple Makefile pipeline to convert Markdown files into
IEEE-conference-article formatted PDFs using pandoc, Latex and BibTex.
Copy this repo as a Github template, or download/clone all the files to your project.
This pipeline entirely relies on pandoc, so you
need to install it. Also make sure to
install the recommended Tex distribution and fonts for your system as described
on the pandoc installation page.
You should now see the version of pandoc, you have. This pipeline was tested
with the following version on macOS 10.15 with macOS's GNU Make 3.81.
$ pandoc -v
pandoc 2.11.3.2curlneeded to download files.makeof course, as described.prettierformats and wraps your Markdown, optional.
To compile the paper.pdf file from the paper.md, just run:
makeThis will download some needed template files (only the first ever time), count the words in the Markdown file and compile a PDF using pandoc and Latex.
Pandoc comes with full support of Latex-like citations. Add all the works you
need to cite in bib.bib in BibTex format. Cite works with tags like this
[@tag, page 23]. For more information check out
pandoc-citeproc.
You can have as many PDFs as you want and rename/remove the paper.pdf. To do
that, just change the following line in the Makefile:
PDFS = paper.pdfProbably to something like:
PDFS = chapter1.pdf chapter2.pdfThe metadata like author, title, etc. can be set in the layout.yml file.
This project is merely a combination/puzzle of some already existing projects, tools and scripts:
-
The main inspiration and much most of the Makefile & template code comes from ieee-pandoc-template by @stsewd.
-
The IEEE class is directly loaded from ctan.org.
-
The IEEE citation style comes from the Citation Style Language project.
-
The word count script is from pandocs' documentation.