These are the quarterly reports for the U.S. CMS Operations Program.
To create the pdf output just run make in the quarterly sub-trees.
You will need to have pandoc and latex installed.
To get pandoc on the mac, the easiest is to use homebrew to install it. This is really trivial, there's a one-liner on the homebrew web page to get homebrew up and running, then you are ready to install packages like pandoc:
brew install pandoc
that's it!
To get the full Latex installation for the mac go to MacTEX.
I'm currently using the font family Minion Pro, which can be easily installed in the mac system (it e.g. comes with the Adobe Reader App for free). If you don't have it and don't want to install it, just choose another font in the template.tex file.
Markdown syntax is trivial, see intro here, which has everything you'll likely ever need (or the much more extensive documentation in the pandoc users guide). It also makes figures and tables really easy:
I'm using the markdown pandoc simple_tables, like this:
Date Milestone
-------------- -----------------------------------------------
Feb 2016 Firmware version 1.0 released
Mar 2016 Even better firmware 1.1 released
Table: Major milestones achieved this quarter
Figures can be inserted like this:
and referred to like ...see Figure \ref{fig:no1}..., as in Latex.
I'm now using a "better" way to deal with Figure and Table references instead of the raw Latex \ref and \label, that also works with other output formats like html, using a syntax like ...see Figure {@fig:id}... and
{#fig:id}
This requires the pandoc filter pandoc-fignos. It's trivial to install once you have python pip -- which MacOS doesn't as a default. The safest option is to install your own python, easiest using homebrew, which comes with pip:
brew install python
Then it's trivial to install pandoc-fignos:
pip install pandoc-fignos
Now you can use pandoc-fignos in pandoc by adding --filter pandoc-fignos.