To simplify publishing of the guide, we don't use the special directory
anymore, remove it for translated documents as well.
Change-Id: I0520314f4946736b78e9d7438d676739c741f7b1
Since api-quick-start publish location (api-guide/quick-start) is
different from standard scheme, we need to explicit PUBLISH_DIR
for translated api-quick-start documents.
Change-Id: I36d54d618a7ae0f32f5b8d86488b540f1be997c6
The new jobs pass different named variables, update the translation
script for this so that the debugging info contains the right
information about the build.
Change-Id: I3ba28b4149cabffa6e8ff2b194490a0d797e1ccb
The 'openstack-auto-commands' command has been superseded by the
'cliff.sphinxext' Sphinx extensions [1]. Remove both this and the helper
script in 'bin/doc-tools-update-cli-reference'.
[1] https://docs.openstack.org/cliff/latest/user/sphinxext.html
Change-Id: Ia20ace51377290997566b89ad4f78a941358cb86
We do not version the install-guide anymore, remove this setup from
doc-tools-check-languages.
Also, remove handling of config-reference, it does not exist anymore.
Remove handling of draft languages, we do not version any guides and
thus don't need this.
Change-Id: Ib9a231764b84eed015521c9a8b2397965760adab
Python-cinderclient does not use the latest Block Storage API.
As work around, we need to set OS_VOLUME_API_VERSION environment
variable explicitly so that we can generate all commands.
Change-Id: I5de94f1fd5e8a4068cb7209062588eb6ade73fc8
Closes-Bug: #1673425
Output the ZUUL_NEWREV variable as part of the root marker for better
debugging of published files.
Change-Id: I845053da6a9ce222e5f7150a9bbf3089c1cdb7cb
Use -xe for bash invocation so that log contains all commands executed
and any failure will abort the build.
Change-Id: Ic59515bec3ae7ea9cb1d2bd97e05d95e006eafb8
Do not give sphinx-build as single argument, split it up.
tox 2.5.0 currently complains that it cannot find "sphinx-build arg1
arg2" - so, pass this properly now.
Add releasenote for this.
Change-Id: I5da1d06866c16a8c56be23e87817d163b28803a8
This is needed for publishing in the future:
This is so that we can create a list of directories to ignore when we
rsync documentation builds to a publishing site. Some builds are
published as subdirectories underneath the results of superior
builds.
This allows those superior builds to be rsynced without removing the
other builds that were published under them.
http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html
Change-Id: Ic8773caebecafa87b10c1ad4612bde6b1513b667
Use a central TAGS variable for install-guide and use it everywhere. We
missed debian and debconf in one place and thus publish that translated
content in the wrong place.
Do the same change for first-app.
Change-Id: I2f9605f8632f746cb16b0a8ee241f68a311e2855
Sync install guide translation build tool with the
changes I8df6b3b382137d08d60f85bc41bcd98ac1f4eb47
and Iffced3907ac2fddd42e6adc56b6e4859fde8e987.
Change-Id: Ie3d20ab930738925f2daacd4cd305b4ad8ec1798
Since we finished common directory migration from common-rst
to common, this patch removes common directory switcher, that
is merged at the change I7ba517136807513f982e66010906b97621f844fc,
to migrate common directory for rst files from common-rst to common.
Change-Id: I40aac8ec2d497d83b41048b2576a3a0ab04c8a93
The DocBook XML glossary is gone, remove the special support in our
tools for it.
implements bp docbook-removal
Change-Id: Ida2bb926718ae7e03ac2ded120cea99c80147857
Bash variable expansion "${version##* }" doesn't match the char ")"
as "*". This patch add the process for "DeprecationWarning)" message.
Change-Id: If8e7dd047ea5e12487dc90f5a0fb7aeb4292ae13
Closes-Bug: #1565574
1.) This patch removes the Admin User Guide from the
Tools repository.
Change-Id: I97b180dff42893a9fa3d7872f73ed2935580d099
Implements: blueprint user-guides-reorganised
The RST Debian Install Guide is not maintained, there's no need to build
and publish it. We continue pushing strings to translate.openstack.org
but will not build it.
Change-Id: I2dddb437a693d91d8116cb3b5ee76e008429b0c0
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: I731de4def0a00e8f94c0d997d5bd66f5ec438e87
Co-Authored-By: Andreas Jaeger <aj@suse.com>
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...
Change-Id: I9ebebf33e2da0e71325b229c2261a22b07a06574
Shorten commit message to follow the git convention.
Change Git topic branch to unify all related topic.
Change-Id: I3a40ca5d7bb078fec20ad9fb7a5258f8fd1ae14c
To migrate common directory for rst files from common-rst to common,
Add a switcher for common directory as a temporary trick.
When find a rst file in common directory,
we use "common" directory as priority.
This switcher will be removed after all migration works finish.
Change-Id: I7ba517136807513f982e66010906b97621f844fc
The tuskar client has been retired, we do not need to document it anymore,
so remove all traces of it.
Change-Id: Ia12e1dcf6e147005e04da6ce07aefdbcd69750b6
To migrate CLI Reference from DockBook to RST,
output the documentation in RST format,
with a few work around for RST/Sphinx specific issue.
Change-Id: I32b4cfefa978436061d882f7520bbc92c1645b4e
Implements: blueprint cli-ref-rst