jupyterlite-sphinx icon indicating copy to clipboard operation
jupyterlite-sphinx copied to clipboard

Option to only rebuild html ?

Open Carreau opened this issue 1 year ago • 3 comments

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 ?

Carreau avatar Jan 31 '24 13:01 Carreau

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.

steppi avatar Jan 31 '24 18:01 steppi

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.

Carreau avatar Jul 22 '24 08:07 Carreau

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.

steppi avatar Jul 22 '24 14:07 steppi