鈴木たかのり （@takanory） です。今月の 「Python Monthly Topics」 では、Python製の静的サイトジェネレーターSphinxを使用してWebサイトを構築し、テーマを適用、外部へ公開する流れについて紹介します。後半ではSphinxの便利な拡張機能を紹介し、Webサイトをより ...

※本記事は、別ブログで2018年に書いた記事のリメイク版です。掲載している諸々のバージョンが古い可能性があります。 APIドキュメント作るときの悩み みんなお仕事で、ライブラリとかのAPIドキュメント作るのってどうしてんだろう。WordとかExcelで作った ...

:::message 後述しますが、この記事はatsphinx-toyboxで管理している機能を使っています。 つまり、遊び半分に作っており最低動作はするものの実用保証はしません。 ::: Python製ドキュメントビルダーのSphinxは、ビルドにまつわる設定をconf.pyというPythonソースで ...

自作 Python モジュールのドキュメンテーションを、ソースコードから自動生成していきます。 ドキュメンテーション生成ツールである Sphinxおよび、その拡張機能である Napoleonを利用します。 b. 想定読者 以下のような課題感をお持ちの方を想定しています。

今年も冷え込む秋になってまいりました。皆様、お健やかにお過ごしでいらっしゃいますか。 開発チームの sonod です。 この度、新しくPythonコンテナが利用可能になりました！！！！！ このような感じで、プロジェクトを作成する際にPythonが選択することが ...