ソースコードをプレーンテキストで作成するドキュメンテーションツール ソースコードから色々なフォーマットに出力する事が可能 reStructuredTextという記法でソースコードを作成
reStructuredText(reST)という、Wikiに似た記法でマークアップをしていきます。
html latex pdf json htmlhelp epub text man .......etc
SphinxのインストールからreStructuredText基礎まで、適宜デモを交えて
インストールから、実際にドキュメントを作成していく所までをご説明します。
プレーンテキストである為に、バージョン管理しやすい -> 複数人で編集しやすい! toctreeにより階層構造を促され、文書作成が横道にそれにくい 文書の分割、結合が楽 さまざまな拡張があり、拡張を自身で作成する事も可能
- pdf化
- プラグイン
reSTは行指向のフォーマットであるため、差分もみやすくなっています。
wikiに似ている。
弱い所 番号 表 ブラウザ
しょうこうせい
用途自体に被るところが大きい、あるいは似ているならばSphinxを選んでみるのも手でしょう
一番ストレスフリーなのではないか?
ドキュメントの体裁を気にしすぎて作成作業が進まない。 オートコレクトや自動インデントの機能が余計に働いて困る。 ドキュメントが比較しにくい。 ドキュメントを分割して構造化するのが難しい。 同一ファイルを複数人が並行作業しつつ変更するのが難しい。 ドキュメントの一部を抜き出して新たなドキュメントを作成するのが難しい。