標準 Python ドキュメントのソース配布物には、数多くのディレクトリが 入っています。サードパーティ製のドキュメントは、このディレクトリ構造下や 似たディレクトリ構造下におく必要はありませんが、Python ドキュメント作成 ツールを利用して新たなドキュメントを開発する際に、どこで例題やツールを 探せばよいか知っておけば便利でしょう。そこでこの節では、ディレクトリ 構造について述べます。
ドキュメントソースは通常、Python ソース配布物中のDoc/ を トップレベルディレクトリとして配置されていますが、Python ソース配布物 には全く依存していません。
Doc/ ディレクトリには、いくつかのファイルとサブディレクトリ が入っています。ファイルはREADME や Makefile を含め、 ほとんどがその名の通りのファイルです。ディレクトリは以下の三つの カテゴリに分かれます:
| ディレクトリ | タイトル |
|---|---|
| api/ | Python/C API |
| dist/ | Python モジュールの配布 |
| doc/ | Python ドキュメントの作成 |
| ext/ | Python インタプリタの拡張と埋め込み |
| inst/ | Python モジュールのインストール |
| lib/ | Python ライブラリリファレンス |
| mac/ | Macintosh モジュールリファレンス |
| ref/ | Python リファレンスマニュアル |
| tut/ | Python チュートリアル |
| whatsnew/ | Python の更新情報 |
| ディレクトリ | 出力形式 |
|---|---|
| html/ | HTML 形式 |
| info/ | GNU info 形式 |
| isilo/ | iSilo ドキュメント (Palm OS 機器用) |
| paper-a4/ | PDF とPostScript、A4 サイズ |
| paper-letter/ | PDF と PostScript、US-Letter サイズ |
その他のディレクトリは、様々な処理で用いられる補助ファイルを格納 するためのものです。補助ファイルは、各ドキュメントで共通の LaTeX ドキュメントクラス、LaTeX2HTML のサポートファイル、ドキュメントの 構成要素となる雛形ファイル、フォーマット処理の様々なステップを実行 するスクリプトなどです。
| ディレクトリ | 内容 |
|---|---|
| commontex/ | ドキュメント間で共通の文章 |
| perl/ | LaTeX2HTML 処理のサポート |
| templates/ | ソースドキュメントの例 |
| texinputs/ | LaTeXスタイルファイル |
| tools/ | 独自の処理用スクリプト |
ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。