Disables XML publishing
Address the change from XML to RST, XML based jobs are disabled. Current content in Juno release for training guides is not going to include any XML Docbook content. This patch disables the XML related jobs. This patch will be followed by more jobs added to build RST content to HTML and PDF format as required using the tools decided by the team. The jobs disabled will be re-enabled with the appropriate set of tools. Deletes all the jobs which are not required. Addresses changes done by https://review.openstack.org/#/c/152118. Change-Id: I91727929fe19dbc7487f2719cdba80157c543d6b
This commit is contained in:
parent
747227bb04
commit
191e317d84
66
tox.ini
66
tox.ini
@ -1,6 +1,6 @@
|
|||||||
[tox]
|
[tox]
|
||||||
minversion = 1.6
|
minversion = 1.6
|
||||||
envlist = checkniceness,checksyntax,checkdeletions,checkbuild,checklinks
|
envlist = slides
|
||||||
skipsdist = True
|
skipsdist = True
|
||||||
|
|
||||||
[testenv]
|
[testenv]
|
||||||
@ -18,77 +18,19 @@ whitelist_externals =
|
|||||||
[testenv:venv]
|
[testenv:venv]
|
||||||
commands = {posargs}
|
commands = {posargs}
|
||||||
|
|
||||||
[testenv:checklinks]
|
|
||||||
commands = openstack-doc-test --check-links {posargs}
|
|
||||||
|
|
||||||
[testenv:checkniceness]
|
|
||||||
commands = openstack-doc-test --check-niceness {posargs}
|
|
||||||
|
|
||||||
[testenv:checksyntax]
|
|
||||||
commands =
|
|
||||||
openstack-doc-test --check-syntax {posargs}
|
|
||||||
# Check that .po and .pot files are valid:
|
|
||||||
bash -c "find doc -type f -regex '.*\.pot?' -print0|xargs -0 -n 1 msgfmt --check-format -o /dev/null"
|
|
||||||
|
|
||||||
[testenv:checkdeletions]
|
|
||||||
commands = openstack-doc-test --check-deletions {posargs}
|
|
||||||
|
|
||||||
[testenv:checkbuild]
|
|
||||||
commands =
|
|
||||||
mkdir -p publish-docs/trunk/training-guides
|
|
||||||
openstack-doc-test --check-build {posargs}
|
|
||||||
# Build labs scripts
|
|
||||||
bash {toxinidir}/tools/generatelabs
|
|
||||||
|
|
||||||
[testenv:publishdocs]
|
|
||||||
# Prepare all documents (except www subdir) so that they can get
|
|
||||||
# published on docs.openstack.org with just copying publish-docs/*
|
|
||||||
# over.
|
|
||||||
commands =
|
|
||||||
# Create directory, it might not be here if openstack-doc-test does
|
|
||||||
# not publish anything.
|
|
||||||
mkdir -p publish-docs/trunk/training-guides
|
|
||||||
# We only publish changed manuals.
|
|
||||||
openstack-doc-test --check-build --publish
|
|
||||||
# Build and publish training labs scripts
|
|
||||||
bash {toxinidir}/tools/generatelabs
|
|
||||||
|
|
||||||
[testenv:checklang]
|
|
||||||
# Generatedocbook needs xml2po which cannot be installed
|
|
||||||
# in the venv. Since it's installed in the system, let's
|
|
||||||
# use sitepackages.
|
|
||||||
sitepackages=True
|
|
||||||
whitelist_externals = doc-tools-check-languages
|
|
||||||
commands = doc-tools-check-languages doc-tools-check-languages.conf test all
|
|
||||||
|
|
||||||
[testenv:buildlang]
|
|
||||||
# Run as "tox -e buildlang -- $LANG"
|
|
||||||
# Generatedocbook needs xml2po which cannot be installed
|
|
||||||
# in the venv. Since it's installed in the system, let's
|
|
||||||
# use sitepackages.
|
|
||||||
sitepackages=True
|
|
||||||
whitelist_externals = doc-tools-check-languages
|
|
||||||
commands = doc-tools-check-languages doc-tools-check-languages.conf test {posargs}
|
|
||||||
|
|
||||||
[testenv:publishlang]
|
|
||||||
# Generatedocbook needs xml2po which cannot be installed
|
|
||||||
# in the venv. Since it's installed in the system, let's
|
|
||||||
# use sitepackages.
|
|
||||||
sitepackages=True
|
|
||||||
whitelist_externals = doc-tools-check-languages
|
|
||||||
commands = doc-tools-check-languages doc-tools-check-languages.conf test all
|
|
||||||
|
|
||||||
[testenv:slides]
|
[testenv:slides]
|
||||||
# New RST based environment for building slides
|
# New RST based environment for building slides
|
||||||
# Note: Resulting files will not be made available anywhere.
|
# Note: Resulting files will not be made available anywhere.
|
||||||
commands =
|
commands =
|
||||||
# Niceness test for doc directory
|
# Niceness test for doc directory
|
||||||
doc8 doc
|
doc8 doc
|
||||||
|
# Build labs tar/zip files
|
||||||
mkdir -p publish-docs/trunk/training-guides
|
mkdir -p publish-docs/trunk/training-guides
|
||||||
# Build labs scripts
|
# Build training labs scripts
|
||||||
bash {toxinidir}/tools/generatelabs
|
bash {toxinidir}/tools/generatelabs
|
||||||
|
|
||||||
[doc8]
|
[doc8]
|
||||||
# Settings for doc8:
|
# Settings for doc8:
|
||||||
# File extensions to use
|
# File extensions to use
|
||||||
extensions = .rst,.txt
|
extensions = .rst,.txt
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user