This looks quite geared towards generating the specific kind of interactive HTML book they show off. I guess that's because it's Sphinx under the hood. Looks useful for a specific kind of task!<p>Jupyter has a built-in templating system based on Pandoc (nbconvert) which is actually quite powerful. I have used it to generate print-ready documents via LaTeX templates.<p>For longer documents, one can use Pandoc JSON as an intermediary format, which can be assembled together before being output as LaTeX/PDF. For this one has to add a build tool like Make and not just the nbconvert command.<p>My biggest issue is that the nbconvert stuff is generally very hard to discover. It has very limited documentation which is further harmed by the considerable churn in the templating system, how they are discovered and how to plug them in to Jupyter lab. I suspect most people try "Export->PDF", see an ugly result with no obvious way to change it and give up. It's unfortunate because it's really a very powerful system under the hood.<p>Generating a paper or a technical note -- complete with beautiful typeset maths and figures -- from a computational document is really nice. Being able to take some data, generate a plot, calculate some values and put those values into prose such that the prose and the plot and the data are never out of sync is great! To me it's the next step up from having a referencing system so your references and bibliography are never out of sync.
We evaluated Jupyter Book against Read the Docs when building our new docs site (<a href="https://arcdocs.leeds.ac.uk/" rel="nofollow">https://arcdocs.leeds.ac.uk/</a>), the main reason we favoured Jupyter Book was that its easier to build and test locally and being able to use GitHub actions to build the html without relying on and being at the mercy of another third party service.
<a href="https://quarto.org/" rel="nofollow">https://quarto.org/</a> is also a good, and appears to be more flexible system, that I was recently recommended!
I wrote an intro to APL as a jupyterbook and found it an excellent tool for the job <a href="https://xpqz.github.io/learnapl" rel="nofollow">https://xpqz.github.io/learnapl</a>
Looks quite good. Reminds me of the R Bookdown project (<a href="https://bookdown.org/" rel="nofollow">https://bookdown.org/</a>).
<a href="https://executablebooks.org/en/latest/gallery.html" rel="nofollow">https://executablebooks.org/en/latest/gallery.html</a> has samples, looks great, reminds me of gitbook but better
We use jupyterbook (geographicdata.science/book), and it has seriously simplified our workflow. The project is building useful features very quickly, and is very responsive to feedback & requests. Big props to their team.
At some point last years I was fascinated with the jupyter ecosystem and was looking into something that could help making data analytic apps quick but not so dirty. Jupyter is the data side of thing, but the app side deviates so much from a standard web stack (react or web component) that it leaves much to be desired.
Has anyone made a note-taking tool (like notion/obsidian/logseq) that builds off of a computational notebook tool (like jupyter/observable/starboard)?<p>Mainly just needs wiki style links and backlinks and a search function.
The general navigation / structure seems similar to ...<p>LEARN theme applied to a HUGO blog<p><a href="https://themes.gohugo.io/themes/hugo-theme-learn/" rel="nofollow">https://themes.gohugo.io/themes/hugo-theme-learn/</a><p>Or is this a more common pattern that is implemented multiple ways?<p>Is there a simple worklfow to convert Markdown documents to a Hugo or JupyterBook site. I want to build some simple step-wise guides or workshop in this format -- and want to spend most of my time on content and less on the publishing tools and pipeline. Any advise appreciated -Thanks!
Looking into this for a course I'm putting together, but it executes all the notebooks to build the html which is a bit of a deal-breaker when downloading/training large DL models.
How does Jupyter ecosystem compare to traditional content management systems. Do people find it easier to customize with nbconvert? Does it play nicely with other web frameworks like Gatsby?
Note: you can create jupyter book with C# or F#<p><a href="https://github.com/dotnet/interactive" rel="nofollow">https://github.com/dotnet/interactive</a>
As shameless self promotion, if you’re interested in writing computational lessons for a course, check out Pathbird (pathbird.com), a SaaS product for creating guided computational lessons (targeted mostly towards university faculty right now but feel free to reach out if you’re interested).<p>We took a lot of inspiration from Jupyter Book (and use Jupyter kernels under the hood), so nothing but respect for all things Jupyter.