これを使って、モジュールが提供する特定のオブジェクトについて説明をしていきます。それぞれのディレクティブでは、何について説明しているか、説明すべき内容などの基本情報のためのフォーマットや統一のルールを定めています。Pythonのドメインのディレクティブの場合には、次のようになります。いう2つのPython関数を説明しています。フラグの使い方でもあります)。thing.このように、ディレクティブとロール名の両方とも、ドメイン名とディレクティブ名の2つから構成されています。デフォルトドメイン単一のドメインからなるオブジェクト群を説明するドキュメンテーションでは、デフォルトのドメインを明確にすれば、ディレクティブやロール、その他で都度、何回もそのドメイン名を書く必要はないでしょう。新しいデフォルトのドメインを設定します。プロジェクト全体のデフォルトを決定しますが、このディレクティブは同じファイル内にのみ影響を与えます。デフォルトが設定されないと、Pythonドメイン(py)がデフォルトになります。これは、過去のバージョンのSphinxで書かれたドキュメントと互換性があります。汎用的なクロスリファレンスのために使用されるのと同じような機能を持つ、クロスリファレンスのためのロールが、ドメインによって提供されます。簡単に説明すると:明示的なリンク名と、リンクターゲットを指定できます。指定すると、参照もハイパーリンクも作成されなくなります。設定すると、リンクテキストは最後の項目だけが表示されるようになります。name¶このディレクティブはモジュールの説明の開始時に使用します。パッケージやサブモジュールにも使用できますが、この場合はパッケージ名を含む、完全な名前を指定してください。ディレクティブのようなコンテンツを作成することはできません。このディレクティブを使用すると、グローバルなモジュール索引に項目が追加されます。ように)の中にある、ということを通知します。これを使用しても、索引のエントリーは作成されません。リンクターゲットも作成されません。このディレクティブは、モジュールに含まれる項目へのドキュメントが様々なファイルやセクションに分割されている場合に便利です。使用するようにします。レベルの関数について説明します。関数定義で指定されたパラメーターを含む必要があります。