Merge pull request #74 from bgilbert/rtd

jcupitt · web-flow · commit 15166cf94f73 · 2023-10-14T14:30:32.000+01:00
doc: use a separate `requirements-rtd.txt` for Read the Docs
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -4,12 +4,13 @@ build:
   os: "ubuntu-22.04"
   apt_packages:
     - clang
+    - libclang-dev
   tools:
     python: "3.11"
 
 python:
   install:
-    - requirements: doc/requirements.txt
+    - requirements: doc/requirements-rtd.txt
 
 sphinx:
   configuration: doc/source/conf.py
diff --git a/doc/requirements-rtd.txt b/doc/requirements-rtd.txt
@@ -0,0 +1,6 @@
+# Read the Docs ignores the libclang package's embedded libclang.so for some
+# reason.  Use the clang package, pinned to a version matching Ubuntu 22.04.
+clang < 15
+hawkmoth
+sphinx
+sphinx_rtd_theme
