docs: Work around readthedocs/readthedocs-docker-images#107

readthedocs Docker containers have too old a Node.js version, but we can
install a newer one with Conda.

Author: tavianator

.readthedocs.yml

@@ -6,11 +6,7 @@ version: 2
 sphinx:
   configuration: docs/conf.py
 
-formats: all
+conda:
+  environment: docs/environment.yml
 
-python:
-  version: 3.7
-  install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: ./python
+formats: all

docs/environment.yml

@@ -0,0 +1,15 @@
+name: bistring
+channels:
+  - defaults
+dependencies:
+  - nodejs
+  - pip
+  - pip:
+    - sphinx
+    - sphinx_autodoc_typehints
+    - sphinx_rtd_theme
+    # Need fixes for https://github.com/mozilla/sphinx-js/issues/90,
+    # https://github.com/mozilla/sphinx-js/issues/105,
+    # https://github.com/mozilla/sphinx-js/issues/110
+    - "git+https://github.com/tavianator/sphinx-js@d2e98fb07c8d2efe46820f1ab07a677244dc4dce#egg=sphinx-js"
+    - regex