如何重置Sphinx中的编号部分?

时间:2018-02-12 10:41:55

标签: python-sphinx

我有几个独立的文件:

index.rst
foo.rst
bar.rst
conf.py
Makefile

我想从foo.rst访问index.rst,但我希望这两个子文档在1开始编号。

index.rst我有:

.. toctree::
   :maxdepth: 2
   :numbered:

   foo
   bar

但是,栏会取2.号,而bar.rst我会得到2.1 Tomatoes

=====
Title
=====

Tomatoes
========

Cucumbers
=========

我希望这个渲染:

1. Tomatoes
2. Cucumbers

这怎么可能?

1 个答案:

答案 0 :(得分:1)

你无法双管齐下。有关说明,请参阅Section numbering under the toctree directive的Sphinx文档:

  

章节编号

     

如果您希望在HTML输出中包含节号,请为顶级 toctree提供编号选项。例如:

.. toctree::
  :numbered:

  foo
  bar
     

编号然后从foo的标题开始。子toctrees会自动编号(不要给那些编号的标记)。