不要对重构文本中的节标题进行编号

Question

重组后的文本文档

.. sectnum:

Document Title
==============
BlaBla

First section
-------------

BlaBla

Second section
--------------

BlaBla

渲染如下：

1.文档标题

啦啦啦

1.1。第一节

啦啦啦

1.2。第二节

啦啦啦

如何实现以下目标？

文档标题

啦啦啦

1.第一节

啦啦啦

2.第二节

啦啦啦

理想情况下，可以与 GitHub 的重构文本渲染器配合使用吗？

Answer 1

看来是这样

Document Title
==============
.. contents::
.. sectnum::

BlaBla

First section
-------------

BlaBla

Second section
--------------

BlaBla

中所示

Answer 2

给定的示例在 “sectnum”指令。解决这个问题，纯“Docutils”的输出显示了预期的样式（第一个标题提升为没有节号的文档标题）。

也许在原始文档中，第一个标题上方还有其他文本？仅当节标题是第一个可见元素时，它才成为文档标题。（标题之前也允许有标题。）

1.文档标题