Clojurians Log v2
cljdoc
Would it be out of scope to get cljdoc to support https://mermaid.js.org/ similar to https://github.blog/2022-02-14-include-diagrams-markdown-files-mermaid/? I’ve recently fallen in love with ’em… 🙂
I think it is worth considering @suomi.esko. A while back we added https://cljdoc.org/d/org.cljdoc/cljdoc-exerciser/1.0.90/doc/document-tests/asciidoctor-features#_math, it feels kinda sorta like in that realm of features. Anybody else out there want mermaid support in cljdoc?
ooooh mermaid looks fun!
It does, doesn't it? We'd have to take precautions like GitHub has and not allow interactivity.
whoops, I guess cljdoc doesn’t support [this style][target-url] of markdown link: https://cljdoc.org/d/org.mentat/mathbox.cljs/0.1.0/doc/readme
Have taken a peek, seems related to image links only. It might be a bug in flexmark-java which use to render GitHub Flavoured Markdown. Not sure, have asked them about it here: https://github.com/vsch/flexmark-java/issues/551
@sritchie09 huh, didn't know that was an accepted markdown link syntax.
The common syntax is described https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#links.
Hmm! TIL. Reference links.
I can take a peek @sritchie09... I think we should probably support this syntax.
Raised an issue: https://github.com/cljdoc/cljdoc/issues/743, will take a peek sometime soonish.
For the curious, this indeed is valid: https://spec.commonmark.org/0.30/#link-label
Thanks @suomi.esko!
is that only a github thing?