为什么 cabal haddock --hyperlink-source 不生成源 HTML？

Question

对于一个 cabal 项目，我想生成带有源代码超链接的黑线鳕文档，所以我照常做了：

cabal haddock --hyperlink-source

链接已生成，但点击链接后我发现实际的源代码并未包含在内，尽管链接包含在内。源代码应该通过 HTML 呈现。我如何生成这些？

---

目前正在使用：

• 阴谋集团 1.22.4.0
• cabal 安装 1.22.6.0
• 黑线鳕 2.16.1

Answer 1

原来是因为没有安装hscolour。通过以下方式安装：

cabal install hscolour

已解决问题。

有趣的是，是一个警告说

Warning: The program 'hscolour' version >=1.8 is required but it could not be found.

但它被埋在了通常的黑线鳕输出中，所以直到现在我才注意到它。