Improve build-docs toxenv spec
@@ -68,13 +68,17 @@ changedir = docs
# https://github.com/jaraco/rst.linker/issues/7
# And once all other warnings are gone.
commands =
- python -m sphinx \
- -a -n -j auto \
- -b html --color \
+ {envpython} -m sphinx \
+ -a \
+ -j auto \
+ -b html \
+ --color \
+ -n \
-d "{toxinidir}/build/html_docs_doctree" \
- . "{toxinidir}/build/html"
+ . \
+ "{toxinidir}/build/html"
# Print out the output docs dir and a way to serve html:
- python -c \
- 'import pathlib; '\
- 'docs_dir = pathlib.Path(r"{toxinidir}") / "build" / "html"; index_file = docs_dir / "index.html"; print(f"\nDocumentation available under `file://\{index_file\}`\n\nTo serve docs, use `python3 -m http.server --directory \{docs_dir\} 0`\n")'
+ -{envpython} -c \
+ 'import pathlib; docs_dir = pathlib.Path(r"{toxinidir}") / "build" / "html"; index_file = docs_dir / "index.html"; '\
+ 'print("\n" + "=" * 120 + f"\n\nDocumentation available under `file://\{index_file\}`\n\nTo serve docs, use `python3 -m http.server --directory \{docs_dir\} 0`\n\n" + "=" * 120)'
