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.
Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.
Disable openstackdocs_auto_name to use 'project' variable as name.
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.
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: Iab669aaf569600fa87da8404663bbbbde0be14d6
This repo is now testing only with Python 3, so let's make
a few cleanups:
- Remove python 2.7 stanza from setup.py
- Update requirements, no need for python_version anymore
- Use newer openstackdocstheme version
- Use hacking 3.0
Change-Id: Idefb3435a6b2b0765781fb6458c2def5a5e38a1d
Some options are now automatically configured by the version 1.20:
- project
- html_last_updated_fmt
- latex_engine
- latex_elements
- version
- release.
Change-Id: I37a1af868c189c30cc9aa9ee4ca78786ad82d547
This follows the instructions [1] in an attempt to build pdf docs.
This creates workable results, but there is room for improvement.
[1] https://etherpad.openstack.org/p/train-pdf-support-goal
Change-Id: Icf7c22bf9d1de6fb2a74a756c370930d4c00b0b9
Story: 2006110
Task: 35395
Sync sphinx dependency with global requirements. It caps python 2 since
sphinx 2.0 no longer supports Python 2.7.
Change-Id: I7410ad173a84b30562a1cdad743553dbd432f729
The cookiecutter template includes more documentation than we
need, so remove lots of extraneous stuff and lay in the basics.
Change-Id: I6ed22f70153b00844e8de05d186ecc780debc48c
songwenping