狮身人面像部分编号跳过某些部分(如标题)?

我做了一系列的狮身人面像设计文件的,我想一起包括他们在一个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.rstassignment_writeup.rstassignment.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?