#!/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. REPOSITORY=$1 USE_DOC=$2 DOCNAME=$3 if [ $# -lt 3 ] ; then echo "usage $0 REPOSITORY USE_DOC DOCNAME" exit 1 fi DIRECTORY=$DOCNAME TOPDIR="" if [ "$USE_DOC" = "1" ] ; then DIRECTORY="doc/$DOCNAME" TOPDIR="doc/" fi if [ -x "$(command -v getconf)" ]; then NUMBER_OF_CORES=$(getconf _NPROCESSORS_ONLN) else NUMBER_OF_CORES=2 fi # common is imported from various RST documents, but what files are # used varies across RST documents. Thus we need an index file to include # all files under common. To this aim, we create such document called # 'common-work' dynamically to generate the POT file of common. if [[ "$REPOSITORY" = "openstack-manuals" && "$DOCNAME" = "common" ]] ; then DIRECTORY="doc/common-work" TOPDIR="doc/" mkdir -p $DIRECTORY/source cp doc/common/source/conf.py $DIRECTORY/source/conf.py ln -sf ../../common $DIRECTORY/source/common cat < $DIRECTORY/source/index.rst .. toctree:: :maxdepth: 2 :glob: common/* EOF fi # First remove the old pot file, otherwise the new file will contain # old references rm -f ${DIRECTORY}/source/locale/$DOCNAME.pot sphinx-build -j $NUMBER_OF_CORES -b gettext ${DIRECTORY}/source/ \ ${DIRECTORY}/source/locale/ if [[ "$REPOSITORY" = "openstack-manuals" && "$DOCNAME" = "common" ]] ; then # In case of common, we use the working directory 'common-work'. # Copies the generated POT to common/source/locale # and finally removes the working directory. msgcat ${DIRECTORY}/source/locale/common.pot \ > ${TOPDIR}common/source/locale/common.pot rm -rf $DIRECTORY else # common is translated as part of openstack-manuals, do not # include the file in the combined tree if it exists. rm -f ${DIRECTORY}/source/locale/common.pot # Take care of deleting all temporary files so that # "git add ${DIRECTORY}/source/locale" will only add the # single pot file. msgcat --sort-by-file ${DIRECTORY}/source/locale/*.pot \ > ${DIRECTORY}/source/$DOCNAME.pot rm ${DIRECTORY}/source/locale/*.pot rm -rf ${DIRECTORY}/source/locale/.doctrees/ mv ${DIRECTORY}/source/$DOCNAME.pot ${DIRECTORY}/source/locale/$DOCNAME.pot fi