Haddock似乎错误地重新编码了UTF-8编码源文件的文档中的非ASCII字符。我经常需要在文档中包含数学公式,如果可以使用诸如求和(Σ)之类的常见数学符号,它们更易读。
但是,在通过haddock运行文件后,这些符号变为空白方块。
Haddock有选项--use-unicode
,但只是将函数签名等中的函数箭头转换为unicode字符,同时仍然打破了实际的文档。
如果可以从cabal haddock
控制,那就更好了!
我正在使用Haddock版本2.9.4。
答案 0 :(得分:8)
请注意,Haddock使用GHC API进行解析。评论中的非ASCII字符由GHC<处理不正确。 7.4,但似乎用GHC 7.4它可以正常工作。
答案 1 :(得分:3)
如果不能使用UTF-8,并且∑
或∑
等数字字符引用(这些是n元求和符号Σ的正确引用)被认为是不可读的,那么我害怕唯一的选择是使用∑
之类的命名引用,如果它们通过HTML结果并且将被使用的浏览器支持。
这是一个很大的“如果”,因为新的HTML5实体支持相当有限,但可能在内部网中,每个人都使用Firefox ...... HTML5实体: http://www.whatwg.org/specs/web-apps/current-work/multipage/named-character-references.html
(并且大部分参考文献都不像∑
那样。)