使用 reST 嵌套 Sphinx 扩展指令答案

【问题标题】：Nesting Sphinx extension directives with reST使用 reST 嵌套 Sphinx 扩展指令
【发布时间】：2013-05-19 03:52:00
【问题描述】：

我正在尝试找出是否可以嵌套 Sphinx 扩展指令。我有一些效果很好的自定义节点类型，但我希望生成的 HTML 更灵活。

这是我想要完成的一个示例：

假设我有一个指令，它创建一个触发一些 JavaScript 的文本框和按钮。这很好用 - 我可以把它放在我的 reST 文件中：

.. myDirective:: name
    :opt1: val
    content

现在，我希望能够在输出中使用 jQuery 创建一个选项卡式界面。我有一个节点类型，可以创建发生这种情况所需的原始 HTML/JavaScript。

我希望能够为选项卡节点提供 1 个或多个 myDirective 实例（或其他指令），并将每个实例放入另一个选项卡。像这样的：

..tabbedInterface:: 
    .. myDirective:: name1
        :op1: val1
        content

    .. myDirective:: name2
        :op1: val1
        content

显然这是一个非常具体的案例，但这通常是我想要完成的——嵌套指令。

【问题讨论】：

标签： python python-sphinx restructuredtext docutils

【解决方案1】：

配置块扩展可能会帮助您： https://github.com/fabpot/sphinx-php/blob/master/sensio/sphinx/configurationblock.py

发件人：http://symfony.com/doc/2.0/contributing/documentation/format.html#configuration-blocks

.. configuration-block::

  .. code-block:: yaml

    # Configuration in YAML

  .. code-block:: xml

    <!-- Configuration in XML //-->

  .. code-block:: php

    // Configuration in PHP

【讨论】：

谢谢！这足以让我最终弄清楚。