我正在 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
有没有办法让标题显示在目录中以及最终不是编号部分的子页面的顶部?
最佳答案
我不知道你最后做了什么,但我想做同样的事情!我有以下设置:
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 我想知道你在问这个和现在之间做了什么?希望有一天有人会看到这一点并受益!
备注 : 这有不良的副作用。作业记录显示在它自己的页面上,只有指向间接文档的链接。老实说,不确定哪个更糟...
关于python-sphinx - 狮身人面像部分编号可以跳过某些部分(如标题)吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/41967690/