Python sphinx 狮身人面像章节编号是否可以跳过某些章节（如标题）？

我正在用Sphinx制作一系列设计文档，我希望将它们一起包含在

目录树中

，并对文档中的部分进行编号。我知道我可以使用

。。sectnum:：

对子页面中的所有部分进行编号。但是，Sphinx/rst对页面的标题进行编号（实际上只是第一节），目录最终看起来像：

Table of Contents
    1 Design the First
    2 Design the Second

每个子页面看起来像：

1 Design the First
1.1 First Section
1.2 Second Section

我想要的是在我的索引页上列出标题的目录

Table of Contents
    Design The First
    Design the Second

和子页面，看起来像

Design the First
1 First Section
2 Second Section

---

有没有一种方法可以让一个标题显示在TOC中，或者显示在一个子页面的顶部，而这个子页面最终不是一个编号的部分

我不知道你最后做了什么，但我也想做同样的事！我有以下设置：

index.rst

.. toctree::

   assignment
   library_api

我只希望作业部分有数字，因此可以使用

：number:

完成两个单独的

目录树

，或者放在文件的顶部

.. sectnum::
   :start: 0

当然给出了你提到的确切问题——我的顶级标题是

Assignment Writeup

，所以那是

0

，下面的子部分都是

0.x

，例如

Assignment Writeup
==================

First Task
----------

Second Task
-----------

给予

事实证明，有一个简单的黑客你可以做到。它使事情比预期的更加模块化，但“增加了一层间接性”

现在我有了

assignment.rst

和

assignment\u writeup.rst

<代码>作业。rst基本上只有一个标题和一个目录树：

Assignment Writeup
==================

.. toctree::
   :maxdepth: 4

   assignment_writeup

然后将所有小节放入

assignment\u writeup

并“上溯”标题级别。所以我现在把所有的小节都做成小节，再把它们做成子小节

.. sectnum::
   :start: 0

First Task
==========

^^^ === instead of --- now

Second Task
===========

现在我们终于有了

Assignment Writeup
    0. First Task
    1. Second Task

有点可疑，但这是我实现它的唯一途径。我想知道你从问这个到现在做了什么？希望有人会看到这一点，并有一天受益

注意：这有不希望的副作用。分配Writeup显示在它自己的页面上，只包含指向间接文档的链接。老实说，不知道哪一个更糟

Assignment Writeup
    0. First Task
    1. Second Task