ようこそ!

ユーザの声:

“プログラマーにドキュメントを本当に書きたくさせる、優れたツールを応援しましょう!“

Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。

このツールはもともと、the Python ドキュメントのために作られました、今では幅広い言語のプロジェクトでドキュメント作成を容易にするツールとして利用されています。もちろん、このサイトもreStructuredText からSphinxで作成されています! 次に特徴を紹介します:

  • 出力形式: HTML (WIndowsのHTMLヘルプを含む)、LaTeX(印刷可能なPDFバージョン)、ePub、Texinfo、man、プレーンテキスト
  • 多岐にわたる相互参照: 意味のマークアップと、関数、クラス、引用、用語解説、似たような情報に対する自動リンク
  • 階層構造: 簡単にドキュメントツリーを定義でき、兄弟、親、子供のドキュメントに対して、リンクを貼れる
  • 自動インデックス作成: 全体インデックスと、言語特有のモジュールインデックス
  • ソースコードの対応: Pygmentsを使った自動ハイライト
  • 拡張: コードスニペットを使った自動テスト, Pythonモジュールのdocstringのインクルード(APIドキュメント作成), 他にもあります
  • 寄贈された拡張: 50以上の拡張が ユーザによって寄贈され。 sphinx-contribリポジトリ内にあり、ほとんどの拡張はPyPIよりインストール可能

SphinxはreStructuredTextをマークアップ言語として使用しています。Sphinxの強さの多くの部分はreStructuredTextと、そのパース、変換プログラム群である、Docutilsからきています。

ドキュメント

Sphinx ドキュメンテーションのPDF/EPUB 版についても、右下のポップアップメニューからダウンロードすることができます。

サンプル

Sphinxを使用しているプロジェクトのページから、Sphinxを使って生成されたドキュメントを見に行くことができます。

サンプルのドキュメントのソースを見たければ、このトップページ以外のすべてのドキュメントのページにある、“Show source(ソースを表示)”のリンクをクリックしてみてください。

また、matplotlibの開発者によって書かれた、Sphinxを使ったカスタマイズされたドキュメントの作り方に関するチュートリアルにも興味を持つでしょう。

このドキュメントは日本語に翻訳されています。日本のSphinxユーザグループのみなさん、ありがとう。

Sphinxに関する日本語の本がO'Reillyより出版されました: Sphinxをはじめよう/ Learning Sphinx

2019年にドイツ語によるSphinx本の第2版が出版されました: Software-Dokumentation mit Sphinx.

ホスティング

Sphinx ドキュメントをホストする場所が必要ですか? readthedocs.org は、すでに多くのSphinx ドキュメントをホストしていて、 プロジェクトのソース管理がうまく統合されています。また、このサイトの特長としては SphinxのJavaScriptベースによるオフライン検索機能を上回る、強力なビルトイン検索を有していることがあります。

コントリビューターガイド

もしあなたがプロジェクトに貢献したい場合、この章はまさにあなたのためのものです。

Code of Conduct

Please adhere to our Code of Conduct.