python加标题,
我使用Sphinx从第一个文件生成pdf文件。Sphinx自动生成多达3级标题的章节号,以及这一级别的目录。然而,我希望所有级别的标题都有编号并在目录中。为此,我尝试使用.sectnum:(
3358 Docutils.sourceforge.net/docs/ref/rst/directives.html #目录)。结果并不完全符合我的预期:
1)在目录和文本中的所有零件号前添加数字1。就是不是1,是1.1不是2,是1.2。
2)在TOC和三级标题以下的正文中,零件号重复,即错误零件前面有一个零件号(正确号)(加1。).
以下是我的示例rst文件:
.sectnum:
第一级:第一方
========================
第一级desc:这份文件是关于xyz的
第二级
-
二级desc
第三级
~~~~~~~~
三级内容
四级
^^^^^^^^
四级内容
第5级
级别5内容jflkasjfslkajf
asdfsafs
第一级:第二部分
========================
fjsdafjskalfjslkafjksaljflksaj
fasdhfkjsahfjkhdsf
第二级
-
二级desc
第三级
~~~~~~~~
三级内容
四级
^^^^^^^^
四级内容
第5级
级别5内容jflkasjfslkajf
asdfsafs
这是TOC的结果:
(我拍了拍我的pdf文件展示结果,但是我发现我不能贴图片,因为我需要10点声望,而且这是我第一次贴东西)
1 1.1第一级:第一方
第二级
2 1.2第一级:第二部分
第二级
以下是正文的结果:
1.1第一级:甲方
第一级desc:这份文件是关于xyz的
第二级
二级desc
1.1.1.1第三级
三级内容
第四级
四级内容
第五级
级别5内容jflkasjfslkajf asdfsafs
可以看到,章节号加了1,标题重复的部分上到3级。
如果有人能帮我解决这个问题,我真的很感激。
最佳答案Sphinx似乎认为整个项目就是一个文档,每一个。rst文件是其中的一章;您可以指定主文件中文件的顺序.目录树:我猜这就是你得到数字的原因。我想这是一个非常常见的用例,不希望编号。rst文件,所以也许应该有人提议这样做。
顺便说一下,请注意Sphinx明确不支持sectnum。相反,他们建议您在顶层使用:numbered: parameter.目录树:(http://sphinx-doc.org/rest.html)
郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。