Patch: Docs Dev Env Fix

.readthedocs.yml

@@ -1,5 +1,9 @@
 version: 2
 
+formats:
+    - pdf
+    - epub
+
 build:
     os: ubuntu-24.04
     tools:
@@ -8,9 +12,15 @@ build:
     jobs:
         build:
             html:
-                - python -m pip install -r docs/requirements.txt
                 - cd docs && npm ci
                 - cd docs && python scripts/sphinx_to_starlight.py
                 - cd docs && npm run build:astro
                 - mkdir -p $READTHEDOCS_OUTPUT/html
                 - cp -r docs/dist/* $READTHEDOCS_OUTPUT/html/
+
+sphinx:
+    configuration: docs/conf.py
+
+python:
+    install:
+        - requirements: docs/requirements.txt

conda-reqs/docs.yaml

@@ -22,3 +22,9 @@ dependencies:
     - sphinx-autobuild
     - sphinx_rtd_theme
     - docutils
+    - requests
+
+    # Install Node.js outside conda to avoid conflicting with the ICU version
+    # required by Chipyard's toolchain. fnm reads docs/.nvmrc and installs an
+    # official Node.js binary that does not use conda's ICU package.
+    - fnm

docs/.nvmrc

@@ -0,0 +1 @@
+22

docs/README.md

@@ -12,7 +12,10 @@ Node dependencies:
 
 ```sh
 source env.sh
+python -m pip install -r docs/requirements.txt
 cd docs
+eval "$(fnm env --shell bash)"
+fnm install --use
 npm ci
 npm run dev
 ```
@@ -25,8 +28,10 @@ The active environment must include the Python/Sphinx dependencies from either
 `requirements.txt` or `../conda-reqs/docs.yaml`, because the Starlight build
 starts by rendering the RST source with Sphinx. Read the Docs installs
 `requirements.txt` with pip to avoid a slow conda solve, while local development
-can use the docs conda environment. Node.js is provided separately by Read the
-Docs via `.readthedocs.yml`, or by any local Node installation on `PATH`.
+can use the docs conda environment. That environment provides `fnm`, which
+installs the Node.js version selected by `.nvmrc` outside conda to avoid a
+toolchain ICU conflict. Read the Docs provides Node.js separately through
+`.readthedocs.yml`.
 
 Build static docs:
 

docs/package.json

@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@astrojs/starlight": "0.41.3",
-    "astro": "7.0.7"
+    "astro": "^7.1.3"
   },
   "devDependencies": {
     "chokidar": "5.0.0"