Python sphinx 三级以上标题的狮身人面像章节编号:。。sectnum::

Python sphinx 三级以上标题的狮身人面像章节编号:。。sectnum::,python-sphinx,restructuredtext,sections,toctree,Python Sphinx,Restructuredtext,Sections,Toctree,我正在使用Sphinx从rst文件生成pdf文件。Sphinx自动生成第3级标题的章节号,以及该级别的目录。然而,我希望所有级别的标题都被编号,并在TOC中。为了做到这一点,我尝试使用。。sectnum::()。结果与我预期的不完全一样: 1) 有一个数字1。在TOC和text中的所有节号前面添加,即,不是1,而是1.1,不是2,而是1.2 2) 在TOC和文本中,直到第三级标题,章节编号都会重复,即在错误的章节编号之前有一个正确的章节编号(前面加了1) 这是我的rst文件示例: 以下是TO

我正在使用Sphinx从rst文件生成pdf文件。Sphinx自动生成第3级标题的章节号,以及该级别的目录。然而,我希望所有级别的标题都被编号,并在TOC中。为了做到这一点,我尝试使用
。。sectnum::
()。结果与我预期的不完全一样:

1) 有一个数字1。在TOC和text中的所有节号前面添加,即,不是1,而是1.1,不是2,而是1.2

2) 在TOC和文本中,直到第三级标题,章节编号都会重复,即在错误的章节编号之前有一个正确的章节编号(前面加了1)

这是我的rst文件示例:



以下是TOC的结果:

(我拍摄了我的pdf文件以显示结果,但我刚刚发现我无法发布图像,因为我需要10个声誉,这是我第一次发布任何东西)

以下是文本的结果:

                     1.1 LEVEL 1: THE FIRST PARTY

level 1 desc: this document is about xyz

1.1 1.1.1 level 2

level 2 desc

1.1.1 1.1.1.1 level 3

level 3 content

1.1.1.1.1 level 4

level 4 content

1.1.1.1.1.1 level 5

level 5 content jflkasjfslkajf asdfsafs
如你所见,有1个。添加到章节号中,标题有一个重复部分,直到第3级


如果有人能在这方面帮助我,我真的很感激。

斯芬克斯似乎认为整个项目是一个文档,每个
.rst
文件都是其中的一章;您可以指示主
中文件的顺序。。目录树::
。我想这就是你得到这些数字的原因。我猜这是一个非常常见的用例,不需要对
.rst
文件进行编号,所以也许有人应该建议这样做


顺便说一下,请注意Sphinx明确不支持
sectnum
。相反,他们建议您使用顶级
中的
:number:
参数。。目录树::
。()

我尝试将您的代码呈现为HTML,效果很好

<>也许你可以考虑HTML格式。


另外,

。。sectnum::

我认为它们没有什么不同,取决于你的设计选择

  • 只想对小节进行编号:
    sectnum
  • 带编号的整个项目标题(它将自动包含子目录树)选择:
    目录树:::编号:

了解更多信息>

1 1.1 level 1: the first party
  1.1   1.1.1 level 2

2 1.2 level 1: the second part
  2.1   1.2.1 level 2
                     1.1 LEVEL 1: THE FIRST PARTY

level 1 desc: this document is about xyz

1.1 1.1.1 level 2

level 2 desc

1.1.1 1.1.1.1 level 3

level 3 content

1.1.1.1.1 level 4

level 4 content

1.1.1.1.1.1 level 5

level 5 content jflkasjfslkajf asdfsafs
.. toctree::
   :numbered: