python - 我可以在 Sphinx 的目录中添加水平条吗？

Question

我正在 Sphinx 中开发文档，并想使用水平条分隔目录中的部分。

我经常在菜单中看到这个：

有没有办法在狮身人面像中做到这一点？

Answer 1

除了包含在指令正文中的文档以及一些指令选项之外， python sphinx.. toctree::指令不允许有太多变化。

在这种情况下，我看到其他人所做的是将一个拆分toctree为多个，包括它们之间的 reStructuredText。

您可以使用toctree. 引用文档：

笔记

对于本地目录，使用标准的 reST内容指令。

最简单的方法是将菜单分成几个toctrees，包括它们之间的 HTML 水平标尺：

Sphinx_test
===========


.. toctree::
   :maxdepth: 4
   
   undo
   redo

.. raw:: html

   <hr>

.. toctree::
   :maxdepth: 4
   
   cut
   copy

.. raw:: html

   <hr>
   
.. toctree::
   :maxdepth: 4
      
   find
   Speech

结果：