python-sphinx - 狮身人面像部分编号可以跳过某些部分(如标题)吗？

Question

我正在 Sphinx 中制作一系列设计文档，我想将它们一起包含在 toctree 中并对文件中的部分进行编号。我知道我可以使用 .. 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

有没有办法让标题显示在目录中以及最终不是编号部分的子页面的顶部？

Answer 1

我不知道你最后做了什么，但我想做同样的事情!我有以下设置:

index.rst

.. toctree::

   assignment
   library_api

我只希望分配部分有数字，所以任何一个都可以做两个单独的 toctree其中一个使用 :numbered: , 或放在文件顶部

.. sectnum::
   :start: 0

当然给出你提到的确切问题——我的顶级标题是 Assignment Writeup ，所以是 0小节中它下面的所有内容都是 0.x例如

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

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

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

给

0. Assignment Writeup
    0.1 First Task
    0.2 Second Task

事实证明，你可以做一个简单的黑客攻击。它使事情变得比可能期望的更加模块化，但是“添加了一层间接”。

所以现在我有 assignment.rst和 assignment_writeup.rst . assignment.rst只是基本上有一个标题和一个 toctree :

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

.. toctree::
   :maxdepth: 4

   assignment_writeup

然后取出所有子部分并将它们放入 assignment_writeup并“向上”他们的标题水平。所以我现在把所有的小节变成小节，然后把它们变成小节。

.. sectnum::
   :start: 0

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

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

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

我们现在终于有了

Assignment Writeup
    0. First Task
    1. Second Task

有点可疑，但这是我实现它的唯一方法 x0 我想知道你在问这个和现在之间做了什么？希望有一天有人会看到这一点并受益!

备注 : 这有不良的副作用。作业记录显示在它自己的页面上，只有指向间接文档的链接。老实说，不确定哪个更糟...