Update building for liberty

Disable all non-translated and non-versioned guides for translation.
Only build backported guides (install-guide and config-reference).
Do not publish web pages.

Change-Id: I2141b69244c7b60bfbec275fea3c1fda4e1e857b

doc-test.conf

@@ -1,8 +1,8 @@
 [DEFAULT]
 repo_name = openstack-manuals
 
-# Publish to /draft instead of /trunk
-release_path = draft
+# Publish to /liberty instead of /trunk
+release_path = liberty
 
 url_exception = https://build.opensuse.org/package/show?package=python-pip&project=Cloud:OpenStack:Master
 url_exception = https://packer.io

doc-tools-check-languages.conf

@@ -1,20 +1,14 @@
 # directories to be set up
 declare -A DIRECTORIES=(
-    ["fr"]="common glossary image-guide"
-    ["ja"]="common glossary image-guide"
-    ["zh_CN"]="common glossary arch-design image-guide"
 )
 
 # books to be built
 declare -A BOOKS=(
-    ["fr"]="image-guide"
-    ["ja"]="image-guide user-guide user-guide-admin install-guide"
-    ["zh_CN"]="arch-design image-guide"
+    ["ja"]="install-guide"
 )
 
 # draft books
 declare -A DRAFTS=(
-    ["fr"]="image-guide"
     ["ja"]="install-guide"
 )
 
@@ -29,11 +23,19 @@ DOC_DIR="doc/"
 # Values need to match content in
 # project-config/jenkins/scripts/common_translation_update.sh
 declare -A SPECIAL_BOOKS=(
-    ["admin-guide-cloud"]="RST"
+    # Skip nearly everything for liberty. We only translate the
+    # install-guide on the branch.
     ["install-guide"]="RST"
-    ["networking-guide"]="RST"
-    ["user-guide"]="RST"
-    ["user-guide-admin"]="RST"
+    ["admin-guide-cloud"]="skip"
+    ["arch-design"]="skip"
+    ["cli-reference"]="skip"
+    ["common"]="skip"
+    ["config-reference"]="skip"
+    ["glossary"]="skip"
+    ["image-guide"]="skip"
+    ["networking-guide"]="skip"
+    ["user-guide"]="skip"
+    ["user-guide-admin"]="skip"
     # Skip in-progress guides
     ["contributor-guide"]="skip"
     ["arch-design-rst"]="skip"

tools/build-all-rst.sh

@@ -11,17 +11,20 @@ if [[ $# > 0 ]] ; then
     fi
 fi
 
-for guide in user-guide user-guide-admin networking-guide admin-guide-cloud contributor-guide; do
-    tools/build-rst.sh doc/$guide $GLOSSARY --build build \
-        --target $guide $LINKCHECK
-    # Build it only the first time
-    GLOSSARY=""
-done
+# For stable branches, we only have the Install Guide to publish.
+# All others are uncommented but left for reference.
 
-# Draft guides
-for guide in arch-design-rst config-ref-rst image-guide-rst; do
-    tools/build-rst.sh doc/$guide --build build \
-        --target "draft/$guide" $LINKCHECK
-done
+#for guide in user-guide user-guide-admin networking-guide admin-guide-cloud contributor-guide; do
+#    tools/build-rst.sh doc/$guide $GLOSSARY --build build \
+#        --target $guide $LINKCHECK
+#    # Build it only the first time
+#    GLOSSARY=""
+#done
+#
+## Draft guides
+#for guide in arch-design-rst config-ref-rst image-guide-rst; do
+#    tools/build-rst.sh doc/$guide --build build \
+#        --target "draft/$guide" $LINKCHECK
+#done
 
 tools/build-install-guides-rst.sh $LINKCHECK

tools/build-install-guides-rst.sh

@@ -65,7 +65,7 @@ for tag in $TAGS; do
 
     # Build the guide
     tools/build-rst.sh doc/install-guide  \
-        $GLOSSARY --tag ${tag} --target "draft/install-guide-${tag}" \
+        $GLOSSARY --tag ${tag} --target "liberty/install-guide-${tag}" \
         $LINKCHECK
 
     # Restore the index file
@@ -74,6 +74,6 @@ for tag in $TAGS; do
     ##
     # Remove Debian specific content from other guides
     if [[ "$tag" != "debian" ]]; then
-        rm -rf publish-docs/draft/install-guide-$tag/debconf
+        rm -rf publish-docs/liberty/install-guide-$tag/debconf
     fi
 done

tools/publishdocs.sh

@@ -50,29 +50,38 @@ mkdir -p publish-docs
 # Build all RST guides
 tools/build-all-rst.sh
 
+# Not needed for any stable branch, left in but uncommented for
+# reference.
+
 # Build the www pages so that openstack-doc-test creates a link to
 # www/www-index.html.
-if [ "$PUBLISH" = "build" ] ; then
-    python tools/www-generator.py --source-directory www/ \
-        --output-directory publish-docs/www/
-    rsync -a www/static/ publish-docs/www/
-    # publish-docs/www-index.html is the trigger for openstack-doc-test
-    # to include the file.
-    mv publish-docs/www/www-index.html publish-docs/www-index.html
-fi
-if [ "$PUBLISH" = "publish" ] ; then
-    python tools/www-generator.py --source-directory www/ \
-        --output-directory publish-docs
-    rsync -a www/static/ publish-docs/
-    # Don't publish this file
-    rm publish-docs/www-index.html
-fi
+
+#if [ "$PUBLISH" = "build" ] ; then
+#    python tools/www-generator.py --source-directory www/ \
+#        --output-directory publish-docs/www/
+#    rsync -a www/static/ publish-docs/www/
+#    # publish-docs/www-index.html is the trigger for openstack-doc-test
+#    # to include the file.
+#    mv publish-docs/www/www-index.html publish-docs/www-index.html
+#fi
+
+#if [ "$PUBLISH" = "publish" ] ; then
+#    python tools/www-generator.py --source-directory www/ \
+#        --output-directory publish-docs
+#    rsync -a www/static/ publish-docs/
+#    # Don't publish this file
+#    rm publish-docs/www-index.html
+#fi
 
 # We only publish changed manuals.
+# For liberty, only publish config-reference as DocBook XML.
 if [ "$PUBLISH" = "publish" ] ; then
-    openstack-doc-test --check-build --publish
-    # For publishing to both /draft and /BRANCH
-    copy_to_branch liberty
+    openstack-doc-test --check-build --publish --only-book config-reference
+    # Do not publish Debian Guide for now
+    rm -rf publish-docs/liberty/install-guide-debian
+    # For publishing to both /draft and /BRANCH.
+    # Not needed on the branch.
+    #copy_to_branch liberty
 else
-    openstack-doc-test --check-build
+    openstack-doc-test --check-build --only-book config-reference
 fi