The reStructuredText Domain¶

Added in version 1.0.

reStructuredTextドメイン(rst)は、次のようなディレクティブを提供します:

.. rst:directive:: name¶

Describes a reStructuredText directive. The name can be a single directive name or actual directive syntax (.. prefix and :: suffix) with arguments that will be rendered differently. For example:

.. rst:directive:: foo

   Foo description.

.. rst:directive:: .. bar:: baz

   Bar description.

これは次のようにレンダリングされます

.. foo::¶: Fooの説明

.. bar:: baz¶: Barの説明

.. rst:directive:option:: name¶

Describes an option for reStructuredText directive. The name can be a single option name or option name with arguments which separated with colon (:). For example:

.. rst:directive:: toctree

   .. rst:directive:option:: caption: caption of ToC

   .. rst:directive:option:: glob

これは次のようにレンダリングされます

.. toctree::

:caption: caption of ToC

:glob:

options

:type: description of argument (text)¶

Describe the type of option value.

例えば:

.. rst:directive:: toctree

   .. rst:directive:option:: maxdepth
      :type: integer or no value

Added in version 2.1.

.. rst:role:: name¶

Describes a reStructuredText role. For example:

.. rst:role:: foo

   Foo description.

これは次のようにレンダリングされます

:foo:¶: Fooの説明

このドメインでは、オブジェクトの説明を参照する、次のようなロールが提供されています:

:rst:dir:¶

Reference directives and directive options. Examples:

Use :rst:dir:`my-directive` to reference a directive.
Use :rst:dir:`my-directive:my-option` to reference a directive option.

:rst:role:¶: Reference a role. Example: :rst:role:`my-role`.