search

jupyterlite / jupyterlite-sphinx

Sphinx extension using JupyterLite to render Notebooks
https://jupyterlite-sphinx.readthedocs.io/en/latest
BSD 3-Clause "New" or "Revised" License
67 stars 21 forks source link

Option to only rebuild html ? #132

Open Carreau opened 8 months ago

Carreau commented 8 months ago

I was iterating on the css and most of the time I would be ok with sphinx not rebuilding the notebooks, iframe and jupyterlite environement, would there be a way to do so ? Would it be useful ?

steppi commented 8 months ago

What I do is just update the css in the build directory of the deployed documentation in order to test out little tweaks like that. As I see it, the css in the source directory specifies default values which can be changed at run time.

Carreau commented 2 months ago

Similar to #51, though #51 might be complicated to get the caching propoer. Here I'm thinking of an explicit option where you know you don't care and just want to rebuild the html.

steppi commented 2 months ago

Similar to #51, though #51 might be complicated to get the caching propoer. Here I'm thinking of an explicit option where you know you don't care and just want to rebuild the html.

I see, so the idea is that we wouldn't check if any examples sections with the directive have changed, and just keep the old, possibly out of sync, notebooks? I don't know enough to be sure how difficult it will be, but it sounds reasonable as long as it's documented that users need to ensure on their own that no examples sections have changed.