65

私は小さなgoプログラムを作成しましたが、godocサーバーなしで表示できるソースコードからスタンドアロンのHTMLドキュメントを生成したいと思います。しかし、私はそれを達成する方法を見つけることができません。誰かが私を助けることができれば、私はそれを感謝します。

4

4 に答える 4

47

少し良い形は、次の方法で作成できます。

godoc -url "http://localhost:6060/pkg/container/heap/" > page.html 

(私はgodocサーバーを:6060で実行していますが、それが前提条件であるかどうかはわかりません)。

生成されたHTMLファイルを適切に参照するように調整することにより、Goリポジトリにある元のCSSスタイルと組み合わせると、HTMLの見栄えが良くなる可能性があります。

于 2012-11-23T13:42:43.690 に答える
16

これはあなたの質問に直接答えないかもしれませんが、プロジェクトをオープンソース化することを計画している場合、実際には手動でHTMLを生成する必要はありません。ソースコードにコメントが正しく挿入されていることを確認し、godoc.org(http://godoc.org/-/about)を使用して処理してください。

Bitbucket、Github、Launchpad、GoogleProjectHostingのGoパッケージのドキュメントが表示されます。

たとえば、これをチェックしてください:http: //godoc.org/code.google.com/p/go.crypto/ssh

于 2012-11-23T17:46:56.380 に答える
8

サーバーを実行し、wgetで取得します

godoc -http=:6060

起動するのを待ちます(アプリの「container / heap /」):

wget -p -k http://localhost:6060/pkg/container/heap/

私が使用するすべてのドキュメントをダウンロードするには、次のようにします。

wget -m -k -q -erobots=off --no-host-directories --no-use-server-timestamps http://localhost:6060
于 2019-04-30T18:18:15.420 に答える
0

https://stackoverflow.com/a/63905155/3715832から移動)

別のドキュメントスタイルを試したい場合は、代替のGoドキュメント生成ツール(およびローカルドキュメントサーバー/コードリーダー)であるGoldsを試すことができます。

プロジェクトディレクトリで、次のコマンドのいずれかを実行して、GoプロジェクトのHTMLドキュメントを生成できます。

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

最初のコマンドは最もコンパクトなドキュメントを生成し、最後のコマンドは完全なドキュメントを生成します。このサイズはコンパクトなドキュメントの6倍です。

ところで、私はGoldsの作者です。このツールがあなたのニーズを満たすことを願っています。

于 2020-09-15T16:03:17.117 に答える