looks great and I managed to get it working; but the onboarding from the clerk-demo repo could be a little more straightforward. It could for example include an alias or user.clj that set it up to work. Also it looks like some of the notebook files don’t work out of the box; e.g. one of the examples includes jdbc, but it’s not in the deps.edn etc. Similarly some bits of the getting started snippet aren’t in the demo project; e.g. there’s no src directory. So you could perhaps integrate the getting started guide into the clerk demo repo??

I’m also curious how it relates to http://nextjournal.com

hey, there’s a user.clj here https://github.com/nextjournal/clerk-demo/tree/main/dev

ah cool — I missed it 🙂

all notebooks referenced there should run

working on fixing up the rest now

https://github.com/nextjournal/clerk-demo/commit/c5358a6a372df6f9e93f97e7274ce2d06f81b754

Looks great! How does this compare to https://github.com/scicloj/notespace? I haven't used much of either but their goals look very similar.

Yeah, I would like to know that too. I would appreciate it if https://nextjournal.com/mk/clerk-preview had a short section about the "syntax", i.e. what the comments rendered by Clerk look like, and a link to the API docs (with fns such as show! and the vl one). I am very happy to see this, thanks for open-sourcing!

Clerk does static analysis to build a dependency graph for each form and caches results between subsequent evaluations so it only recomputes things that changed. This allows it to eliminate hidden state issues and a fast feedback loop with file save events as the interface. I believe notespace takes a different approach here receiving commands via the repl on what to evaluate but maybe @U066L8B18 can say more?

besides there seems to be some differences regarding the format (markdown line comments in Clerk vs vectors of strings in Notespace) and the viewer api differs, compare https://github.com/scicloj/notespace/blob/master/test/notespace/v3_experiment1_test.clj with https://github.com/nextjournal/clerk-demo/blob/main/notebooks/viewer_api.clj

(btw the notebook format used by Clerk is from https://www.maria.cloud)

Thank you!

and I’ll add the viewer functions to the readme

(there’s currently html, vl, plotly, tex, table, md, code, with-viewer and with-viewers. https://github.com/nextjournal/clerk-demo/blob/main/notebooks/viewer_api.clj is the best reference until then

cool, I was about to report something similar to #45

Cool. I have already stumbled upon the cider hanging bug.