4 ms·
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 us
by heisenzombie 5y ago
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!
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.
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.
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.
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.
- zzleeper 5y agoWhat worked for me is using Python scripts ("filters") that do all required changes on the Pandoc JSON. I even ended up writing a pythonic layer on top of that JSON ("pip install panflute") so I wouldn't have to deal with the JSON itself.