search

kozross / hotteok

The next generation in Haskell documentation
1 stars 0 forks source link

AsciiMath vs. LaTeX #4

Open kozross opened 3 years ago

kozross commented 3 years ago

LaTeX is a complex beast, and rendering it is no mean feat (even Pandoc basically gives up and outsources it). Having it be supported in the 'new-style' documentation comments is probably unnecessary as well, since most people only want a small amount of functionality LaTeX actually offers.

AsciiMath seems to offer some reasonably pleasant syntax for basically everything folks would want from LaTeX in a documentation generator, and embedding it (as well as natively rendering) is quite easy. Should we use this instead?

Kleidukos commented 3 years ago

Sounds like a more lightweight alternative, indeed.

kozross commented 3 years ago

@Kleidukos I also think it would benefit the ecosystem to have a library able to deal with AsciiMath. Currently, all the AsciiMath implementations are JavaScript.

Kleidukos commented 3 years ago

Yep', this would certainly help its adoption in our ecosystem.

kozross commented 3 years ago

That's a fairly soft toss actually. I could throw that together pretty quickly. We can have Hotteok become a 'meta-package' with a cabal.project, with asciimath as one of the packages. It can also be compatible with older GHCs.