PDF Documentation Build tox target

This patch adds a `pdf-docs` tox target that will build
PDF versions of our docs. As per the Train community goal:

  https://governance.openstack.org/tc/goals/selected/train/pdf-doc-generation.html

Add sphinxcontrib-svg2pdfconverter to doc/requirements.txt
to convert our SVGs.

Update docs requirement as well to follow PTI.

Change-Id: I0b866b2e57557290533ee7e7e162e56c9c17cf54
Story: 2006072

1 files changed, 4 insertions, 1 deletions

diff --git a/doc/source/conf.py b/doc/source/conf.py
index b056e5c..0547331 100755
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -23,6 +23,7 @@ extensions = [
     'sphinx.ext.autodoc',
     #'sphinx.ext.intersphinx',
     'openstackdocstheme',
+    'sphinxcontrib.rsvgconverter',
 ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
@@ -67,11 +68,13 @@ htmlhelp_basename = 'python-barbicanclientdoc'
 # [howto/manual]).
 latex_documents = [
     ('index',
-     'python-barbicanclient.tex',
+     'doc-python-barbicanclient.tex',
      u'python-barbicanclient Documentation',
      u'OpenStack Foundation', 'manual'),
 ]
 
+latex_use_xindy = False
+
 # Example configuration for intersphinx: refer to the Python standard library.
 #intersphinx_mapping = {'http://docs.python.org/': None}