Sphinx (ドキュメンテーションジェネレータ)

この項目では、ドキュメンテーションジェネレータについて説明しています。その他の用法については「スフィンクス (曖昧さ回避)」をご覧ください。

Sphinxは、Pythonで書かれているドキュメンテーションジェネレータである。 主にPythonコミュニティで利用されているが、その他の環境でも利用されている。

Sphinx

作者	Georg Brandl
初版	2008年3月21日 (17年前) (2008-03-21)
最新版	8.2.3 / 2025年3月2日 (5か月前) (2025-03-02)[1]
リポジトリ	github.com/sphinx-doc/sphinx
プログラミング 言語	Python
対応OS	クロスプラットフォーム
種別	ドキュメンテーションジェネレータ
ライセンス	修正BSDライセンス
公式サイト	www.sphinx-doc.org

目的と機能

SphinxはreStructuredTextをHTML (ウェブサイト) やPDF、EPUB、Texinfo及びmanページなどの他のフォーマットに変換する。

reStructuredTextには拡張性があり、Sphinxはソースコードからのドキュメントの自動生成、数式の表現、ソースコードのシンタックスハイライトなどにこれを利用している。

歴史と用例

最初の公開リリースであるバージョン 0.1.61611は000000002008-03-21-00002008年3月21日に発表された^[2]。 SphinxはPythonプロジェクトのドキュメントのために開発され、広く利用されている^[3]。

Sphinxは000000002008-01-01-00002008年に公開されて以来、Bazaar、SQLAlchemy、MayaVi、SageMath、SciPy、Django、Pylonsなどの他の多くの重要なPythonプロジェクトで採用されている。 また、Blenderのユーザーマニュアル^[4]やPythonのAPIドキュメント^[5]にも採用されている。

000000002010-01-01-00002010年、Eric Holscherはソフトウェアドキュメントの保守を容易にするための取り組みの一環として、Read the Docs（英語版）プロジェクトを発表した^[6]。 Read the Docsは、各コミット時にSphinxドキュメントの生成とアップロードを自動的に行う。

Linuxカーネル

Linuxカーネルのドキュメントサブシステムは000000002016-01-01-00002016年に変更された。 バージョン 4.7以降では、ドキュメントはSphinxを使用するように変更されている^[7]。

LCA2016

What I've learned as the kernel docs maintainer - YouTube

LCA2017

Kernel documentation: what we have and where it's going - YouTube