Add tox env to generate documentation 37/72137/1
authorVictor Morales <victor.morales@intel.com>
Wed, 7 Nov 2018 23:30:06 +0000 (15:30 -0800)
committerVictor Morales <victor.morales@intel.com>
Wed, 7 Nov 2018 23:33:05 +0000 (15:33 -0800)
The process to generate HTML documentation can be automated with
tox. This chage covers the basics instructions. In order to test this
is necessary to have python tox module and run the following command
in the multivimbroker folder

$ tox -e docs

Change-Id: I9540f6234a85e4775a482efd9dda9da1ec615591
Signed-off-by: Victor Morales <victor.morales@intel.com>
Issue-ID: DOC-300

.gitignore
docs/conf.py [new file with mode: 0644]
multivimbroker/tox.ini

index a5beebe..06b9462 100644 (file)
@@ -13,3 +13,6 @@ multivimbroker/.coverage
 multivimbroker/.tox/
 multivimbroker/logs/*.log
 multivimbroker/test-reports/
+
+# Docs related
+docs/html
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644 (file)
index 0000000..bab9649
--- /dev/null
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+ROOT = os.path.abspath(os.path.join(BASE_DIR, "..", ".."))
+
+sys.path.insert(0, ROOT)
+sys.path.insert(0, BASE_DIR)
+
+# -- General configuration ----------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    #'sphinx.ext.intersphinx'
+]
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'MultiCloud Framework'
index af3b3a5..1e54370 100644 (file)
@@ -32,3 +32,7 @@ deps = rstcheck
 whitelist_externals = bash
 commands = bash -c "find ../docs -not -path {toxinidir}/.tox/\* \
    -name \*.rst -type f -print0 | xargs -0 rstcheck --report warning"
+
+[testenv:docs]
+deps = sphinx
+commands = sphinx-build -b html ../docs/ ../docs/html

© 2017 ONAP. Copyright © The Linux Foundation ®. All Rights Reserved.
The Linux Foundation has registered trademarks and uses trademarks.
For a list of trademarks of The Linux Foundation, please see our Trademark Usage page.
Linux is a registered trademark of Linus Torvalds.
Privacy Policy and Terms of Use