summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorcaoyuan <cao.yuan@99cloud.net>2019-07-06 01:51:52 +0800
committercaoyuan <cao.yuan@99cloud.net>2019-07-06 18:38:54 +0800
commit530bbea2ee40b39b1dc1d7c43fd99aadade22de5 (patch)
tree67a8564857a72e1ed4ec73d228e022a66948a952 /doc
parent2fe652067b8572b48a926f2fb647d6bf2911a8ab (diff)
downloadoslo-policy-530bbea2ee40b39b1dc1d7c43fd99aadade22de5.tar.gz
Move doc related modules to doc/requirements.txt
Change-Id: I2f12fb5058984c1fc6beda4d13f934dd9b218218
Diffstat (limited to 'doc')
-rw-r--r--doc/requirements.txt10
-rw-r--r--doc/source/conf.py5
-rw-r--r--doc/source/reference/index.rst2
3 files changed, 16 insertions, 1 deletions
diff --git a/doc/requirements.txt b/doc/requirements.txt
new file mode 100644
index 0000000..c843563
--- /dev/null
+++ b/doc/requirements.txt
@@ -0,0 +1,10 @@
+# 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.5,<2.0.0;python_version=='2.7' # BSD
+sphinx!=1.6.6,!=1.6.7,>=1.6.5;python_version>='3.4' # BSD
+sphinxcontrib-apidoc>=0.2.0 # BSD
+
+reno>=2.5.0 # Apache-2.0
diff --git a/doc/source/conf.py b/doc/source/conf.py
index f7d542a..0a9e203 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -23,6 +23,7 @@ sys.path.insert(0, os.path.abspath('../..'))
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.extlinks',
+ 'sphinxcontrib.apidoc',
#'sphinx.ext.intersphinx',
'openstackdocstheme',
'oslo_config.sphinxext',
@@ -95,3 +96,7 @@ extlinks = {
# Example configuration for intersphinx: refer to the Python standard library.
#intersphinx_mapping = {'http://docs.python.org/': None}
+
+# -- sphinxcontrib.apidoc configuration --------------------------------------
+apidoc_module_dir = '../../oslo_policy'
+apidoc_output_dir = 'reference/api'
diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst
index a345d32..6284450 100644
--- a/doc/source/reference/index.rst
+++ b/doc/source/reference/index.rst
@@ -4,5 +4,5 @@
.. toctree::
- api/autoindex
+ api/modules