Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems
Update Sphinx version as well.
Change pygments_style to 'native' since old theme version always
used 'native' and the theme now respects the setting and using 'sphinx'
can lead to some strange rendering.
Remove docs requirements from lower-constraints, they are not
needed during install or test but only for docs building.
openstackdocstheme renames some variables, so follow the
renames before the next release removes them. A couple of variables
are also not needed anymore, remove them.
See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html
Change-Id: Ic5ff4981e5ed09885fd2aaad7508d58d2b2cccc7
Remove build_sphinx from setup.cfg, it's not used anymore since this
repo uses sphinx-build directly.
Require newer openstackdocstheme version and remove settings in conf.py
that are now default.
Remove doc/source/install/conf.py, it is not used anymore.
Change-Id: Id89c664384c3ad443d701f5d4135a9f3f9f744d7
Error message in CI job build-openstack-api-ref:
The config value `html_last_updated_fmt' has type `bytes'; expected
`str'.
Change-Id: Ie760abeb4a3ea8666da25480a8461812a67514eb
Currently, Trove api-ref is not configured with logABug feature.
When users click "Report bug" button, it leads to
"bugs.launchpad.net/openstack-manuals" which is default.
We should change it to "bugs.launchpad.net/trove/".
Change-Id: I90b37c3ef6b73daf2e05f253b9778ce548a38a1c
With this email[0], you must migrate API reference docs into RST. The
conf.py and the tox environment are also cribbed from nova.
Still need to retain the install_command in tox.ini, otherwise the
api-ref job fails.
[0] http://lists.openstack.org/pipermail/openstack-dev/2016-May/093765.html
Co-Authored-By: Anne Gentle <agentle@cisco.com>
Co-Authored-By: Amrith Kumar <amrith@tesora.com>
Change-Id: I3315261aa18729fa7a6aa79d4a1d6c24de1e2c6b
