cljdoc

https://cljdoc.org/ & https://github.com/cljdoc/cljdoc
Sam Ritchie 2020-12-17T13:07:41.173800Z

@martinklepsch that would be great, for linking to issues pages, Slack page links etc from the sidebar

Sam Ritchie 2020-12-17T13:07:52.174100Z

another Q for y’all - is there any facility now for rendering LaTeX in cljdocs?

martinklepsch 2020-12-17T13:29:10.174200Z

Unfortunately not. Maybe we could support it via some Asciidoc extension though… :thinking_face: cc @dominicm

martinklepsch 2020-12-17T13:29:58.174400Z

Yeah, makes perfect sense. Do you want to open an issue or maybe even a PR? If you’re generally down I’m happy to provide some pointers

Sam Ritchie 2020-12-17T15:59:33.174600Z

one official one: https://github.com/asciidoctor/asciidoctor-latex

Sam Ritchie 2020-12-17T16:00:19.174900Z

and this looks less official, but another option: https://github.com/cirosantilli/asciidoctor-katex-2

Sam Ritchie 2020-12-17T16:01:23.175200Z

but more peppy: > Besides those however, it the extension is already working pretty well, and if those points were implemented, we would have, I believe, the best HTML ath typesetting system created so far, opening the way to destroy LaTeX and world domination.

😂 1
Sam Ritchie 2020-12-17T16:01:24.175400Z

from https://github.com/asciidoctor/asciidoctor/pull/3338

dominicm 2020-12-17T18:08:18.175800Z

Not ported to asciidoctorj unfortunately. I've no experience with JRuby directly.

dominicm 2020-12-17T18:09:09.176Z

Doesn't asciidoctorj support mathjax?

Sam Ritchie 2020-12-17T19:08:04.176500Z

looks like there’s an asciimath extension

Sam Ritchie 2020-12-17T19:08:29.176700Z

though that just handles emitting properly escaped \$…

Sam Ritchie 2020-12-17T19:09:01.176900Z

yeah, it is more just about adding a flag to embed mathjax on the cljdoc page

Sam Ritchie 2020-12-17T19:09:38.177100Z

<script>
window.MathJax = {
  loader: {load: ['[tex]/physics']},
  tex: {
    tags: 'ams',
    processEscapes: true,
    inlineMath: {'[+]': [['$', '$']]},
    packages: {'[+]': ['physics']}
  }
};
</script>
<script type="text/javascript" id="MathJax-script" async
  src="<https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js>"&gt;
&lt;/script&gt;

Sam Ritchie 2020-12-17T19:09:41.177300Z

something like this

Sam Ritchie 2020-12-17T20:26:07.177500Z

https://github.com/cljdoc/cljdoc/issues/433

Sam Ritchie 2020-12-17T20:26:22.177800Z

I don’t have the bandwidth to do this now, unfortunately, but here’s an issue placeholder

Sam Ritchie 2020-12-17T20:29:51.178Z

https://github.com/cljdoc/cljdoc/issues/434

Sam Ritchie 2020-12-17T20:29:57.178300Z

made an issue in case this is an attractive idea!