haskell - 评论中的 Haskell Haddock 乳胶方程

Question

我想在我的源代码中对方程式使用乳胶表示法。例如，我会在一些 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 的乳胶后端的源代码中找到了这个函数，它替换了乳胶格式中使用的许多字符：

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

是否有任何现有功能可以让我绕过这个并在评论中插入乳胶方程？

score 3 · Accepted Answer

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

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

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

1 回答 1