05acdbc2ff
tools/generatepot-rst.sh has an awk filter to drop UUID from POT files,
but it is unnecessary now. It was introduced to strip UUID information
which was added by default in Sphinx <1.3 [1]. Sphinx >=1.3 does not
output UUID information by default [2], so is is no longer needed.
In addition, (g)awk 5.0 or later (adopted in Ubuntu 20.04 or later)
complains the current awk regexp. I think it is the time to drop it
rather than fixing the regexp.
[1] 993647f316
[2] https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-gettext_uuid
Related-Bug: #2035226
Change-Id: Ie7babf5a815a8e0a602752e862fdb30814b0fbd1
85 lines
2.7 KiB
Bash
Executable File
85 lines
2.7 KiB
Bash
Executable File
#!/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 <<EOF > $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
|