如何在 Sphinx 中创建一个不会自动嵌套在子小节中的自定义 HTML div？

Question

我正在使用出色的 Sphinx 工具来创建一些文档，并且需要创建一个自定义 HTML div，以便我可以将其样式与 Sphinx 的其他自动创建的 div 区分开来。

使用container 指令可以做到这一点，但问题是，如果我在子小节下方使用此指令，它会自动将使用容器指令创建的 div 嵌套在子小节内，如下所示：

<div id="automatically-created sphinx subsubsection">
   ...
   <div id="my custom container"></div>
</div>

然而，我想要：

<div id="automatically-created sphinx subsubsection">
   ...
</div>
<div id="my custom container"></div>

有什么办法可以做到这一点吗？任何帮助将不胜感激！

附录：

可能解决该问题的一种巧妙方法是创建一个新的子子部分，以便 Sphinx 自动将其放置在与其他子子部分相同的水平上，然后使用 CSS 隐藏其标题等。然而，这种方法的问题在于新的子子部分自动添加到RTD 主题（我正在使用）的侧边栏，但这不是我想要的。

Answer 1

未经测试。尝试一个超级 hacky.. raw::指令，您可以在其中关闭当前部分，然后打开一个新的未关闭的<div>：

.. raw:: html

    </div>
    <div id="my custom container">

然后继续使用重构文本标记。这会“欺骗”Sphinx，让其认为当前部分仍然打开，并且它仍然会在</div>标记的其余部分之后添加结束语，直到它开始解析下一部分。