Conversation
kadler
commented
Sep 14, 2026
- Update readthedocs to use Ubuntu 26.04, Python 3.13, and Node 26
- Use uv to keep doc packages in sync
- Update doc packages
cd6a31b to
5dcc4c4
Compare
|
Looks like there was error with building the docs: https://app.readthedocs.org/projects/nodejs-itoolkit/builds/34554133/ |
|
It appears that this is an issue with the asdf version manager that RTD uses: It adds a comment to the jsdoc script shim but Node.js only supports Here's how sphinx-js calls jsdoc: https://github.com/pyodide/sphinx-js/blob/master/sphinx_js/jsdoc.py#L280-L285 Looks like it's calling it with |
|
Ok, looks like the way asdf shims it, it creates it as a bash script: https://github.com/asdf-vm/asdf/blob/master/internal/shims/shims.go#L454 So sphinx-js is trying to call this bash script as if it was JS. Unfortunately sphinx-js doesn't seem to have a bypass for this, so I'm going to try creating a JS script for it to use which calls the bash script. |
- Update readthedocs to use Ubuntu 26.04, Python 3.13, and Node 26 - Use uv to keep doc packages in sync - Update doc packages - Add jsdoc wrapper script to work around pyodide/sphinx-js#316
89739f7 to
656d3e3
Compare