From f27e6467e7c5cc0b072c59896c9efc281888e6f3 Mon Sep 17 00:00:00 2001 From: Vishakha Agarwal Date: Fri, 30 Aug 2019 10:37:06 +0530 Subject: Generate pdf documentation This patch adds a new tox job/command for building the pdf version of documentation. tox -epdf-docs Change-Id: I0c0ef99190ea2a834bfdb47eb443b88a93bc802c --- doc/source/conf.py | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/source/conf.py b/doc/source/conf.py index c5b98f9..8fb3dba 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -180,10 +180,9 @@ htmlhelp_basename = 'python-keystoneclientdoc' # (source start file, target name, title, author, documentclass [howto/manual]) # . latex_documents = [ - ('index', 'python-keystoneclient.tex', - 'python-keystoneclient Documentation', - 'Nebula Inc, based on work by Rackspace and Jacob Kaplan-Moss', - 'manual'), + ('index', 'doc-python-keystoneclient.tex', + u'python-keystoneclient Documentation', + u'OpenStack', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of @@ -203,6 +202,18 @@ latex_documents = [ # If false, no module index is generated. #latex_use_modindex = True +# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664 +latex_use_xindy = False + +latex_domain_indices = False + +latex_elements = { + 'makeindex': '', + 'printindex': '', + 'preamble': r'\setcounter{tocdepth}{3}', + 'maxlistdepth': 10, +} + keystoneauth_url = 'https://docs.openstack.org/keystoneauth/latest/' intersphinx_mapping = { 'python': ('https://docs.python.org/', None), -- cgit v1.2.1