Switch to openstackdocstheme 2.2.1 version. Using
this version 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.
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: I9843c6b66d4411857cb19c5d176d39b200423257
Since then the jenkins job of gate-manila-specs-docs-ubuntu-xenial
always failed. Let's set sphinx version to !=1.6.1,>=1.5.1 to fix
the failure in test-requirements. As the same as manila project does.
https://review.openstack.org/#/c/465263/2/test-requirements.txt.
Partial-Bug: #1691622
Change-Id: Ic411bb789deaf3b71c4b94d465dd673d6f5cfd5e
and its family of diagrams [1]: blockdiag, actdiag, seqdiag,
and nwdiag.
These enable block, sequence, activity, and logical network
diagrams, defined in a simple text format, and with this patch
can be easily embedded in our specs. For examples, see [2].
[1] http://blockdiag.com
[2] https://specs.openstack.org/openstack/neutron-specs/specs/juno-incubator/example.html
Change-Id: I999d8f5211266c4ce6d991ff92fe73e3843b5596
so that we can run 'tox' locally and properly validate our spec
docs.
* Update tox minversion and requirements
* Clean out build directory before new docs build
* Run doc8 validation
* Fix numerous incidental errors in the specs and templates
so that doc8 now passes
* Setup both py35 and py27 environments
* Turn off yasfb extension until it can work with python 3
Change-Id: I722a9ad852cdfa0974322fbe29db37956dab3ee0