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:
Pranav Salunke 2015-02-06 16:54:00 +01:00 committed by Andreas Jaeger
parent 747227bb04
commit 191e317d84

66
tox.ini
View File

@ -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