16b9486bf7
- 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. - 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: I3aaea1d15a357f550f529beaa84fb1a1a7748358
21 lines
719 B
Plaintext
21 lines
719 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.0.0;python_version=='2.7' # BSD
|
|
sphinx>=1.8.0,!=2.1.0;python_version>='3.4' # BSD
|
|
sphinxcontrib-actdiag>=0.8.5 # BSD
|
|
sphinxcontrib-seqdiag>=0.8.4 # BSD
|
|
sphinxcontrib-svg2pdfconverter>=0.1.0 # BSD
|
|
sphinx-feature-classification>=0.2.0 # Apache-2.0
|
|
os-api-ref>=1.4.0 # Apache-2.0
|
|
openstackdocstheme>=1.30.0 # Apache-2.0
|
|
|
|
# releasenotes
|
|
reno>=2.5.0 # Apache-2.0
|
|
|
|
# redirect tests in docs
|
|
whereto>=0.3.0 # Apache-2.0
|
|
|
|
# needed to generate osprofiler config options
|
|
osprofiler>=1.4.0 # Apache-2.0
|