💻

Pythonのドキュメント生成システムのpdocを使ってみた

2021/11/17に公開

ドキュメントの自動生成といえばsphinxが一番有名ですが、構築などが少し難しいのでもっと簡単にできないかと考えていました
今回はPythonのドキュメント生成システムのpdocを使って、GitHub Pagesでドキュメントを公開する所までやってみます
今回のサンプルリポジトリは下記です

インストール

pip install pdoc3

プログラムとDocstring形式でコメントを書いていきます

pdoc hogehoge --html -o docs --force

上のコマンドでは、docsディレクトリにhogehogeのドキュメントを生成していますので、docsディレクトリにHTMLファイルができています。

GitHub Pagesを使ってドキュメントを公開したい場合は、docsディレクトリにしておくと、GitHub Pagesの設定で簡単にページを公開することができます

こんな感じで特に何もすることなくドキュメントが公開されます。