Setup translation for security-guide-rst

Follow setup of openstack-manuals for translation of RST files:
* Add generatepot-rst tox environment (called by infra scripts)
* Enable translation in doc-tools-check-languages.conf
* Add file security-guide-rst/source/locale/security-guide-rst.pot
  (empty for now, the infra scripts will import the realy content)

Change-Id: Iee728f9f0719fddf05cd67218e46694c0c6dee70
Partial-Implements: bp sec-guide-rst

doc-tools-check-languages.conf

@@ -21,8 +21,8 @@ DOC_DIR="./"
 # Values need to match content in project-config/jenkins/scripts/common_translation_update.sh
 declare -A SPECIAL_BOOKS
 SPECIAL_BOOKS=(
-    # Skip translation of guide for now, it needs to consolidate first
+    # Directory is using RST
-    ["security-guide-rst"]="skip"
+    ["security-guide-rst"]="RST"
     # These are translated in openstack-manuals
     ["common-rst"]="skip"
 )

tools/generatepot-rst.sh

@@ -0,0 +1,42 @@
+#!/bin/bash -xe
+
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+DOCNAME=$1
+
+if [ -z "$DOCNAME" ] ; then
+    echo "usage $0 DOCNAME"
+    exit 1
+fi
+
+# We're not doing anything for this directory.
+if [[ "$DOCNAME" = "common-rst" ]] ; then
+    exit 0
+fi
+
+rm -f $DOCNAME/source/locale/$DOCNAME.pot
+sphinx-build -b gettext $DOCNAME/source/ $DOCNAME/source/locale/
+
+# common-rst is translated as part of openstack-manuals, do not
+# include the file in the combined tree.
+rm $DOCNAME/source/locale/common.pot
+
+# Take care of deleting all temporary files so that git add
+# doc/$DOCNAME/source/locale will only add the single pot file.
+# Remove UUIDs, those are not necessary and change too often
+msgcat --sort-output $DOCNAME/source/locale/*.pot | \
+  awk '$0 !~ /^\# [a-z0-9]+$/' > $DOCNAME/source/$DOCNAME.pot
+rm  $DOCNAME/source/locale/*.pot
+rm -rf $DOCNAME/source/locale/.doctrees/
+mv $DOCNAME/source/$DOCNAME.pot $DOCNAME/source/locale/$DOCNAME.pot

tox.ini

@@ -82,6 +82,11 @@ commands =
   # Build and copy RST Guides
   {toxinidir}/tools/build-all-rst.sh
 
+[testenv:generatepot-rst]
+# Generate POT files for translation, needs {posargs} like:
+# tox -e generatepot-rst -- security-guide-rst
+commands = {toxinidir}/tools/generatepot-rst.sh {posargs}
+
 [doc8]
 # Settings for doc8:
 # This file has extra long lines that cannot be avoided, let's white list it.