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
Previously common-rst.pot is additive only and
deleted strings in the source document will remain forever.
This commit make generatepot-rst.sh not reuse existing
common-rst.pot and generate the POT file from scratch.
This patch creates an index rst file which includes all
files under common-rst and generate common-rst.pot.
By doing so, all contents of common-rst can be covered.
Closes-Bug: #1507138
Change-Id: I888f37ad5e14a0e1cc7d182e376acaf63f98e565
The guide has no common directory, therefore we have no common
translation. Handle this in our script.
Change-Id: If140cd8ebe893eedebd2a5f883210309380220e7
Depends-On: Id34b92430ef4da804335714710547ada02c23cef
Enhance file so that it can be used by other documentation repos as
well.
Update invocation of it.
Change-Id: I93a6d8ccb8c314c0961b87a239462183712cdd26
Keeping the order of strings same as in the original source document
helps translators find the sources and they can translate by checking
rendered contents :-)
Note that Zanata keeps the order of strings in uploaded POT files.
Change-Id: I3ecd0516047050b94e8eba902620a4f40dc8fd36
Closes-Bug: #1503266
To ease translation, translate common-rst in a separate po file.
Since we reuse the file in all RST guides, this needs special handling.
common-rst.pot is empty for now, we need the file so that the tools
work.
Change-Id: I9972e6222d4018b238da9b2b8f4e93e6ebc9e224
Co-Authored-By: KATO Tomoyuki <kato.tomoyuki@jp.fujitsu.com>
These tags are now completely unused, remove them from scripts setting
them.
Now we can simplify publishdocs.sh with a simple loop instead of
separate invocations.
Remove our scope sphinx extensions, it's not needed anymore.
Remove also the hot extension from the Admin User Guide, it's only used
in the End User Guide.
Change-Id: Ib6c9f35e336ee13b84030a6e7164dea27d621e67
Separate User Guides cleanly, there's little benefit in having them in
one directory and it causes quite some strange sphinx challenges.
Temporarily disable translation of the guides since first a new release
of openstack-doc-tools is needed.
Partial implements bp reorganise-user-guides
Change-Id: I9e41bb67397c5bc26c1940f67387f3e42a9c5cbc
Ubuntu uses mawk by default which does not know about the regex feature
"{32}". Use "+" instead for a more portable regex.
Change-Id: I9fd52437eb332dedc9bf977173beda93f984843f
Automatically convert the glossary from DocBook XML to RST with each
build and use it for building the RST guides.
Add the glossary to User Guides and Networking Guide.
Use glossary in User Guides in places where it was used before. This
removes one TODO.
Fix CORS capitalization.
Partial-Bug: #1421813
Change-Id: I3fba6d54b01759f39f8e1467a7606cdbd2dd0165
We do not need the UUIDs for our toolchain, remove them.
They cause huge changes with each import with no benefit for us.
Note: Sphinx 1.3 by default disables UUID generation but we're using an
older Sphinx version for building, thus have to do this manually.
Change-Id: I3f3e910c5b2a2d03a3f04b67015526c3b7e77ddb
Building should not handle our tags, thus set *all* tags at once so that
all files get included in the po files.
Change-Id: I061988451543caea926cc60a3517203fc1807298
Fix generatepot-rst.sh script to not generate duplicate messages and
properly delete generated files.
Let git ignore any python compiled files.
Change-Id: Ib0cb58980ba2bc751cfed9ad56942aedfb62d07e
Set locale_dirs in conf.py to support translated documents building.
Add a config variable SPECIAL_BOOKS to list documents in RST format.
Add new generatepot-rst tox environment to generate all pot file,
invoke using "tox -e generatepot-rst -- playground-user-guide".
Add new script to generate the pot files.
Co-Authored-By: Andreas Jaeger <aj@suse.de>
Change-Id: I3124cf65b254c1c5aefce59447bb94240d96a742