Haskell 如何使用Cabal生成Haddock文档？

我迷路了。我不知道如何与阴谋集团在本地生成文档。我想要的是阴谋集团安装gtk3，它也会生成文档。或者，如果这不起作用，如何在本地生成文档

我已经把它放进了cabal的.config文件中： --文件：真实

但是没有好的结局，找不到文件

我想这是一件很简单的事，我就是不明白

好的，在一些评论的帮助下，我得到了一些进一步的信息。无论如何，阴谋集团只是做了一个本地安装为我的用户，它给了我一个警告，全球是不推荐的。我找到了

我应该为全局安装等做些什么，但是如果我不使用它，我会收到关于不应该使用全局的警告，即使文档集设置为do documentation:True，我也不会得到haskell平台文档的更新

---

所以我不应该用阴谋集团来进行文件的全局安装

我相信您正在寻找

cabal haddock

或者如果您正在使用新命令，

cabal new haddock

。注意：

% cabal unpack gps
Unpacking to gps-1.2/
% cd gps-1.2
% cabal --help | grep document
  upload           Uploads source packages or documentation to Hackage.
  haddock          Generate Haddock HTML documentation.
  new-haddock      Build Haddock documentation
% cabal haddock
Resolving dependencies...
Configuring gps-1.2...
Preprocessing library for gps-1.2..
Running Haddock on library for gps-1.2..
... snip ...
Documentation created: dist/doc/html/gps/index.html
cabal haddock  3.42s user 1.00s system 92% cpu 4.784 total

---

我相信你正在寻找

cabal-haddock

或者如果你正在使用新命令，

cabal-new-haddock

。注意：

% cabal unpack gps
Unpacking to gps-1.2/
% cd gps-1.2
% cabal --help | grep document
  upload           Uploads source packages or documentation to Hackage.
  haddock          Generate Haddock HTML documentation.
  new-haddock      Build Haddock documentation
% cabal haddock
Resolving dependencies...
Configuring gps-1.2...
Preprocessing library for gps-1.2..
Running Haddock on library for gps-1.2..
... snip ...
Documentation created: dist/doc/html/gps/index.html
cabal haddock  3.42s user 1.00s system 92% cpu 4.784 total

---

这花了我一些时间，这里的一些帖子为我指明了正确的方向

一开始是我的错。我确实在文档中用True替换了False，但没有取消注释该行，因此默认情况下不生成文档（不能将其视为一个好的默认值-YMMV）

然后cabal在本地正常工作，有一个标志--global来更改它，或者您可以在~/.cabal/config中更改int

现在，文档中发生的事情如下所示。该文档在主目录中生成，但所有文档都链接到新的genarated index.html文件中。因此，您可以从全局安装和本地安装获得文档

现在我仍然没有得到一些东西。我不知道为什么阴谋集团不应该在全球范围内用于将所有的填充物安装到一个全球位置

---

是的，我偶然发现了堆栈、沙盒和新的xxxx（命令），我仍然不知道如何利用它们。。。。但我想这是另一个问题

我花了一些时间，这里的一些帖子为我指明了正确的方向

一开始是我的错。我确实在文档中用True替换了False，但没有取消注释该行，因此默认情况下不生成文档（不能将其视为一个好的默认值-YMMV）

然后cabal在本地正常工作，有一个标志--global来更改它，或者您可以在~/.cabal/config中更改int

现在，文档中发生的事情如下所示。该文档在主目录中生成，但所有文档都链接到新的genarated index.html文件中。因此，您可以从全局安装和本地安装获得文档

现在我仍然没有得到一些东西。我不知道为什么阴谋集团不应该在全球范围内用于将所有的填充物安装到一个全球位置

---

是的，我偶然发现了堆栈、沙盒和新的xxxx（命令），我仍然不知道如何利用它们。。。。但我想这是另一个问题

你在这里写的两个破折号包括在内了吗？这是配置文件中的注释语法，因此您添加的内容可能会被愉快地忽略。你想要的

documentation:True

没有两个破折号。是的-，我看到了错误请，在4.9k的代表中，你应该知道如何更好地格式化一个SO问题，不是吗？你是否包括了你在这里写的两个破折号？这是配置文件中的注释语法，因此您添加的内容可能会被愉快地忽略。你想要的

documentation:True

没有两个破折号。是的-，我看到了这个错误请，在4.9k的代表中，你应该知道如何更好地格式化一个SO问题，不是吗？这至少对我有一点帮助，我现在已经开始生成文档了。但无论如何，谢谢我学到了一些东西…现在我尝试了你的建议：阴谋集团解包GTK3这至少帮了我一点忙，现在我正在尝试生成文档。但无论如何，谢谢我学到了一些东西…现在我试着用你的建议来试试运气：cabal unpack GTK3为什么在全球范围内安装文档似乎比在主目录中安装文档更好？你真的打算在同一台机器上与其他用户共享这些文档吗？（这是一种不太常见的情况，而且更危险，因为它需要根权限，这两个因素共同促使默认值在本地安装。）我认为如果有人能看到文档是很好的，但最终我可以接受本地安装的东西，因为我是唯一对它感兴趣的编程人员。。。如果我想拥有更多的程序员，我应该使用什么？为什么每个人都必须为自己安装Haskell开发工具？如果你计划与其他开发人员共享软件包，那么在全球范围内安装软件包和文档是有意义的。但我们必须谨慎行事；阴谋集团的地狱是真实存在的，全局安装加剧了症状和治疗。为什么在您看来全局安装文档比在主目录中安装文档更好？你真的打算在同一台机器上与其他用户共享这些文档吗？（这是一种不太常见的情况，而且更危险，因为它需要根权限，这两个因素共同促使默认值在本地安装。）我认为如果有人能看到文档是很好的，但最终我可以接受本地安装的东西，因为我是唯一对它感兴趣的编程人员。。。如果我想拥有更多的程序员，我应该使用什么？为什么每个人都必须为自己安装Haskell开发工具？如果你计划与其他开发人员共享软件包，那么在全球范围内安装软件包和文档是有意义的。但我们必须谨慎行事；