1713dabf56
The two tox environments were large and mostly duplicated, use a shell script instead and use the build-rst.sh script to simplify building and publishing. For copying to /kilo, use the tools/copy-to-branch.sh script instead of the simple commands since that is more robust. Merge that script into this script, no need for a second script. Update requirements: We need 0.27 at least to not have to delete the Debian Install Guide, sync also pbr with global-requirements.txt. Change-Id: Ieba77b4e3d0bbe58db041206d9725c523b3bb43a
73 lines
2.1 KiB
Bash
Executable File
73 lines
2.1 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.
|
|
|
|
PUBLISH=$1
|
|
|
|
if [[ -z "$PUBLISH" ]] ; then
|
|
echo "usage $0 (publish|check)"
|
|
exit 1
|
|
fi
|
|
|
|
# Copy files from draft to named branch and replace all links from
|
|
# draft with links to the branch
|
|
function copy_to_branch {
|
|
BRANCH=$1
|
|
|
|
if [ -e publish-docs/draft ] ; then
|
|
|
|
# Copy files over
|
|
cp -a publish-docs/draft publish-docs/$BRANCH
|
|
|
|
for f in $(find publish-docs/$BRANCH -name "atom.xml"); do
|
|
sed -i -e "s|/draft/|/$BRANCH/|g" $f
|
|
done
|
|
for f in $(find publish-docs/$BRANCH -name "*.html"); do
|
|
sed -i -e "s|/draft/|/$BRANCH/|g" $f
|
|
done
|
|
fi
|
|
}
|
|
|
|
mkdir -p publish-docs
|
|
|
|
# Build End User Guide
|
|
tools/build-rst.sh doc/user-guide --glossary --tag user_only --build build \
|
|
--target user-guide
|
|
|
|
# Build Admin User Guide
|
|
# No need to build the glossary again here.
|
|
tools/build-rst.sh doc/user-guide-admin --tag admin_only --build build \
|
|
--target user-guide-admin
|
|
|
|
# Build Networking Guide
|
|
tools/build-rst.sh doc/networking-guide --build build \
|
|
--target networking-guide
|
|
|
|
# Build the www pages so that openstack-doc-test creates a link to
|
|
# www/www-index.html.
|
|
python tools/www-generator.py --source-directory www/ --output-directory publish-docs/
|
|
rsync -a www/static/ publish-docs/
|
|
if [ "$PUBLISH" = "publish" ] ; then
|
|
# Don't publish this file
|
|
rm publish-docs/www-index.html
|
|
fi
|
|
|
|
# We only publish changed manuals.
|
|
if [ "$PUBLISH" = "publish" ] ; then
|
|
openstack-doc-test --check-build --publish
|
|
# For publishing to both /draft and /BRANCH
|
|
copy_to_branch kilo
|
|
else
|
|
openstack-doc-test --check-build
|
|
fi
|