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

Sphinx を使ってコードから綺麗な HTML ドキュメントを作るための最短実践ガイド 目的は「Python のソースに書いた docstring をそのまま HTML にして公開できる」こと。手を動かしながら学べるように、設定・書き方・コマンド・よくある落とし穴をまとめます。

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