Publish German Quick Start on developer.o.o

Prepare tox.ini for publishing to developer.o.o, this needs changes
in project-config to actually do the work.

Add comments to doc-tools-check-languages to point out special
treatment.

Change-Id: Ic467d8d53944b13e65555d910350547d3ded1a86

doc-tools-check-languages.conf

@@ -1,4 +1,16 @@
-# Example configuration for the languages 'ja' and 'fr'.
+
+# IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT
+# Note that we publish all files to developer.openstack.org using
+# "tox -e publishlang-api".
+
+# Our script doc-tools-check-languages places guides in the wrong
+# directories, they need to be moved in tox.ini manually to the right
+# place for publishing.
+
+# We publish:
+# The api-quick-start at:
+# http:/developer.openstack.org/LANG/api-guide/quick-start or
+# http://developer.openstack.org/draft/LANG/api-guide/quick-start
 
 # directories to be set up
 declare -A DIRECTORIES=(
@@ -6,11 +18,15 @@ declare -A DIRECTORIES=(
 
 # books to be built
 declare -A BOOKS=(
+    # See comment at start of file and update tox.ini as well if you
+    # change anything here.
     ["de"]="api-quick-start"
 )
 
 # draft books
 declare -A DRAFTS=(
+    # See comment at start of file and update tox.ini as well if you
+    # change anything here.
     ["de"]="api-quick-start"
 )
 

tox.ini

@@ -89,6 +89,27 @@ sitepackages=True
 whitelist_externals = doc-tools-check-languages
 commands = doc-tools-check-languages doc-tools-check-languages.conf publish all
 
+[testenv:publishlang-api]
+# openstack-generate-docbook needs xml2po which cannot be installed
+# in the venv. Since it's installed in the system, let's
+# use sitepackages.
+# Publish translated documents to developer.openstack.org with just
+# copying publish-docs/api-ref over.
+sitepackages=True
+whitelist_externals =
+   doc-tools-check-languages
+   mkdir
+   mv
+commands =
+   doc-tools-check-languages doc-tools-check-languages.conf publish all
+   # Move directories to proper place, we publish translated
+   # quick-start guides at
+   # developer.openstack.org/LANG/api-guide/quick-start or
+   # developer.openstack.org/draft/LANG/api-guide/quick-start.
+   mkdir -p publish-docs/api-ref
+   mkdir -p publish-docs/api-ref/draft/de/api-guide
+   mv publish-docs/draft/de/api-quick-start/ publish-docs/api-ref/draft/de/api-guide/quick-start
+
 [testenv:generatepot-rst]
 # Generate POT files for translation, needs {posargs} like:
 # tox -e generatepot-rst -- firstapp