Also fix conf.py lint errors
etc/requirements.txt is hardcoded in rtd config
to support older builds I cannot change it
untill the next release
Issue-ID: CIMAN-33
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I27f1dcf32d226ea094b20ad275b318d07fa9648b
-# Formats in addition to HTML
+---
+# .readthedocs.yml
+# # Read the Docs configuration file
+# # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+# # Required
+#
+version: 2
-python:
- version: 3.7
- install:
- - requirements: docs/requirements-docs.txt
-
-# Build Container
+python:
+ version: 3.7
+ install:
+ - requirements: etc/requirements.txt
- configuration: docs/conf.py
+ configuration: docs/conf.py
+envlist = docs,
+# docs-linkcheck,
+
skipsdist = true
[testenv:docs]
basepython = python3
skipsdist = true
[testenv:docs]
basepython = python3
-deps = -r{toxinidir}/docs/requirements-docs.txt
+deps = -r{toxinidir}/etc/requirements.txt
commands =
sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
echo "Generated docs available in {toxinidir}/docs/_build/html"
commands =
sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
echo "Generated docs available in {toxinidir}/docs/_build/html"
[testenv:local]
basepython = python3
[testenv:local]
basepython = python3
-deps = -r{toxinidir}/docs/requirements-docs.txt
+deps = -r{toxinidir}/etc/requirements.txt
commands =
git submodule update --depth 100 --init
sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
commands =
git submodule update --depth 100 --init
sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
+[testenv:docs-linkcheck]
basepython = python3
deps = -r{toxinidir}/etc/requirements.txt
basepython = python3
deps = -r{toxinidir}/etc/requirements.txt
-commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck
+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
[testenv:spellcheck]
basepython = python3