Browse Source

Merge "PDF documentation build"

tags/16.0.0.0b2
Zuul 1 week ago
parent
commit
a629d100be
3 changed files with 24 additions and 4 deletions
  1. 10
    2
      doc/source/conf.py
  2. 4
    2
      doc/source/index.rst
  3. 10
    0
      tox.ini

+ 10
- 2
doc/source/conf.py View File

@@ -236,7 +236,7 @@ htmlhelp_basename = 'Horizondoc'
236 236
 # (source start file, target name, title, author, documentclass
237 237
 # [howto/manual]).
238 238
 latex_documents = [
239
-    ('index', 'Horizon.tex', u'Horizon Documentation',
239
+    ('index', 'doc-horizon.tex', u'Horizon Documentation',
240 240
      u'OpenStack Foundation', 'manual'),
241 241
 ]
242 242
 
@@ -258,8 +258,16 @@ latex_documents = [
258 258
 # latex_appendices = []
259 259
 
260 260
 # If false, no module index is generated.
261
-# latex_domain_indices = True
261
+latex_domain_indices = False
262 262
 
263
+latex_elements = {
264
+    'makeindex': '',
265
+    'printindex': '',
266
+    'preamble': r'\setcounter{tocdepth}{3}',
267
+}
268
+
269
+# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664
270
+latex_use_xindy = False
263 271
 
264 272
 # -- Options for manual page output -------------------------------------------
265 273
 

+ 4
- 2
doc/source/index.rst View File

@@ -68,5 +68,7 @@ Information
68 68
 
69 69
    glossary
70 70
 
71
-* :ref:`genindex`
72
-* :ref:`modindex`
71
+.. only:: html
72
+
73
+   * :ref:`genindex`
74
+   * :ref:`modindex`

+ 10
- 0
tox.ini View File

@@ -126,6 +126,16 @@ deps =
126 126
 commands =
127 127
   sphinx-build -W -b html doc/source doc/build/html
128 128
 
129
+[testenv:pdf-docs]
130
+basepython = python3
131
+envdir = {toxworkdir}/docs
132
+deps = {[testenv:docs]deps}
133
+whitelist_externals =
134
+  make
135
+commands =
136
+  sphinx-build -W -b latex doc/source doc/build/pdf
137
+  make -C doc/build/pdf
138
+
129 139
 [testenv:releasenotes]
130 140
 envdir = {toxworkdir}/docs
131 141
 deps = {[testenv:docs]deps}

Loading…
Cancel
Save