add info on how to generate docs as a pdf file
@@ -110,6 +110,27 @@ Generating the HTML docs for Gammapy is straight-forward::
make docs-all
make docs-show
+Generating the PDF docs is more complex.
+This should work:
+
+ # build the notebooks
+ python -m gammapy.utils.notebooks_process
+ # build the latex file
+ cd docs
+ python -m sphinx . _build/latex -b latex -j auto
+ # first generation of pdf file
+ cd _build/latex
+ pdflatex -interaction=nonstopmode gammapy.tex
+ # final generation of pdf file
+ pdflatex -interaction=nonstopmode gammapy.tex
+ # clean the git repo
+ git reset --hard
+ # open the pdf file
+ open gammapy.pdf
+
+
+You need a bunch or LaTeX stuff, specifically ``texlive-fonts-extra`` is needed.
+
Jupyter notebooks present in Gammapy documentation have stripped output cells.
All notebooks are code clean formatted, tested, and filled during the process of documentation
building. They are also converted to Sphinx formatted HTML files and ``.py`` scripts.
