haskell - 将包上传到hackages时没有生成黑线鳕

Question

在我将我的包上传到 hackages 后，它并没有像其他包那样生成黑线鳕。

我错过了什么？

我所做的是：

1. cabal dist以及在 dist 目录下生成的包。
2. 打开hackage web上传界面，上传包。
3. 打开网址，发现包上传成功，但没有黑线鳕。（该软件包确实有一些文档）

谢谢你。

Answer 1

生成文档需要一点时间。我相信他们在格林威治标准时间午夜运行。

Answer 2

除了 Thomas 的回答之外，cabal haddock在您的包目录中运行并查找任何错误。

根据我的经验，黑线鳕非常挑剔，尤其是 wrt。代码块。如果您遇到解析错误，请开始删除评论，直到可以生成文档。我通常使用一些广泛记录的包作为参考。

Answer 3

看起来文档丢失了，因为您的包没有正确构建。我在构建日志的末尾发现了这个：

src/Network/OAuth2/HTTP/HttpClient.hs:18:8:
    Could not find module `Control.Monad.Trans.Resource'
    It is a member of the hidden package `resourcet-0.3.2.1'.
    Perhaps you need to add `resourcet' to the build-depends in your .cabal file.
    Use -v to see a list of the files searched for.

为避免此类问题，请确保在上传之前使用 Cabal在本地构建您的包。直接使用 GHC 构建通常会掩盖这些问题，因为它会愉快地使用您安装的任何软件包，无论您是否在.cabal文件中提到它们。