openstack/training-guides
Code Issues Proposed changes

Disables XML publishing

Browse Source 
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
1 changed files with 5 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
tox.ini
View File

@ -1,6 +1,6 @@
[tox]
minversion = 1.6
envlist = checkniceness,checksyntax,checkdeletions,checkbuild,checklinks
envlist = slides
skipsdist = True
[testenv]
@ -18,77 +18,19 @@ whitelist_externals =
[testenv:venv]
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]
# New RST based environment for building slides
# Note: Resulting files will not be made available anywhere.
commands=
commands =
# Niceness test for doc directory
doc8 doc
# Build labs tar/zip files
mkdir -p publish-docs/trunk/training-guides
# Build labs scripts
# Build training labs scripts
bash {toxinidir}/tools/generatelabs
[doc8]
# Settings for doc8:
# File extensions to use
extensions = .rst,.txt