Always rebuild sphinx env on doc build

Building docs locally may build with stale extension content without
this change.

This change also adds the required bindep.txt packages for the pdf-docs
tox target.

Change-Id: If2264241d20ab0286b1b5ea723ef370c4d772693
Signed-off-by: Steve Baker <sbaker@redhat.com>
This commit is contained in:
Steve Baker
2025-08-15 10:54:03 +12:00
parent 1aec2d0307
commit 4678ed77a3
2 changed files with 11 additions and 3 deletions

View File

@@ -72,6 +72,14 @@ graphviz [!platform:gentoo test doc]
# libsrvg2 is needed for sphinxcontrib-svg2pdfconverter in docs builds.
librsvg2-tools [doc platform:rpm]
librsvg2-bin [doc platform:dpkg]
latexmk [doc]
texlive-collection-fontsrecommended [doc platform:rpm]
tex-gyre [doc platform:dpkg]
texlive-latex-extra [doc platform:dpkg]
texlive-collection-latexextra [doc platform:rpm]
texlive-fonts-extra-links [doc platform:dpkg]
texlive-collection-fontsextra [doc platform:rpm]
# these are needed to build images

View File

@@ -88,7 +88,7 @@ deps =
-c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
-r{toxinidir}/requirements.txt
-r{toxinidir}/doc/requirements.txt
commands = sphinx-build -b html doc/source doc/build/html
commands = sphinx-build -E -b html doc/source doc/build/html
[testenv:pdf-docs]
allowlist_externals =
@@ -96,7 +96,7 @@ allowlist_externals =
dot
deps = {[testenv:docs]deps}
commands =
sphinx-build -b latex doc/source doc/build/pdf
sphinx-build -E -b latex doc/source doc/build/pdf
make -C doc/build/pdf
[testenv:api-ref]
@@ -109,7 +109,7 @@ deps =
allowlist_externals = bash
commands =
bash -c 'rm -rf api-ref/build'
sphinx-build -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html
sphinx-build -E -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html
[testenv:releasenotes]
usedevelop = False