From 8f0ba864891c432f07bec2975fc996e18b94e52b Mon Sep 17 00:00:00 2001 From: manchandavishal Date: Wed, 4 Sep 2019 13:21:48 +0000 Subject: [PATCH] PDF documentation build Change-Id: I3c467d47b00173cb3c2604fd04041d42ae9fcdbd --- doc/source/conf.py | 20 +++++++++++--------- tox.ini | 10 ++++++++++ 2 files changed, 21 insertions(+), 9 deletions(-) diff --git a/doc/source/conf.py b/doc/source/conf.py index 9cc72f6..dd691c4 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -177,22 +177,24 @@ html_last_updated_fmt = '%Y-%m-%d %H:%M' # -- Options for LaTeX output ------------------------------------------------- +# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664 +latex_use_xindy = False + +latex_domain_indices = False + 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}', } # 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', + ('index', + 'doc-congress-dashboard.tex', + u'Congress-dashboard Documentation', u'OpenStack Foundation', 'manual'), ] diff --git a/tox.ini b/tox.ini index 7754b19..c59e8d6 100644 --- a/tox.ini +++ b/tox.ini @@ -38,6 +38,16 @@ deps = -r{toxinidir}/doc/requirements.txt 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:releasenotes] basepython = python3 deps = -r{toxinidir}/doc/requirements.txt