Add pdf-docs tox env

Story: 2006104
Task: 35271
Change-Id: Ic06c61d1ed593cb27d99f0d5d2d179d81afabff0

doc/source/conf.py

@@ -28,6 +28,7 @@ extensions = [
 openstackdocs_repo_name = 'openstack/openstack-helm'
 openstackdocs_auto_name = False
 openstackdocs_use_storyboard = True
+openstackdocs_pdf_link = True
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
 # text edit cycles.
@@ -86,7 +87,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

@@ -23,6 +23,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