Haskell Haddock乳胶方程式在评论中

Question

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

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

在doc目录中,这将由Equations.tex中的haddock呈现为:

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

我在Haddock的乳胶后端的源代码中找到了这个函数,它取代了乳胶格式化中使用的许多字符:

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

是否有任何现有的功能允许我绕过这个并在评论中插入乳胶方程式？

Answer 1

不。这一功能（以及类似功能）不存在的主要原因是，不清楚如何处理其他后端中的标记，无论是 HTML 后端、Hoogle 后端还是其他人可能使用的其他后端。这是相当普遍的要求，但没有达成共识，更重要的是，没有补丁。

从技术上讲，我们不支持 LaTeX 后端，它会一直进行编译，以便生成 Haskell 报告。如果您或其他人想要赋予它一些新的生命（和功能），那么我们将很乐意接受补丁。

tl;dr：无能为力。我知道人们只是简单地预渲染 LaTeX 并使用图像语法插入生成的图像。