f0ce9fb0d3
The firstapp document has been removed: * Remove links to firstapp document * Remove tooling for building it, remove also tooling for separate distribution install-guide, this is not done anymore. This includes removing tooling for building with tags. Change-Id: I5de578590237aefe31546dd7c1dce56f30e98774
87 lines
2.8 KiB
Bash
Executable File
87 lines
2.8 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 | \
|
|
awk '$0 !~ /^\# [a-z0-9]+$/' \
|
|
> ${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.
|
|
# Remove UUIDs, those are not necessary and change too often
|
|
msgcat --sort-by-file ${DIRECTORY}/source/locale/*.pot | \
|
|
awk '$0 !~ /^\# [a-z0-9]+$/' > ${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
|