鈴木たかのり (@takanory) です。今月の 「Python Monthly Topics」 では、Python製の静的サイトジェネレーターSphinxを使用してWebサイトを構築し、テーマを適用、外部へ公開する流れについて紹介します。後半ではSphinxの便利な拡張機能を紹介し、Webサイトをより ...
※本記事は、別ブログで2018年に書いた記事のリメイク版です。掲載している諸々のバージョンが古い可能性があります。 APIドキュメント作るときの悩み みんなお仕事で、ライブラリとかのAPIドキュメント作るのってどうしてんだろう。WordとかExcelで作った ...
タイトルのとおりなのですが、PyPIに登録されているパッケージへのリンクを簡単にセットするSphinxロールを書いてみました。 ソース全体を見たい場合は、 GitHubのスライド用リポジトリので参照してください。 そもそもロールって? Sphinx(ひいては ...
鈴木たかのり (@takanory) です。今月の 「Python Monthly Topics」 では、Pythonを使っている人なら誰でも一度はお世話になったことがある、Python公式ドキュメント (https://docs. python. org/ ja/ 3/) を翻訳しよう! という内容でお届けします。 Python公式ドキュメント ...
必要に応じて、pyenv や conda 等の Python 仮想環境にスイッチします。 本記事では予め作成している sphinx という pyenv 仮想環境を使用します。 % pyenv local sphinx (sphinx) % python --version Python 3.7.6 ...