PDF documentation build

Change-Id: I2cb103dd97fcb4db8238fb44a0e2985edcbd6146
Implements: blueprint pdfdocs
This commit is contained in:
Hongbin Lu 2019-12-08 04:42:13 +00:00
parent 89e70cd263
commit 1b2684e63e
2 changed files with 20 additions and 11 deletions

View File

@ -214,22 +214,18 @@ htmlhelp_basename = 'Horizondoc'
# -- Options for LaTeX output -------------------------------------------------
latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
# 'papersize': 'letterpaper',
# The font size ('10pt', '11pt' or '12pt').
# 'pointsize': '10pt',
# Additional stuff for the LaTeX preamble.
# 'preamble': '',
'makeindex': '',
'printindex': '',
'preamble': r'\setcounter{tocdepth}{3}',
'extraclassoptions': 'openany',
}
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass
# [howto/manual]).
latex_documents = [
('index', 'Horizon.tex', u'Horizon Documentation',
u'OpenStack Foundation', 'manual'),
('index', 'doc-zun-ui.tex', u'Zun UI Documentation',
u'Zun development team', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
@ -250,7 +246,10 @@ latex_documents = [
# latex_appendices = []
# If false, no module index is generated.
# latex_domain_indices = True
latex_domain_indices = False
# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664
latex_use_xindy = False
# -- Options for manual page output -------------------------------------------

10
tox.ini
View File

@ -90,6 +90,16 @@ deps =
commands=
sphinx-build -W -b html doc/source doc/build/html
[testenv:pdf-docs]
basepython = python3
envdir = {toxworkdir}/docs
deps = {[testenv:docs]deps}
whitelist_externals =
make
commands =
sphinx-build -W -b latex doc/source doc/build/pdf
make -C doc/build/pdf
[testenv:docs-local]
basepython = python3
deps =