评论中的 Haskell Haddock latex 方程

Question

我想在我的源代码中对方程式使用 latex 表示法。
例如，我会在一些 haskell 源文件 Equations.hs 中写下以下注释:

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

在 doc目录，这由 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 方程？

Answer 1

不。这个(和类似的特性)不存在的主要原因是不清楚如何处理其他后端中的标记，无论是 HTML 标记、Hoogle 标记还是其他人可能正在使用的标记。这是相当普遍的要求，但没有共同的协议(protocol)，更重要的是，没有补丁。

从技术上讲，我们不支持 LaTeX 后端，它一直在编译以便可以生成 Haskell 报告。如果您或其他人想给它一些新的生命(和功能)，那么我们很乐意接受补丁。

tl;博士:不能。我知道人们只是简单地预渲染 LaTeX 并使用图像语法插入生成的图像。