iskendria-pub / iskendria

Blockchain-based system for scientific publishing
BSD 3-Clause "New" or "Revised" License
0 stars 0 forks source link

Generate PDF files with page numbers from Markdown documentation files #23

Open mhdirkse opened 5 years ago

mhdirkse commented 5 years ago

[AX-23] created by mdi

mhdirkse commented 5 years ago

by dirkse

mhdirkse commented 5 years ago

Markdown is a nice format to write documentation as part of a GIT project. This format does not produce nice output on paper however. For reviews on paper, we need PDF files with page numbers.

mhdirkse commented 5 years ago

The transformation is done using pandoc. You can install it on Ubuntu with:

sudo apt-get install pandoc

You also need pdflatex. Do NOT install that with apt-get, but follow the instructions of this page: https://tug.org/texlive/quickinstall.html. This page references another page for downloading LaTeX: https://tug.org/texlive/acquire-netinstall.html.

After these installations, the following command will do the job:

pandoc -t latex -o REQUIREMENTS.pdf REQUIREMENTS.md