Commit Graph

5 Commits

Author SHA1 Message Date
Andreas Jaeger ebb9fe8aa4 Switch to newer openstackdocstheme and reno versions
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: Idae29b3be9edde2038711d537668514bb2c34946
2020-05-21 20:24:51 +02:00
Andreas Jaeger 9ce57f3f39 Cleanup py27 support
This repo is now testing only with Python 3, so let's make
a few cleanups:
- Remove obsolete sections from setup.cfg
- Remove babel.cfg, this is not needed here at all
- Update requirements, no need for python_version anymore
- Switch to using sphinx-build
- Use newer openstackdocstheme and Sphinx versions
- Cleanup */source/conf.py to remove now obsolete content.
- Remove install_command from tox.ini, the default is fine
- Use TOX_CONSTRAINTS_FILE, UPPER_CONSTRAINTS_FILE is obsolete

Change-Id: If3228ad42346d6f405e0c6b6580ecd48a7511525
2020-05-09 16:45:25 +02:00
zhurong f86902fcc5 PDF documentation build
Change-Id: Id488e9e0643876363894641dc4bd62b56c4ce488
2019-09-17 22:52:43 -07:00
zhurong 9d558be065 switch to openstackdocstheme
Also fix warnings

Change-Id: I0ffd8140ec98233b54dacb045989c976e03db355
2017-07-07 15:54:45 +03:00
sslypushenko 0a97def364 Commit project structure
Based on cookiecutter project template

Change-Id: Iabedcc77d1d915fcee4769e1bb67db69d375b6cb
2016-08-22 16:46:38 +03:00