search

danielfrg / mkdocs-jupyter

Use Jupyter Notebook in mkdocs
https://mkdocs-jupyter.danielfrg.com
Apache License 2.0
362 stars 45 forks source link

Consider using Jupyter Cache #161

Open betolink opened 11 months ago

betolink commented 11 months ago

I saw a closed issue that describes more or less what I'm running into, I usually need to modify a small part of a notebook and it would be great if mkdocs-jupyter could use a cache to only re-render the parts that changed.

https://jupyter-cache.readthedocs.io/en/latest/#

Would it be possible? Thanks for the library btw!

danielfrg commented 11 months ago

Interesting, i didn't knew about the lib.

Definitely something I want to support, in my mind just checking the modified date and skipping a notebook would be so great to have. It's easy but need to find time to do it.

fdeheeger commented 11 months ago

Same sort of interest here ; Cache would help but there could be something else...

I am building a documentation with a quite large number of notebooks (moving from nbsphinx to mkdocs). I am experiencing a significant time to build the documentation (like way too much). By reducing that number to a manageable one, I have noticed that when the notebook contains a significant number of images, the building process increases a lot (well.. on my machine ;o) ). I am not yet sure why (conversion time ? process of the converted document by mkdocs ?). When I am converting notebook to markdown with nbconvert directly, mkdocs is building the site quite easily (but I am losing other options of the mkdocs-jupyter extension) ; so I am not sure where the time goes...

Any hint ?

danielfrg commented 11 months ago

Not sure but agree that cache is something we need to work on.