Add apidoc stage to normal docs build process

docs/source/conf.py

@@ -43,13 +43,28 @@ release = '0.1.0'
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'sphinxcontrib.apidoc',
     'sphinx.ext.autodoc',
-    'sphinx.ext.apidoc',
     'sphinx.ext.todo',
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
 ]
 
+# Sphinxcontrib-apidoc settings
+# Add apidoc stage to normal build process
+
+apidoc_module_dir = '../../'
+apidoc_output_dir = 'apidoc'
+apidoc_excluded_paths = [
+    '**/migrations',
+    '**/tests/',
+    '**/tests.py',
+    '**/urls.py',
+    'manage.py',
+    'pedasi/wsgi.py',
+]
+apidoc_separate_modules = True
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -83,7 +98,7 @@ pygments_style = 'sphinx'
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

requirements.txt

@@ -29,6 +29,7 @@ mysqlclient==1.3.13
 networkx==2.2
 oauthlib==2.1.0
 packaging==17.1
+pbr==5.1.2
 prov==1.5.2
 pycparser==2.18
 Pygments==2.2.0
@@ -50,6 +51,8 @@ snowballstemmer==1.2.1
 social-auth-app-django==3.0.0
 social-auth-core==2.0.0
 Sphinx==1.7.6
+sphinx-rtd-theme==0.4.2
+sphinxcontrib-apidoc==0.3.0
 sphinxcontrib-websupport==1.1.0
 SQLAlchemy==1.2.14
 typed-ast==1.1.0