私は小さなgoプログラムを作成しましたが、godocサーバーなしで表示できるソースコードからスタンドアロンのHTMLドキュメントを生成したいと思います。しかし、私はそれを達成する方法を見つけることができません。誰かが私を助けることができれば、私はそれを感謝します。
4 に答える
少し良い形は、次の方法で作成できます。
godoc -url "http://localhost:6060/pkg/container/heap/" > page.html
(私はgodocサーバーを:6060で実行していますが、それが前提条件であるかどうかはわかりません)。
生成されたHTMLファイルを適切に参照するように調整することにより、Goリポジトリにある元のCSSスタイルと組み合わせると、HTMLの見栄えが良くなる可能性があります。
これはあなたの質問に直接答えないかもしれませんが、プロジェクトをオープンソース化することを計画している場合、実際には手動でHTMLを生成する必要はありません。ソースコードにコメントが正しく挿入されていることを確認し、godoc.org(http://godoc.org/-/about)を使用して処理してください。
Bitbucket、Github、Launchpad、GoogleProjectHostingのGoパッケージのドキュメントが表示されます。
たとえば、これをチェックしてください:http: //godoc.org/code.google.com/p/go.crypto/ssh
サーバーを実行し、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
(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の作者です。このツールがあなたのニーズを満たすことを願っています。