Cleanup builds
Remove separate build-user-guides.sh and create a new build-all-rst.sh tool. Remove networking tox environment, since the RST guides share files, we should always build them together using the docs tox environment. Change-Id: I7ef98ca5e134096e14c79d58b0fc62a07747e471
This commit is contained in:

committed by
Andreas Jaeger

parent
978e3cb0fe
commit
c2cac00294
18
tools/build-all-rst.sh
Executable file
18
tools/build-all-rst.sh
Executable file
@@ -0,0 +1,18 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
mkdir -p publish-docs
|
||||||
|
|
||||||
|
GLOSSARY="--glossary"
|
||||||
|
|
||||||
|
for guide in user-guide user-guide-admin networking-guide; do
|
||||||
|
tools/build-rst.sh doc/$guide $GLOSSARY --build build \
|
||||||
|
--target $guide
|
||||||
|
# Build it only the first time
|
||||||
|
GLOSSARY=""
|
||||||
|
done
|
||||||
|
|
||||||
|
# Draft guides
|
||||||
|
for guide in admin-guide-cloud-rst; do
|
||||||
|
tools/build-rst.sh doc/$guide --build build \
|
||||||
|
--target "draft/$guide"
|
||||||
|
done
|
@@ -1,6 +0,0 @@
|
|||||||
#!/bin/sh -e
|
|
||||||
|
|
||||||
tools/build-rst.sh doc/user-guide --glossary --build build
|
|
||||||
# No need to build the glossary again here.
|
|
||||||
tools/build-rst.sh doc/user-guide-admin --build build
|
|
||||||
tools/build-rst.sh doc/admin-guide-cloud-rst --build build
|
|
@@ -43,19 +43,8 @@ function copy_to_branch {
|
|||||||
|
|
||||||
mkdir -p publish-docs
|
mkdir -p publish-docs
|
||||||
|
|
||||||
GLOSSARY="--glossary"
|
# Build all RST guides
|
||||||
for guide in user-guide user-guide-admin networking-guide; do
|
tools/build-all-rst.sh
|
||||||
tools/build-rst.sh doc/$guide $GLOSSARY --build build \
|
|
||||||
--target $guide
|
|
||||||
# Build it only the first time
|
|
||||||
GLOSSARY=""
|
|
||||||
done
|
|
||||||
|
|
||||||
# Draft guides
|
|
||||||
for guide in admin-guide-cloud-rst; do
|
|
||||||
tools/build-rst.sh doc/$guide --build build \
|
|
||||||
--target "draft/$guide"
|
|
||||||
done
|
|
||||||
|
|
||||||
# Build the www pages so that openstack-doc-test creates a link to
|
# Build the www pages so that openstack-doc-test creates a link to
|
||||||
# www/www-index.html.
|
# www/www-index.html.
|
||||||
|
8
tox.ini
8
tox.ini
@@ -42,13 +42,7 @@ commands =
|
|||||||
|
|
||||||
[testenv:docs]
|
[testenv:docs]
|
||||||
commands =
|
commands =
|
||||||
{toxinidir}/tools/build-user-guides.sh
|
{toxinidir}/tools/build-all-rst.sh
|
||||||
sphinx-build -W doc/networking-guide/source doc/networking-guide/build/html
|
|
||||||
|
|
||||||
[testenv:network]
|
|
||||||
commands =
|
|
||||||
{toxinidir}/tools/glossary2rst.py doc/common-rst/glossary.rst
|
|
||||||
sphinx-build -W doc/networking-guide/source doc/networking-guide/build/html
|
|
||||||
|
|
||||||
[testenv:publishdocs]
|
[testenv:publishdocs]
|
||||||
# Prepare all documents (except www subdir) so that they can get
|
# Prepare all documents (except www subdir) so that they can get
|
||||||
|
Reference in New Issue
Block a user