用容器替换狮身人面像

Question

如何替换容器指令？以下不起作用：

.. |sub| container::

    Some text here

    .. image:: img/some_image.png

    Some other text here

错误消息是

WARNING: Substitution definition "sub" empty or invalid.

Answer 1

这是不可能的。 ReST 替换适用于内联文本（单个段落），但容器是块元素。

如果您尝试，

.. |sub| replace:: container::

    Some text here

    .. image:: img/some_image.png

    Some other text here

您会得到

ERROR: Error in "replace" directive: may contain a single paragraph only.

您可以通过将容器放入单独的文件中并使用 .. include:: 将其拉入主文件来解决此问题。