32fec8a9bc
To do this we drop the build_sphinx setup.py target as that is unusable with modern setuptools. Instead call sphinx directly in the tox docs target. Next we drop blockdiag and comment out the single blockdiag diagram as this plugin was never updated to work with modern Pillow (there is an argument mismatch and docs fail to build). Then we swap out the openstack docs theme and use the rtd docs theme. With added toctree captions this renders a nice navigation window (if a bit long vertically). Finally we do some small s/OpenStack/OpenDev/ updates but there is going to be much more to do later. Mostly I wanted to get this into a place where it builds and doesn't look completely wrong at first glance. Change-Id: Ieace28443258322ead25275f47fc6c9fbd23865f
27 lines
553 B
INI
27 lines
553 B
INI
[tox]
|
|
minversion = 1.6
|
|
envlist = docs
|
|
skipsdist = True
|
|
|
|
[testenv]
|
|
basepython = python3
|
|
usedevelop = True
|
|
install_command = pip install -U {opts} {packages}
|
|
setenv =
|
|
VIRTUAL_ENV={envdir}
|
|
deps = -r{toxinidir}/requirements.txt
|
|
-r{toxinidir}/test-requirements.txt
|
|
|
|
[testenv:venv]
|
|
commands = {posargs}
|
|
|
|
[testenv:docs]
|
|
commands = sphinx-build -W -E -b html doc/source doc/build/html
|
|
|
|
[testenv:spelling]
|
|
deps =
|
|
-r{toxinidir}/requirements.txt
|
|
sphinxcontrib-spelling
|
|
PyEnchant
|
|
commands = sphinx-build -b spelling doc/source doc/build/spelling
|