标准域¶
版本 1.0 新增。
所谓的“标准”域收集了所有不值得拥有自己域的标记。它的指令和角色没有域名前缀。
标准域也是放置自定义对象描述的地方，这些描述是使用 add_object_type() API 添加的。
有一组指令允许记录命令行程序
- .. option:: name args, name args, ...¶
描述命令行参数或开关。选项参数名称应包含在尖括号中。示例
.. option:: dest_dir Destination directory. .. option:: -m <module>, --module <module> Run a module as a script.
该指令将为给定选项创建交叉引用目标，可通过
option引用（在示例中，您可以使用:option:`dest_dir`、:option:`-m`或:option:`--module`）。版本 5.3 更改: 可以包含选项值进行交叉引用：
:option:`--module=foobar`、:option:`--module[=foobar]`或:option:`--module foobar`。使用
option_emphasise_placeholders解析文本的“变量部分”（类似于samp角色）。cmdoption指令是option指令的已弃用别名。
- .. confval:: name¶
版本 7.4 新增。
描述文档代码或程序使用或定义的配置值或设置。可通过
confval引用。- :type: (text)¶
描述配置值的类型。这是可选的，如果指定，将被解释为 reStructuredText。
- :default: (text)¶
描述配置值的默认值。这是可选的，如果指定，将被解释为 reStructuredText。
示例
.. confval:: the_answer :type: ``int`` (a *number*) :default: **42** This is a setting that controls the value of the answer.
将渲染如下
- the_answer¶
- 类型:
int(一个 数字)- 默认:
- 42
这是一个控制答案值的设置。
- .. program:: name¶
与
py:currentmodule类似，此指令不产生输出。相反，它用于通知 Sphinx，所有后续的option指令都记录了名为 name 的程序的选项。如果使用
program，则必须通过程序名称限定option角色中的引用，因此如果出现以下情况.. program:: rm .. option:: -r Work recursively. .. program:: svn .. option:: -r <revision> Specify the revision to work upon.
那么
:option:`rm -r`将指第一个选项，而:option:`svn -r`将指第二个选项。如果参数传递
None，该指令将重置当前程序名称。程序名称可以包含空格（如果您想单独记录
svn add和svn commit等子命令）。版本 0.5 中新增。
还有一个非常通用的对象描述指令，它不与任何域绑定