python-sphinx - 如何重置 Sphinx 中的编号部分？

Question

我有几个相互独立的文件：

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

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

在index.rst我有：

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

   foo
   bar

但是， bar 会取这个数字2.，然后bar.rst我会得到2.1 Tomatoes.

=====
Title
=====

Tomatoes
========

Cucumbers
=========

我想要这个渲染：

1. Tomatoes
2. Cucumbers

这怎么可能？

Answer 1

你不能同时拥有它。有关说明，请参阅指令下的部分编号的toctreeSphinx 文档：

章节编号

如果您想在 HTML 输出中也有部分编号，请为顶层 toctree提供编号选项。例如：

.. toctree::
  :numbered:

  foo
  bar

然后编号从 的标题开始foo。子目录树会自动编号（不要给那些编号的标志）。