Add pdf-docs tox env

Story: 2006104
Task: 35275
Change-Id: Ieadbb40bcd7fbdd6d37e78eb174fdb99ad7312a8

doc/source/conf.py

@@ -41,6 +41,7 @@ copyright = '2016-2021, OpenStack Foundation'
 
 openstackdocs_repo_name = 'openstack/openstack-helm-infra'
 openstackdocs_use_storyboard = True
+openstackdocs_pdf_link = True
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
 add_function_parentheses = True
@@ -80,7 +81,7 @@ htmlhelp_basename = '%sdoc' % project
 # [howto/manual]).
 latex_documents = [
     ('index',
-     '%s.tex' % project,
+     'doc-%s.tex' % project,
      '%s Documentation' % project,
      'OpenStack Foundation', 'manual'),
 ]

tox.ini

@@ -21,6 +21,17 @@ commands =
 allowlist_externals =
   rm
 
+[testenv:pdf-docs]
+envdir = {toxworkdir}/docs
+deps = {[testenv:docs]deps}
+allowlist_externals =
+  make
+  rm
+commands =
+  rm -rf doc/build/pdf
+  sphinx-build -W --keep-going -b latex -j auto doc/source doc/build/pdf
+  make -C doc/build/pdf
+
 [testenv:lint]
 deps =
   yq