Sphinxは、Pythonで書かれているドキュメンテーションジェネレータである。 主にPythonコミュニティで利用されているが、その他の環境でも利用されている。
目的と機能 SphinxはreStructuredTextをHTML (ウェブサイト) やPDF、EPUB、Texinfo及びmanページなどの他のフォーマットに変換する。
reStructuredTextには拡張性があり、Sphinxはソースコードからのドキュメントの自動生成、数式の表現、ソースコードのシンタックスハイライトなどにこれを利用している。
歴史と用例 最初の公開リリースであるバージョン 0.1.61611はに発表された。 SphinxはPythonプロジェクトのドキュメントのために開発され、広く利用されている。
Sphinxはに公開されて以来、Bazaar、SQLAlchemy、MayaVi、SageMath、SciPy、Django、Pylonsなどの他の多くの重要なPythonプロジェクトで採用されている。 また、BlenderのユーザーマニュアルやPythonのAPIドキュメントにも採用されている。
、Eric Holscherはソフトウェアドキュメントの保守を容易にするための取り組みの一環として、プロジェクトを発表した。 Read the Docsは、各コミット時にSphinxドキュメントの生成とアップロードを自動的に行う。
Linuxカーネル Linuxカーネルのドキュメントサブシステムはに変更された。 バージョン 4.7以降では、ドキュメントはSphinxを使用するように変更されている。 LCA2016
LCA2017
脚注
外部リンク