pbr 1.10 is broken with Sphinx 1.5 [1]. We've somehow avoided any
issues, likely because we don't restrict ourselves to 1.10, but we
should make the version number explicit.
[1] https://bugs.launchpad.net/pbr/+bug/1379998
Change-Id: If3dbb6f2131530bcaddc96ca419ce56d2fb2d50a
Related-Bug: #1379998
A stated goal from the Atlanta PTG this week was to use reno for our
release notes from Pike onwards. This requires reno to support
configurable sections, which have been added by:
https://review.openstack.org/#/c/436639
Once this is merged into reno, this commit configures openstack-manuals
so that reno will work with it, and a build of releasenotes/ will
automatically include a reno-generated report via reno's sphinx
extension.
Depends-on: I914572c6a07ca81c54965b4b5a6b6aba50b3a787
Change-Id: Id029f462fb553b3429629b90585e2790734f1bb9
Update requirements to current Sphinx version. Don't auto-upgrade to
next major version.
Fix one lexing issue.
Change-Id: I6e4164661a8b21cc6251176afe8020df8a914011
Sync licenses with global-requirements.
Add Babel for translations.
Update versions for our tools.
Increase hacking version as in global-requirements.
Change-Id: Ie09303f1d3f5246c8b3628e2f4a362251da63505
Adds a Newton watermark to the Install Guides,
Networking Guide, and Config Ref Guide.
Change-Id: I0e4f2942b87d996e9f2fd419f808578636d07e78
Backport: mitaka liberty
Partial-bug: #1479166
Require the new release and remove openstack-doc-test from
checkniceness, this was only needed for docbook XML files.
The command does not exist anymore.
Change-Id: I88c39f3c85935300c0377c028997f5009969b373
The problem has been fixed with newer oslo.config 3.6.0 release.
This reverts commit df116c9e35fbc58b080e48d4a97b71d6892b665b.
Change-Id: Iacc52fe47850fd40cd258bf0caee2f1eae191334
Since we're not part of global-requirements sync, do a manual sync.
This updates Jinja to newer version as well as normalizes the entries.
Change-Id: If41108d7831c7913b8203b5ffdbc9a9bdd3a148e
As discussed via email, let's do this on a smaller scale.
This reverts commit 9432a6da0cc341a879bc6f4ac48380248355e77a.
Change-Id: I27e9cd06c5d69917abe452e873873683e10c282a
Require new version and cleanup conf.py, we do no need pwd variable
anymore.
Update pbr and hacking requirement - syncing with global requirements.
Change-Id: I53a222445967092e08a1b598a19e8bbe71e378a6
The Japanese translations have been imported, build the guide.
This needs openstack-doc-tools 0.30 or newer, bump the requirement.
Change-Id: I5b55aed7db9e83ce9a0f5057ab9567ee62a391ca
openstack-doc-tools 0.28 contains a fix for translation of RST guides
and the User Guides. Require that version and enable the User Guides for
translation.
Add building of glossary for translation environments to tox.ini.
Change-Id: I645bf98b68603811a9a978e508d1f492e44da738
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
Build translated RST manuals. This needs openstack-doc-tools 0.26
release, thus bumped up requirements.
Import also Japanese User Guides translations so that this can be
tested. We only create an empty file for it, this will trigger the
import and enable us testing of the toolchain.
Ignore some build results.
Change-Id: Ic51974445730cbfa886beb7cfd4fcf71977dab3c
Require openstack-doc-tools 0.25. This allows us to remove the content
directory for RST checkbuild.
Change-Id: Iffbdbb312c4e74902aec3cd4ebbfb5e4a4d83a76
Enable doc8 but disable D000 (RST validation) and
D001 test (overlong lines). This also disables
all the problems we had in the past with doc8 checking, the current
files pass doc8 after fixing a few minor problems (part of change).
This basically tests for whitespace.
Change-Id: I648ac7f78b3a31f3b1434dc7d7d0b887ce4d5128
- We're not at a point where the value proposition in consistent markup is
worth the pain in troubleshooting.
- Plus I think the current checks aren't sophisticated enough to replace humans.
Change-Id: Idb4e4acaf6b274024853847aa1d77324e251349f
Patch was originally trying to use python setup.py build_sphinx to build the RST guides.
Thinking it'd give us better debugging info. But now translation needs a /source subdir.
Change-Id: I5e4f85846301bb14fcd9fb1445b08a0d34d16cae
oslosphinx must remain because the Hot template guide uses it.
Depends-On: I19ac7e4caab879217cb3024157e3ddd231f5189d
Change-Id: Ib5e68c17aba85823bca74387ee144fd961da15ff
Use new doc-tools-check-languages script and add configuration file for
it. Remove the now obsolete tools/test-languages.sh.
Adjust checkbuild target so that generated index pages can be reviewed
easily.
Change-Id: I28462fb19e5f999c298e7d8cc2cc7dda41f35929
The 2 RST files are copied from the heat developer documentation without
any change and are just a starting point.
This patch requires this change in the openstack-doc-tools:
https://review.openstack.org/#/c/108034/
Change-Id: I03511655c86ead880cadfa68b43bb2b90d3f7c06
Implements: blueprint heat-templates