9

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

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

4

1 回答 1

2

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

index.rst

.. toctree::

   assignment
   library_api

我只希望分配部分有数字，所以要么可以toctree用一个 using单独完成两个: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.rstand 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 我想知道你在问这个和现在之间做了什么？希望有一天有人会看到这一点并受益！

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

于 2017-04-26T04:40:31.337 回答