在评论中使用Haskell Haddock LaTeX方程式

Question

我希望在我的源代码中使用LaTeX符号表示方程式。例如，我想在Haskell源文件Equations.hs中编写以下注释：

-- | $v = \frac{dx}{dt}$

在 doc 目录中，这将由 Haddock 渲染为 Equations.tex 中的形式：

{\char '44}v = frac{\char '173}dx{\char '175}{\char '173}dt{\char '175}{\char '44}

我在Haddock的latex后端源代码中发现了这个函数，它替换了许多用于latex格式化的字符：

latexMunge :: Char -> String -> String
...
latexMunge '$'  s = "{\\char '44}" ++ s

有没有现成的功能可以让我绕过这个问题，在评论中插入latex公式？

- Maarten

Answer 1

不行。这种（以及类似的）功能不存在的主要原因是不清楚如何处理其他后端中的标记，无论是HTML、Hoogle还是其他人可能使用的任何其他东西。尽管经常有人提出这个问题，但没有共识，更重要的是没有补丁。

从技术上讲，我们不支持LaTeX后端，它仅保留编译，以便可以生成Haskell报告。如果您或其他人想要给它一些新的生命（和特性），那么我们将很乐意接受补丁。

简而言之：不能实现。我知道人们只需预渲染LaTeX并使用图像语法插入结果图像。

- Mateusz Kowalczyk

---

请注意，自此回答以来，已经添加了MathJax支持，它将通过您的浏览器呈现LaTeX。 - Mateusz Kowalczyk