Switch to "tox -e docs"
Use the new PTI docs building commands, these use "tox -e docs" for building, also update the publishing job. Update tox.ini to use sphinx-build directly as documented in the PTI. Note that we have to disable warnings, otherwise building fails with: doc/source/results/ocata/ptl.rst:3:Duplicate explicit target name: "tony breeds (tonyb)". Be aware that with current pbr and Sphinx, warnings are disabled due to change of parameter names - so, this keeps the status quo. Depends-On: https://review.openstack.org/615501 Needed-By: https://review.openstack.org/615637 Change-Id: I4713f3a25e08056b7bce9812fa2cf62119330fcc
This commit is contained in:
parent
438903c4aa
commit
79cc6c1db5
@ -1,6 +1,6 @@
|
|||||||
- project:
|
- project:
|
||||||
templates:
|
templates:
|
||||||
- build-openstack-sphinx-docs
|
- build-openstack-docs-pti
|
||||||
- openstack-python35-jobs
|
- openstack-python35-jobs
|
||||||
- openstack-python36-jobs
|
- openstack-python36-jobs
|
||||||
check:
|
check:
|
||||||
@ -15,4 +15,4 @@
|
|||||||
- election-tox-ci-checks
|
- election-tox-ci-checks
|
||||||
post:
|
post:
|
||||||
jobs:
|
jobs:
|
||||||
- publish-static
|
- publish-tox-docs-static
|
||||||
|
4
tox.ini
4
tox.ini
@ -27,7 +27,9 @@ basepython = python2
|
|||||||
commands = {posargs}
|
commands = {posargs}
|
||||||
|
|
||||||
[testenv:docs]
|
[testenv:docs]
|
||||||
commands = python setup.py build_sphinx
|
# NOTE: -W is not added since ocata/ptl.rst throws a warning about duplicate
|
||||||
|
# IDs.
|
||||||
|
commands = sphinx-build -b html -d doc/build/doctrees doc/source doc/build/html
|
||||||
|
|
||||||
[testenv:ci-checks]
|
[testenv:ci-checks]
|
||||||
commands = ci-check-all-candidate-files
|
commands = ci-check-all-candidate-files
|
||||||
|
Loading…
Reference in New Issue
Block a user