Merge pull request #274 from humitos/build-readthedocs

Build on Read the Docs

.readthedocs.yaml

@@ -0,0 +1,17 @@
+version: 2
+
+build:
+  os: "ubuntu-20.04"
+  tools:
+    python: "3.10"
+    nodejs: "14"
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - doc

docs/conf.py

@@ -4,6 +4,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 import os
+import subprocess
 import sys
 
 # add the demo python code to the path, so that it can be used to demonstrate
@@ -87,3 +88,13 @@
         "</a>!"
     )
 }
+
+# Generate JS/CSS assets before running Sphinx on Read the Docs
+if os.environ.get("READTHEDOCS") == "True":
+    subprocess.run(
+        [
+            "npx",
+            "gulp",
+            "build",
+        ]
+    )