doc: add ability to generate PDF

This adds new targets to generate build documentation through
LaTEX to PDF.

There are a few notes:

1. pdflatex complains about the tex file generated by doxygen
   so it needs to be fixed with a Python script before feeding
   in through pdflatex.

2. SVG files are not recognized by pdflatex so they are converted
   to known good format on the fly, only for producing PDF. This
   uses the libRSVG's rsvg-convert tool.

Relates to #6782.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>
This commit is contained in:
Daniel Leung 2018-08-23 11:11:11 -07:00 committed by Anas Nashif
commit 9945e7fda0
7 changed files with 161 additions and 12 deletions

View file

@ -39,8 +39,10 @@ Source code for the Zephyr Project is maintained in the Zephyr Project's
.. _GitHub repo: https://github.com/zephyrproject-rtos/zephyr
Sections
********
.. only:: html
Sections
********
.. toctree::
:maxdepth: 1
@ -55,8 +57,10 @@ Sections
devices/index.rst
subsystems/subsystems.rst
Indices and Tables
******************
.. only:: html
Indices and Tables
******************
* :ref:`glossary`