From 5e3f2736fea67a96316315ad0ed2d2730fb47432 Mon Sep 17 00:00:00 2001 From: Pierre Riteau Date: Fri, 27 Sep 2019 15:50:11 +0200 Subject: [PATCH] Generate PDF documentation Change-Id: I82069d3b92350bf51def36822094aeeae8a5ee73 Story: 2006073 Task: 34799 --- doc/source/conf.py | 7 ++++++- tox.ini | 7 +++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/doc/source/conf.py b/doc/source/conf.py index 443cf47..acefcd5 100755 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -67,15 +67,20 @@ html_theme = 'openstackdocs' # Output file base name for HTML help builder. htmlhelp_basename = '%sdoc' % project +# -- Options for LaTeX output ------------------------------------------------ + # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass # [howto/manual]). latex_documents = [ ('index', - '%s.tex' % project, + 'doc-%s.tex' % project, u'%s Documentation' % project, u'OpenStack Developers', 'manual'), ] +# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664 +latex_use_xindy = False + # Example configuration for intersphinx: refer to the Python standard library. #intersphinx_mapping = {'http://docs.python.org/': None} diff --git a/tox.ini b/tox.ini index 15fd7de..bc754d8 100644 --- a/tox.ini +++ b/tox.ini @@ -38,6 +38,13 @@ commands = basepython = python3 commands = python setup.py build_sphinx +[testenv:pdf-docs] +basepython = python3 +whitelist_externals = make +commands = + sphinx-build -b latex doc/source doc/build/pdf + make -C doc/build/pdf + [testenv:releasenotes] basepython = python3 commands =