31d23b7315
- Add a new pdf-docs environment to enable PDF build. - sphinxcontrib-svg2pdfconverter is used to handle SVG properly. - maxlistdepth=10 in latex_elements is needed to handle deeper levels of nesting. - Specify openany in extraclassoptions to skip blank pages (oneside is also specified to use the same page layout for even and odd pages) - tocdepth is set to 2 for better PDF TOC - printindex and makeindex are set to empty in latex_elements to avoid an empty "Index" section in PDF - Sample config/policy files are skipped in the PDF document as inline sample files cause LaTeX error [1] and direct links in PDF doc is discouraged. Note that sample-config and sample-policy need to be excluded to avoid the LaTeX error [1] and :orphan: is specified in those files. [1] https://github.com/sphinx-doc/sphinx/issues/3099 Change-Id: I70100a71114e1d75833e6c783086325baa0e3fd2 |
||
---|---|---|
.. | ||
config-options.rst | ||
index.rst | ||
sample_config.rst | ||
sample_policy.rst |