Sphinx+翻訳 Hack-a-thon 2025.1¶
年始も元気にSphinx関連作業を進める時間を確保しています。
https://sphinxjp.connpass.com/event/341157/
atsphinx-goto-top¶
SphinxのHTMLビルドに対して、画面下に「トップに戻る」ボタンを付与する拡張を作ってました。 [1] The PyData Sphinx Theme のようにテーマに組み込まれているケースもあるのに対して、今回作ったのは「どのテーマでも使える」ことを意識したものです。
薄く実装したので、ドキュメントにあるものと違って、このサイト上で表示されるようなカスタマイズも容易だったりします。 [2]
i18n対応したら需要がありそうなので、もう少し開発をしてみる予定です。
リンク¶
atsphinx-toybox.pyproject¶
前日にふと思いついて作ってみた、
「 pyproject.toml に記述した項目を sphinx-build 時の設定にする」という変わり種です。 [3]
実用性はともかくとして、 Pythonプロジェクトのメタデータを setup.py ではなく
setup.cfg に書くという変遷を眺めていた身としては、懐かしいスタイルが出来上がりました。
リンク¶
注記
PyCon APAC 2025に提出したCfPが採択されました
ABlogでのSphinxブログ構築時の日本語タクソノミー対策