Commit Graph

10 Commits

Author SHA1 Message Date
Andreas Jaeger 37eb6d0d4a 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.

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: Iac415cd5bd7346847edeb174b059ffbc3e2a1bdf
2020-05-30 16:17:38 +02:00
Andreas Jaeger 7f2b19452f Cleanup py27 support and docs
Make a few cleanups:
- Remove obsolete sections from setup.cfg
- Remove install_command from tox.ini, the default
  is fine
- Switch to sphinx-build
- Enable warnings for doc build, fix all warnings
- Remove git handling from conf.py, openstackdocstheme does this now
- Cleanup tox.ini

Change-Id: I51796be20596afc2305c2d8ea189b4037bd28b2d
2020-04-09 21:25:44 +02:00
pengyuesheng 7b6075717b Blacklist sphinx 2.1.0 (autodoc bug)
See https://github.com/sphinx-doc/sphinx/issues/6440 for upstream details

Change-Id: I7675b45849a436d7968d212d7f6a2b373e9993fb
2019-09-25 17:35:15 +08:00
Douglas Mendizábal a978514892 Fix tox -e docs build
The docs target in tox was failing because it was still using
oslosphinx.  This patch replaces it with openstackdocstheme.

Change-Id: I4b6a93a306441f25d333889eaab3e9bbab3974c6
Story: 2005767
Task: 33481
2019-05-23 11:06:15 -05:00
Doug Hellmann a99aed18ba Add RSS feed
Publish an RSS feed of the changes to the specs repository to make the
specs more discoverable.

Change-Id: Ib4f84efab8b3af3ddd47d38d63a91362612bd655
2014-09-10 15:56:50 -04:00
Andreas Jaeger 6a5505f9ce Remove docutils pin
This was added to work around bug 1091333.  A new sphinx has been
released and so this is no longer necessary.

Change-Id: I9107884d964757a9154bdd1feb4ea6df4e9df43e
2014-08-27 12:29:17 +02:00
Steve Martinelli 7613e0c9b9 Update doc theme for barbican-specs
Update the theme used in the barbican-specs documentation to the
latest from oslosphinx. This will help create a more common look
and feel throughout specs.openstack.org.

Change-Id: I29157520915b0952ec650dcfc389667ceaf9b88a
2014-08-22 10:50:11 -04:00
Longgeek 294d6c7b52 Update pbr version
Change-Id: Id8b96261086c644bdae4a5fae85b3f777f31a99a
Closes-Bug: #1334810
2014-06-27 03:18:17 +08:00
Paul Kehrer fa05129991 switch to sphinx_rtd_theme 2014-06-02 17:43:03 -05:00
Jarret Raim e8717bcd92 First Pass at Doc Build 2014-05-19 20:56:54 -05:00