在Haddock文档中使用unicode字符

时间:2012-03-01 15:54:01

标签: haskell unicode haddock

Haddock似乎错误地重新编码了UTF-8编码源文件的文档中的非ASCII字符。我经常需要在文档中包含数学公式,如果可以使用诸如求和(Σ)之类的常见数学符号,它们更易读。

但是,在通过haddock运行文件后,这些符号变为空白方块。 Haddock有选项--use-unicode,但只是将函数签名等中的函数箭头转换为unicode字符,同时仍然打破了实际的文档。

如果可以从cabal haddock控制,那就更好了!

我正在使用Haddock版本2.9.4。

2 个答案:

答案 0 :(得分:8)

请注意,Haddock使用GHC API进行解析。评论中的非ASCII字符由GHC<处理不正确。 7.4,但似乎用GHC 7.4它可以正常工作。

答案 1 :(得分:3)

如果不能使用UTF-8,并且∑&­#x2211;等数字字符引用(这些是n元求和符号Σ的正确引用)被认为是不可读的,那么我害怕唯一的选择是使用∑之类的命名引用,如果它们通过HTML结果并且将被使用的浏览器支持。

这是一个很大的“如果”,因为新的HTML5实体支持相当有限,但可能在内部网中,每个人都使用Firefox ...... HTML5实体: http://www.whatwg.org/specs/web-apps/current-work/multipage/named-character-references.html

(并且大部分参考文献都不像∑那样。)