Move doc related modules to doc/requirements.txt

Change-Id: Iedf201e211648452df29fa518c069ecf41a0acf3
This commit is contained in:
caoyuan 2019-07-06 02:15:13 +08:00
parent 3574210641
commit 3a8f29ed71
6 changed files with 25 additions and 8 deletions

2
.gitignore vendored
View File

@ -56,3 +56,5 @@ ChangeLog
# reno build
releasenotes/build
/doc/source/reference/api/
releasenotes/notes/reno.cache
RELEASENOTES.rst

9
doc/requirements.txt Normal file
View File

@ -0,0 +1,9 @@
# The order of packages is significant, because pip processes them in the order
# of appearance. Changing the order has an impact on the overall integration
# process, which may cause wedges in the gate later.
openstackdocstheme>=1.18.1 # Apache-2.0
sphinx!=1.6.6,!=1.6.7,>=1.6.2,<2.0.0;python_version=='2.7' # BSD
sphinx!=1.6.6,!=1.6.7,>=1.6.2;python_version>='3.4' # BSD
reno>=2.5.0 # Apache-2.0
sphinxcontrib-apidoc>=0.2.0 # BSD

View File

@ -22,6 +22,7 @@ sys.path.insert(0, os.path.abspath('../..'))
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = [
'sphinx.ext.autodoc',
'sphinxcontrib.apidoc',
#'sphinx.ext.intersphinx',
'openstackdocstheme'
]
@ -79,3 +80,7 @@ latex_documents = [
# Example configuration for intersphinx: refer to the Python standard library.
#intersphinx_mapping = {'http://docs.python.org/': None}
# -- sphinxcontrib.apidoc configuration --------------------------------------
apidoc_module_dir = '../../oslo_privsep'
apidoc_output_dir = 'reference/api'

View File

@ -5,4 +5,4 @@
.. toctree::
:maxdepth: 2
api/autoindex
api/modules

View File

@ -8,11 +8,5 @@ mock>=2.0.0 # BSD
fixtures>=3.0.0 # Apache-2.0/BSD
stestr>=2.0.0 # Apache-2.0
# These are needed for docs generation
openstackdocstheme>=1.18.1 # Apache-2.0
sphinx!=1.6.6,!=1.6.7,>=1.6.2,<2.0.0;python_version=='2.7' # BSD
sphinx!=1.6.6,!=1.6.7,>=1.6.2;python_version>='3.4' # BSD
reno>=2.5.0 # Apache-2.0
# Bandit security code scanner
bandit>=1.1.0,<1.6.0 # Apache-2.0

View File

@ -30,7 +30,14 @@ commands = {posargs}
[testenv:docs]
basepython = python3
commands = python setup.py build_sphinx
whitelist_externals =
rm
deps =
{[testenv]deps}
-r{toxinidir}/doc/requirements.txt
commands =
rm -rf doc/build
sphinx-build -W -b html doc/source doc/build/html
[testenv:cover]
basepython = python3