2017-09-05 13 views
2

我使用美妙的狮身人面像工具来创建一些文档,我需要创建一个自定义的HTML div,以便我可以将它与斯芬克斯的其他自动创建的div区分开来。如何在狮身人面像中创建自定义的HTML div,并且不会自动嵌套在子部分中?

这是可能的使用container directive做的,但问题是,如果我用一个subsubsection低于这个指令,它会自动嵌套与容器指令创建的专区内的subsubsection,像这样:

<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> 

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

附录:

一个潜在的解决问题哈克的方式是创建一个新的subsubsection使狮身人面像自动将其在同级别其他subsubsections,然后用CSS来隐藏其头部等。然而,这种方法的问题在于,新的子部分会自动添加到RTD theme(我正在使用)中的侧边栏,这不是我想要的。

回答

3

未经测试。尝试超级哈克.. raw::指令,在那里你会关闭当前部分,然后打开一个新的未闭合<div>

.. raw:: html 

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

然后继续使用重组文本标记。这会“欺骗”Sphinx认为当前部分仍然处于打开状态,并且在标记的其余部分之后它仍然会添加一个关闭</div>,直到它开始解析下一部分。

+1

这工作,但由于某种原因,它搞砸了我的阅读文档主题,并使'上一个'和'下一步'按钮消失。 它看起来像这样做的唯一可靠的方式,而不会导致问题是通过Javascript。 – AZD

相关问题