Get started
If you are impatient, have a look at this demo and check the PDF Pandemics will automatically produce out of it.
A quick example
To get started with your own document, just write some text in your favorite text editor and save it as a Markdown file (with the extension .md).
-
If you installed Pandemics in Atom, then click on:
Packages > pandemics > publish
-
If you are using NPM, run:
pandemics publish
-
If you have Docker:
docker run -v ${PWD}:/data/ registry.gitlab.com/pandemics/docker \ pandemics publish
VoilĂ ! You now have next to your manuscript a pandemics
folder with a compiled version of your manuscript.
Change the output format
You can export your document to any format supported by Pandoc: .docx, .html, .tex, etc.
By default, Pandemics will export to .pdf format using a template best suited for a long report, eg. a thesis. You can easily override this default by specifying the desired flavor or format in the front-matter of your markdown document.
For a short report in pdf:
---
pandemics:
format: short.pdf
---
For a handout in pdf:
---
pandemics:
format: handout.pdf
---
TIP: you can add a custom logo on the title page of your pdf by setting titlepage-logo
in the YAML header:
---
titlepage-logo: relative-path/logo.png
---
HTML
You can generate a standalone webpage from your document using the html
format. This is ideal for example to publish an online documentation (eg. with Github Pages hosting).
---
pandemics:
format: html
---
TIP: you can add change the highlight color by setting main-color
to the YAML header:
---
main-color: #00786D
---
Microsoft Word
Your document can also be converted to a Word .docx format, for example to submit it for review:
---
pandemics:
format: docx
---
Apply a styling recipe
If you want to change the look of your compiled document, you will need a recipe
. Need to prepare a manuscript for a new journal with different formatting guidelines or citations styles? Just select another recipe! In practice, a recipe is a repository which contains a template and instructions to compile your document with a specific style. In order to apply a styling recipe to your document, simply provide the url to the recipe repository in the front-matter of your manuscript:
---
pandemics:
recipe: https://gitlab.com/pandemics/recipe-default-html
---
Have a look at our selection of recipes for more examples.
In general, a recipe will automatically decide the output format. If multiple formats are offered, you will need to also specify the desired format.
Also, you can compile your document with an older version of a given recipe simply by writing the desired version tag or commit SHA after the recipe url.
---
pandemics:
recipe: https://github.com/Wandmalfarbe/pandoc-latex-template 8f8fc7312f80c38ec6a3d7cc1f1e57a75be3ff4b
---
Going further
Check the writing section to discover all the features of Pandemics, like bibliographic references, figures, tables, an dynamical results integration.
If you want, you can also create your own recipe to create documents that perfectly fit your expectations.