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
13 lines
494 B
Plaintext
13 lines
494 B
Plaintext
# The order of packages is significant, because pip processes them in the order
|
|
# of appearance. Changing the order has an impact on the overall integration
|
|
# process, which may cause wedges in the gate later.
|
|
|
|
sphinx>=1.8.0,!=2.1.0 # BSD
|
|
sphinxcontrib-httpdomain>=1.3.0 # BSD
|
|
sphinxcontrib-pecanwsme>=0.2 # Apache-2.0
|
|
sphinxcontrib-seqdiag>=0.8.4 # BSD
|
|
sphinxcontrib-svg2pdfconverter>=0.1.0 # BSD
|
|
reno>=2.5.0 # Apache-2.0
|
|
os-api-ref>=1.4.0 # Apache-2.0
|
|
openstackdocstheme>=1.20.0 # Apache-2.0
|