6

Sphinx 拡張ディレクティブをネストする方法があるかどうかを調べようとしています。うまく機能しているカスタム ノード タイプがいくつかありますが、生成する HTML をもう少し柔軟にしたいと考えています。

これが私が達成しようとしていることの例です：

JavaScript をトリガーするテキストボックスとボタンを作成するディレクティブがあるとします。これは問題なく動作します - これを reST ファイルに入れることができます:

.. myDirective:: name
    :opt1: val
    content

ここで、出力に jQuery を使用してタブ付きインターフェイスを作成する機能が必要です。これを行うために必要な未加工の HTML/JavaScript を作成するノード タイプがあります。

私ができるようにしたいのは、タブ ノードに myDirective (または他のディレクティブ) の 1 つ以上のインスタンスを与え、各インスタンスを別のタブに配置することです。このようなもの：

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

    .. myDirective:: name2
        :op1: val1
        content

明らかにこれはかなり特殊なケースですが、これは一般的に私が達成したいことです - ネストされたディレクティブです。

4

1 に答える 1

8

構成ブロック拡張機能が役立つ場合があります: 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
于 2013-05-29T06:11:21.030 に答える