python-sphinx - 如何在 Sphinx 中创建一个不会自动嵌套在 subsubsection 中的自定义 HTML div？

Question

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

使用 container directive 可以做到这一点，但问题是，如果我在子子节下方使用此指令，它会自动将使用容器指令创建的 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>

有没有办法做到这一点？任何帮助将不胜感激!

附录:

一种可能解决该问题的 hacky 方法是创建一个新的 subsubsection，以便 Sphinx 自动将其放置在与其他 subsubsection 相同的级别，然后使用 CSS 隐藏其标题等。然而，这种方法的问题在于新的 subsubsection自动添加到 RTD theme 的侧边栏中(我正在使用)这不是我想要的。

Answer 1

未经测试。尝试一个 super 黑客 .. raw:: 指令，您将在其中关闭当前部分，然后打开一个新的未关闭的 <div> :

.. raw:: html

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

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