ci: add '--color' to workflow 'docs'

.github/workflows/docs.yml

@@ -22,7 +22,7 @@ jobs:
         pip install -U pip --progress-bar off
         pip install -U virtualenv tox --progress-bar off
     - name: build docs
-      run: tox -e py37-docs
+      run: tox -e py37-docs -- --color
     - name: 'publish site to gh-pages'
       if: github.event_name != 'pull_request' && github.repository == 'VUnit/vunit'
       env:

tools/build_docs.py

@@ -11,6 +11,7 @@
 from subprocess import check_call
 from os.path import join, dirname
 import sys
+from sys import argv
 from create_release_notes import create_release_notes
 from docs_utils import examples
 
@@ -25,16 +26,12 @@ def main():
         [
             sys.executable,
             "-m",
-            "sphinx",
-            "-T",
-            "-E",
-            "-W",
-            "-a",
-            "-n",
-            "-b",
+            "sphinx"
+        ] + ([] if len(argv) < 2 else argv[2:]) + [
+            "-TEWanb",
             "html",
             join(dirname(__file__), "..", "docs"),
-            sys.argv[1],
+            argv[1],
         ]
     )
 

tox.ini

@@ -27,6 +27,6 @@ commands=
     fmt:         {envpython} -m black ./ --exclude 'vunit\/vhdl\/JSON-for-VHDL|\.eggs|\.git|\.hg|\.mypy_cache|\.nox|\.tox|\.venv|_build|buck-out|build|dist' {posargs}
     unit:        {envpython} -m pytest -v -ra tests/unit {posargs}
     lint:        {envpython} -m pytest -v -ra tests/lint {posargs}
-    docs:        {envpython} tools/build_docs.py {envtmpdir}/docsbuild
+    docs:        {envpython} tools/build_docs.py {envtmpdir}/docsbuild {posargs}
     acceptance:  {envpython} -m pytest -v -ra tests/acceptance {posargs}
     vcomponents: {envpython} vunit/vhdl/verification_components/run.py --clean