拡張機能のチュートリアル.ビルド・フェーズ¶Sphinxのプロジェクトがビルドされる過程で、拡張機能がどのように実行されるのかということを理解することは、拡張機能の開発をするうえで必要不可欠です。この作業は以下のいくつかのフェーズから構成されています。初期化このフェーズでは拡張作成者にとって面白いものは何もありません。ソースディレクトリ内のソースファイルを探索し、拡張機能を初期化します。保存されたビルド環境があればそれをロードし、なければ新しいビルド環境を作成します。1ではすべてのソースファイルが読み込まれ、パースされます。この後のフェーズは新規のファイルか変更されたファイルに対して実行されます。このフェーズではdocutilsによってディレクティブやロールが処理され、それに対応するコードが実行されます。このフェーズの出力は、ソースファイルごとのdoctreeです。これは、docutilsのノードがツリー上に構成されているものです。すべてのファイルを読み込むまでは完全に解釈できないドキュメントの要素に関しては、一時的なノードが作られます。docutilsによって提供されるノードがあります。