4 回答

TA貢獻(xiàn)1827條經(jīng)驗(yàn) 獲得超8個(gè)贊
即使使用 godoc,是否有一種規(guī)范的方法來(lái)生成供離線使用的文檔?
Go 1.12(2019 年 2 月)對(duì)此更清楚:
godoc
和go doc
在 Go 1.12 中,
godoc
不再有命令行界面,只是一個(gè) Web 服務(wù)器。
用戶應(yīng)該改用go doc
命令行幫助輸出。
go doc
現(xiàn)在支持-all
flag,這將導(dǎo)致它打印所有導(dǎo)出的 API 及其文檔,就像以前的godoc
命令行一樣。
cmd/doc
: 添加-all
標(biāo)志以打印包的所有文檔與舊的不同
godoc
,您需要-u
標(biāo)志才能看到未導(dǎo)出的符號(hào)。
這似乎是正確的行為:它是一致的。

TA貢獻(xiàn)1712條經(jīng)驗(yàn) 獲得超3個(gè)贊
我一直在努力做到這一點(diǎn),最后,對(duì)我有用的是
確保你安裝了“wget”(我使用的是 mac,所以必須使用 x-code 安裝它)
以 root 用戶身份登錄并修改名為“robots.txt”的文件以刪除“Disallow : /”行,因?yàn)檫@會(huì)阻止 wget 遞歸下載站點(diǎn)?!皉obots.txt”文件應(yīng)該在 $GOROOT 路徑中。
打開(kāi) cmd 并使用以下命令啟動(dòng) godocs 服務(wù)器
godoc -http=:6060
我將我的本地路徑配置到這個(gè)端口。
打開(kāi)另一個(gè) cmd 并運(yùn)行以下命令。
wget -r -np -N -E -p -k http://localhost:6060/pkg/myproject
您可以提及項(xiàng)目的路徑,以便為整個(gè)項(xiàng)目下載 html 文檔。

TA貢獻(xiàn)1850條經(jīng)驗(yàn) 獲得超11個(gè)贊
您可以嘗試Golds,這是一個(gè)備用的 Go 文檔生成工具(和一個(gè)本地文檔服務(wù)器/代碼閱讀器)。
在您的項(xiàng)目目錄下,您可以運(yùn)行以下任何命令為您的 Go 項(xiàng)目生成 HTML 文檔:
golds -gen -nouses -plainsrc -wdpkgs-listing=promoted ./...
golds -gen -nouses -wdpkgs-listing=promoted ./...
golds -gen -wdpkgs-listing=提升./...
第一個(gè)命令生成最緊湊的文檔,最后一個(gè)命令生成完整文檔,其大小是緊湊文檔的 6 倍。

TA貢獻(xiàn)1871條經(jīng)驗(yàn) 獲得超13個(gè)贊
這也可以使用簡(jiǎn)單的wget命令來(lái)實(shí)現(xiàn)。
我對(duì)此有類似的問(wèn)題。我正在為我的項(xiàng)目使用 GitLab,我決定為 Go 項(xiàng)目創(chuàng)建并共享一些方便的 GitLab CI YAML 模板,這些模板將自動(dòng)生成靜態(tài) HTML Go 文檔,無(wú)需任何外部包:https:?//gitlab.com/tymonx/ gitlab-ci
示例:Go Logger 文檔
兩個(gè)不錯(cuò)的功能:
嵌入式 Go 源代碼文件
搜索框引用了 GitLab
- 4 回答
- 0 關(guān)注
- 195 瀏覽
添加回答
舉報(bào)