Add python/tox config for documentation

Change-Id: I755b1fbce971d0df5fb4d4508ae3beb5f6a286b2
Signed-off-by: Lott, Christopher (cl778h) <cl778h@att.com>

diff --git a/.gitignore b/.gitignore
index 175c380..27ad92d 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -46,3 +46,6 @@
 
 # OSx cruft
 **/.DS_Store
+
+# documentation
+.tox

diff --git a/docs/.gitignore b/docs/.gitignore
index 651cf82..89d0765 100644 (file)
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,2 +1,2 @@
-/conf.py
+/_build
 /out

diff --git a/docs/_static/logo.png b/docs/_static/logo.png
new file mode 100644 (file)
index 0000000..c3b6ce5
Binary files /dev/null and b/docs/_static/logo.png differ

diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644 (file)
index 0000000..4651a2b
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1 @@
+from docs_conf import *

diff --git a/docs/conf.yaml b/docs/conf.yaml
new file mode 100644 (file)
index 0000000..02f362d
--- /dev/null
+++ b/docs/conf.yaml
@@ -0,0 +1,3 @@
+---
+project_cfg: lfdocs
+project: portal-ric-dashboard

diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644 (file)
index 0000000..00b0fd0
Binary files /dev/null and b/docs/favicon.ico differ

diff --git a/tox.ini b/tox.ini
new file mode 100644 (file)
index 0000000..96d6ff8
--- /dev/null
+++ b/tox.ini
@@ -0,0 +1,26 @@
+# documentation only
+[tox]
+minversion = 2.0
+envlist =
+    docs,
+    docs-linkcheck,
+skipsdist = true
+
+[testenv:docs]
+basepython = python3
+deps = 
+    sphinx
+    sphinx-rtd-theme
+    sphinxcontrib-httpdomain
+    recommonmark
+    lfdocs-conf
+    
+commands =
+    sphinx-build -W -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
+    echo "Generated docs available in {toxinidir}/docs/_build/html"
+whitelist_externals = echo
+
+[testenv:docs-linkcheck]
+basepython = python3
+deps = sphinx
+commands = sphinx-build -W -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck