Enable building of translated manuals

This is the initial setup to build translated manuals. For now only the
api-quick-start is build.

This needs openstack-doc-tools version 0.13.

Change-Id: I140b8007d76bda5f436cbd80e77b890852c71827

.gitignore

@@ -5,6 +5,7 @@
 publish-docs/
 target/
 /build-*.log.gz
+/generated
 
 # Packages
 *.egg

tools/copy_pom

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+TARGET=$1
+
+echo "copying pom.xml for $TARGET"
+cp pom.xml generated/$TARGET/pom.xml

tox.ini

@@ -40,3 +40,19 @@ commands =
    openstack-doc-test --check-build --publish --only-book api-ref --only-book api-ref-guides
    # We need to move api-ref-guides to the proper place:
    mv publish-docs/api-ref-guides publish-docs/api-ref/
+
+[testenv:buildlang]
+# Run as "tox -e buildlang -- $LANG"
+# openstack-generate-docbook needs xml2po which cannot be installed
+# in the venv. Since it's installed in the system, let's
+# use sitepackages.
+# For now this only builds api-quick-start
+sitepackages=True
+whitelist_externals = bash
+commands =
+  openstack-generate-docbook -l {posargs} -b api-quick-start -r ./
+  # 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 api-quick-start