狮身人面像部分编号跳过某些部分(如标题)?
我做了一系列的狮身人面像设计文件的,我想一起包括他们在一个toctree
并有编号的文档中的部分。 我知道我可以使用.. sectnum::
编号在子页面中的所有部分。 然而,狮身人面像/第一个数字标题的页面(这实际上只是第一部分)和目录结果如下所示:
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
我只希望赋值部分有数字,所以或者可以使用两个独立的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我不知道你在问这个和现在之间做了什么? 希望有人会看到这一点,并从中受益!
注意 :这有不希望的副作用。 Assignment Writeup显示在其自己的页面上,只有间接文档的链接。 不确定哪一个更糟糕...
链接地址: http://www.djcxy.com/p/84133.html上一篇: Can Sphinx Section Numbering Skip Certain Sections (like a title)?
下一篇: Is it possible to extend Sphinx automodule to domains other than Python?