12 Commits

Author SHA1 Message Date
Andreas Jaeger
ed100316b4 Convert glossary to RST
We do not need the DocBook XML glossary anymore, since we do not build
any DocBook guides that use it.

Add instead the RST version of the document to git.
Adjust scripts to not build or publish the glossary anymore.

Change-Id: Id4bfef7666690e6d08291f664751db7a4d4d5983
2016-05-02 09:20:30 +02:00
Andreas Jaeger
cb24f93635 Remove parallel building
Parallel building is not working reliable with errors, I just had a
problem were the script run successfully but should have failed.
Let's be on the safe side...

Also fix  "WARNING: term not in glossary: fqdn" and
"WARNING: unknown document: example-architectures".

This shows that the parallel building hit problems, otherwise this
would not show up now.

Change-Id: I5de3446aceb0ba6aa658b09987f7ee9d4b116229
2016-03-15 19:28:15 +01:00
KATO Tomoyuki
f6ce6bd328 Rename common-rst to common
Keep the sync target repo path "common-rst" as of now.

Change-Id: I552d2c0a422c4824632b11fa273629004b889306
2016-02-11 21:18:59 +09:00
Andreas Jaeger
ae4d97f9a5 Do not publish .buildinfo files
These build artefacts do not need to be published, remove them.

Change-Id: I92e575cd8dce7d2906a0c3b9869a52bb0e591812
2015-10-14 11:02:59 +02:00
Christian Berendt
63b0c3d638 Build in parallel with NUMBER_OF_CORES processes
Change-Id: Iffbdcd4fac12c2e39e3a887a2e7c4e32555d98bf
2015-10-14 12:33:52 +09:00
Andreas Jaeger
7e0d825a7d Do not publish doctrees
Currently we published the cached sphinx build data (13 MB for Install
Guides) to docs.openstack.org. This is not needed at all. Invoke
build_sphinx in such a way that .doctrees is not copied over.

Change-Id: I541e0259b896afb5d92d4d23153a7d0a27a419e6
2015-10-13 20:13:54 +00:00
Andreas Jaeger
0c8798bf2d Add linkcheck for RST
Check RST files for valid links.

This is a separte target for now to evaluate how useful it is.
Whitelist build.opensuse.org URL for user-guide.
Remove also checklang from default tox invocation since it's not needed
to run by default.

Change-Id: I6c275518b9e55ab3b6bcea52894ea851924bee94
2015-08-25 06:29:37 +02:00
Andreas Jaeger
5836662584 Silence RST building a bit
Remove -x from bash script, we do not need the invocation messages.
Only output sphinx-build invocation for easy reproduction.
Add -b html so that sphinx does not complain about missing builder.

Change-Id: Ic8199a5b7845636ddb72927a4f3c2bd8dc1b58a6
2015-08-23 19:44:20 +02:00
Andreas Jaeger
52bbdc220f [install-guide-rst] Set up conditionals for distros
Add support for conditionals for the Install Guide.

This uses the tags:
* rdo
* obs
* ubuntu

Note that this is changed from the spec since sphinx does not accept a
"-". Also, I changed from opensuse to suse for brevity.

Adds new tox target so that "tox -e install-guides" builds only the
RST Install Guide.

implements bp installguide-liberty

Change-Id: Ibdfbc7ff294e56f52cd6f4ef59ceeb7b6af3e28a
2015-06-17 20:37:05 +02:00
Andreas Jaeger
081c009b9e Fix publishing location of RST guides
Publish RST guides properly, we published them to e.g. user-guide/html/
instead of user-guide/. This is fixed with adding slashes to rsync so
that the first and the second parameter are equivalent.

Change-Id: Ie0842c19c45c5c99da3501303a453dd0920de74c
2015-05-16 20:19:04 +02:00
Andreas Jaeger
2dd2472967 Move RST Glossary to common-rst
Build glossary only once and put it into common-rst directory so that
all RST guides can use it.

Change-Id: I2d3acf25a3af48349b7c10b7e9fea86d5f16444e
2015-05-12 11:56:08 +02:00
Andreas Jaeger
94961a3c3a Simplify RST building
Use a script to build and copy RST guides around instead of duplicating
the same lines every time.

Use script in build-user-guides.sh for now. A follow-up patch shall
change further places.

This script will eventually be moved over to openstack-doc-tools, let's
first evolve it here and check that we cover all use cases.

Change-Id: I753e742bf77b2d6f5acf2f909d62af3dd422832a
2015-05-11 21:08:16 +02:00