openstack-manuals/tox.ini
Andreas Jaeger 3422e45c68 Publish only for trunk
Publish documents only for trunk.

This patch needs to go in before we branch for stable. Once branched,
the stable/icehouse branch should be changed again to get a
publishdocs section that only contains the following line for publishdocs:
openstack-doc-test --check-build --publish --only-book install-guide --only-book config-reference

Change-Id: Ibb2f7ef3917801f158896308f1d5b5ba350acf5c
2014-05-04 02:06:50 +02:00

84 lines
2.8 KiB
INI

[tox]
minversion = 1.6
envlist = checkniceness,checksyntax,checkdeletions,checkbuild
skipsdist = True
[testenv]
setenv =
VIRTUAL_ENV={envdir}
deps = -r{toxinidir}/test-requirements.txt
whitelist_externals =
bash
cp
mkdir
rm
sed
[testenv:venv]
commands = {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 = openstack-doc-test --check-build {posargs}
[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 =
## Commands for master:
openstack-doc-test --check-build --publish --force
# Now publish www as well, we cannot do this from openstack-doc-test
bash -c "cp -a www/* publish-docs/"
## Commands for stable/icehouse only:
# openstack-doc-test --check-build --publish --only-book install-guide --only-book config-reference
[testenv:buildlang-install]
# Run as "tox -e buildlang-install -- $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 = bash
commands =
openstack-generate-docbook -l {posargs} -b common
openstack-generate-docbook -l {posargs} -b glossary
openstack-generate-docbook -l {posargs} -b user-guide
openstack-generate-docbook -l {posargs} -b install-guide
# tox 1.7 does not parse the following line:
# cp doc/pom.xml generated/{posargs}/pom.xml
# Thus replaced by the next one:
bash ./tools/copy_pom {posargs}
openstack-doc-test --check-build --publish -l {posargs} --only-book install-guide
[testenv:buildlang-misc]
# Run as "tox -e buildlang-misc -- $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 = bash
commands =
openstack-generate-docbook -l {posargs} -b common
openstack-generate-docbook -l {posargs} -b glossary
openstack-generate-docbook -l {posargs} -b security-guide
# NOTE(jaegerandi) as of 2014-04-17 the ha guide does not build for
# Japanese, disable it.
# openstack-generate-docbook -l {posargs} -b high-availability-guide
# tox 1.7 does not parse the following line:
# cp doc/pom.xml generated/{posargs}/pom.xml
# Thus replaced by the next one:
bash ./tools/copy_pom {posargs}
openstack-doc-test --check-build --publish -l {posargs} --only-book security-guide