haskell - 如何默认制作 cabal-dev 构建文档

Question

我经常在无法访问互联网的地方工作。我也即将搬到一个互联网接入最少的地方。在我的系统上本地保存文档对我来说绝对是无价的。

使用直接 cabal，我只需在配置文件中启用 documentation 选项即可做到这一点。

如何使用 cabal-dev 获得相同的效果？具体来说，当我使用 cabal-dev 安装软件包时，我希望生成软件包文档，并更新项目文档目录的 index.html 文件以包含该软件包。

更新:我的问题基本上是 documentation for cabal-install configuration file 的重复

Answer 1

编辑~/.cabal/share/cabal-dev-$VERSION/admin/cabal-config.in并将documentation字段的值设置为正确。 cabal-config.in 文件是一个模板，用于在创建新沙箱时初始化 cabal-dev/cabal.config。

如果您想为现有的 cabal-dev 沙箱启用文档，只需编辑 cabal-dev/cabal.config。

<小时/>

对于 Cabal 原生沙箱的用户:要么在 ~/.cabal/config 中启用文档，要么在您的 的同一目录中创建一个文件 cabal.config >cabal.sandbox.config 包含以下内容:

documentation: True