Fetch generated PDF files correctly

PDF files from openstackdocsstheme-tox-manuals-buildpdf(-starlingxpdf)
jobs were not fetched after recent changes in the related zuul jobs.
This commit merges 'buildpdf' tox env into the 'docs' tox env
following the OpenStack PDF community goal convention.
The same change is made for starlingxdocs theme.
The .zuul.yaml file is updated accordingly.

Change-Id: I0081f77a19b71b093b3debf91e85a42cf2053471
This commit is contained in:
Akihiro Motoki 2019-09-18 06:40:08 +09:00
parent 7aaba6f9f5
commit 3e97737e5a
3 changed files with 17 additions and 41 deletions

View File

@ -1,21 +1,9 @@
# parent job is defined in openstack-manuals
- job:
name: openstackdocsstheme-tox-manuals-buildpdf
parent: build-tox-manuals-base
vars:
tox_envlist: buildpdf
- job:
name: openstackdocsstheme-tox-manuals-buildpdf-starlingxpdf
parent: build-tox-manuals-base
vars:
tox_envlist: buildpdf-starlingxdocs
- job:
name: openstack-tox-docs-starlingxdocs
parent: openstack-tox-docs
vars:
tox_envlist: docs-starlingxdocs
tox_pdf_envlist: pdf-docs-starlingxdocs
- project:
templates:
@ -24,8 +12,6 @@
- release-notes-jobs-python3
check:
jobs:
- openstackdocsstheme-tox-manuals-buildpdf
- openstackdocsstheme-tox-manuals-buildpdf-starlingxpdf
- openstack-tox-pep8
- build-openstack-api-ref:
# Override files section of the job so that this builds
@ -41,8 +27,6 @@
- openstack-tox-docs-starlingxdocs
gate:
jobs:
- openstackdocsstheme-tox-manuals-buildpdf
- openstackdocsstheme-tox-manuals-buildpdf-starlingxpdf
- openstack-tox-pep8
- build-openstack-api-ref:
files:

View File

@ -62,6 +62,7 @@ html_static_path = ['_static/css']
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
('index', 'os-doc-demo.tex', u'os-doc-demo Documentation',
('index', 'doc-openstackdocstheme.tex',
u'OpenStack Docs Theme Documentation',
u'OpenStack Contributors', 'manual'),
]

37
tox.ini
View File

@ -27,18 +27,19 @@ commands = {posargs}
[testenv:docs]
basepython = python3
commands =
rm -rf doc/build api-ref/build
rm -rf doc/build/html doc/build/doctrees
sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html
[testenv:docs-starlingxdocs]
basepython = python3
envdir = {toxworkdir}/docs
commands =
rm -rf doc/build api-ref/build
rm -rf doc/build/html doc/build/doctrees
sphinx-build -a -E -W -d doc/build/doctrees -b html -D html_theme=starlingxdocs doc/source doc/build/html
[testenv:html]
commands =
rm -rf doc/build api-ref/build
rm -rf doc/build/html doc/build/doctrees api-ref/build
sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html
sphinx-build -a -E -W -d api-ref/build/doctrees -b html api-ref/source api-ref/build/html
@ -66,31 +67,21 @@ commands =
rm -rf api-ref/build
sphinx-build -a -E -W -d api-ref/build/doctrees -b html -D html_theme=starlingxdocs api-ref/source api-ref/build/html
[testenv:buildpdf]
# Only build PDF and push it to publish-docs folder so that OpenStack
# CI jobs will publish it.
whitelist_externals =
make
cp
mkdir
[testenv:pdf-docs]
basepython = python3
envdir = {toxworkdir}/docs
commands =
sphinx-build -a -E -W -d doc/build/doctrees -b latex doc/source doc/build/pdf
rm -rf doc/build/pdf
sphinx-build -a -E -W -b latex doc/source doc/build/pdf
make -C doc/build/pdf
mkdir -p publish-docs
cp doc/build/pdf/os-doc-demo.pdf publish-docs
[testenv:buildpdf-starlingxdocs]
# Only build PDF and push it to publish-docs folder so that OpenStack
# CI jobs will publish it.
whitelist_externals =
make
cp
mkdir
[testenv:pdf-docs-starlingxdocs]
basepython = python3
envdir = {toxworkdir}/docs
commands =
sphinx-build -a -E -W -d doc/build/doctrees -b latex -D html_theme=starlingxdocs doc/source doc/build/pdf
rm -rf doc/build/pdf
sphinx-build -a -E -W -b latex -D html_theme=starlingxdocs doc/source doc/build/pdf
make -C doc/build/pdf
mkdir -p publish-docs
cp doc/build/pdf/os-doc-demo.pdf publish-docs
[testenv:bindep]
# Do not install any requirements. We want this to be fast and work even if