3

godoc -html只为一个包生成文档。但是，我想为项目提供所有包的所有文档，就像我运行godoc -http. 有了它，我可以找到所有包并从浏览器中浏览它们。

是否可以为通过链接在一起的所有包生成 HTML 页面godoc -html？

4

2 回答 2

1

您在这里有两个问题：

是否可以为通过 godoc -html 链接在一起的所有包生成 HTML 页面？

不，因为它没有在 godoc 中实现（https://godoc.org/golang.org/x/tools/cmd/godoc）。

另一个问题：

如何使用 godoc 为文件夹内的所有包生成 HTML 文档

我认为最简单的方法是使用 http 标志启动 godoc：godoc -http=:6060

然后导航到要获取文档的文件夹。对于该 url，您可以使用网络爬虫来获取 html 文档。如果您不想自己编写爬虫，Go 中已经有一些爬虫（https://godoc.org/?q=crawler ）。

于 2018-08-09T13:00:10.503 回答
0

我开发了Golds，这是一个替代的 Go 文档生成工具（和本地文档服务器/代码阅读器）。希望你这个工具能满足你的需要。

在您的项目目录下，您可以运行以下任何命令来为您的 Go 项目生成 HTML 文档：

  • golds -gen -nouses -plainsrc -wdpkgs-listing=promoted ./...
  • golds -gen -nouses -wdpkgs-listing=promoted ./...
  • golds -gen -wdpkgs-listing=提升 ./...

第一个命令生成最紧凑的文档，最后一个命令生成完整的文档，其大小是紧凑文档的 6 倍。

于 2020-09-15T16:59:21.517 回答