generate monasca pdf documentation

https://storyboard.openstack.org/#!/story/2006097

Change-Id: Ia915b535cee5f80fe7c7bcc10c7c87ca3de3bc14

doc/source/conf.py

@@ -216,7 +216,7 @@ latex_elements = {
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, 'MonitoringApi.tex', u'Monasca Documentation',
+    (master_doc, 'doc-monasca-api.tex', u'Monasca Documentation',
      [author], 'manual'),
 ]
 
@@ -238,8 +238,16 @@ latex_documents = [
 #latex_appendices = []
 
 # If false, no module index is generated.
-#latex_domain_indices = True
+latex_domain_indices = False
 
+latex_elements = {
+    'makeindex': '',
+    'printindex': '',
+    'preamble': r'\setcounter{tocdepth}{3}',
+}
+
+# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664
+latex_use_xindy = False
 
 # -- Options for manual page output ---------------------------------------
 

doc/source/index.rst

@@ -124,6 +124,7 @@ Configuration
    admin/index
    cli/index
    configuration/sample
+.. only:: html
    glossary
    install/index
    user/index

tox.ini

@@ -74,6 +74,17 @@ commands =
   {[testenv:api-ref]commands}
   {[testenv:releasenotes]commands}
 
+[testenv:pdf-docs]
+basepython = python3
+envdir = {toxworkdir}/docs
+whitelist_externals =
+  make
+  rm
+commands =
+  rm -rf doc/build/pdf
+  sphinx-build -W -b latex doc/source doc/build/pdf
+  make -C doc/build/pdf
+
 [testenv:api-ref]
 basepython = python3
 description = Called from CI scripts to test and publish the API Ref