modify readthedocs.yaml

Now that the yaml file is actually being read
we need to tell read the docs to do the submodule dance.

also, I added another tox.ini
in the docs dir, this is for rtdv3 builds
the one in root will be removed once we are
ready to retire the old method of docs building

Issue-ID: CIMAN-33
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I5e4866c5a1d68a16d8d027f8c4ec7397ea3d3c59

1 files changed, 44 insertions, 0 deletions

diff --git a/docs/tox.ini b/docs/tox.ini
new file mode 100644
index 000000000..9d8bf531a
--- /dev/null
+++ b/docs/tox.ini
@@ -0,0 +1,44 @@
+[tox]
+minversion = 1.6
+envlist = docs,
+#         docs-linkcheck,
+
+skipsdist = true
+
+[testenv:docs]
+basepython = python3
+deps = -r{toxinidir}/../etc/requirements.txt
+commands =
+    sphinx-build -b html -n -d {envtmpdir}/doctrees ./ {toxinidir}/_build/html
+    echo "Generated docs available in {toxinidir}/docs/_build/html"
+whitelist_externals =
+    echo
+    git
+    sh
+
+[testenv:local]
+basepython = python3
+deps = -r{toxinidir}/../etc/requirements.txt
+commands =
+    git submodule update --depth 100 --init
+    sphinx-build -b html -n -d {envtmpdir}/doctrees ./ {toxinidir}/_build/html
+    echo "Generated docs available in {toxinidir}/_build/html"
+whitelist_externals =
+    echo
+    git
+
+[testenv:docs-linkcheck]
+basepython = python3
+deps = -r{toxinidir}/../etc/requirements.txt
+commands = echo "Link Checking not enforced"
+#commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck
+whitelist_externals =
+    echo
+
+[testenv:spellcheck]
+basepython = python3
+deps =
+    -r{toxinidir}/../etc/requirements.txt
+    sphinxcontrib-spelling
+commands = 
+    sphinx-build -b spelling -Dextensions=sphinxcontrib.spelling -Dspelling_word_list_filename=validwords.txt -d {envtmpdir}/doctrees ./ {toxinidir}/_build/spellcheck