Haddock 似乎错误地对 UTF-8 编码源文件中的文档中的非 ASCII 字符进行了重新编码。我经常需要在文档中包含数学公式,如果可以使用一些常见的数学符号(例如求和 (Σ)),它们的可读性会更高。
但是,通过 haddock 运行文件后,这些符号变成空白方 block 。
Haddock 有选项 --use-unicode
但它只是将函数签名等中的函数箭头转换为 unicode 字符,同时仍然破坏实际文档。
如果可以通过 cabal haddock
进行控制那就更好了!
我使用的是 Haddock 版本 2.9.4。
最佳答案
请注意,Haddock 使用 GHC API 进行解析。 GHC < 7.4 无法正确处理注释中的非 ASCII 字符,但在 GHC 7.4 中似乎可以正常工作。
关于haskell - Haddock 文档中使用 unicode 字符,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/9519385/