如何使用 reStructuredText 获得这样的结构?有可能吗?
1. Title
1.1 Subtitle
1.1.2 SubSubtitle
1.1.2.1 SubSubtitle
1.2 2ndSubtitle
1.2.1 2ndSubSubtitle
您查看过Sphinx 嵌套列表文档吗?您的问题应该表明您付出了一些的努力,包括您阅读了哪些文档、您尝试了什么、您期望什么以及您观察到了什么。
可以使用嵌套列表,但请注意它们必须用空行与父列表项分隔:
* this is
* a list
* with a nested list
* and some subitems
* and here the parent list continues
用
#.
代替 *
。
所以我在这里找到了答案:
Title
=====
Subtitle
--------
___________
SubSubtitle
___________
SubSubSubtitle 1
________________
SubSubSubtitle 2
________________
_____________
SubSubtitle 2
_____________
Title 2
=======
输出将是(如果编号文档树):
1. Title
1.1 Subtitle
1.1.1 SubSubtitle
1.1.1.1 SubSubSubtitle 1
1.1.1.2 SubSubSubtitle 2
1.1.2 SubSubtitle 2
2. Title 2
有关更多信息,请查看:http://docutils.sourceforge.net/docs/user/rst/quickstart.html#sections
结构可以通过嵌套枚举列表来实现:
#. Title
#. Subtitle
#. SubSubtitle
#. SubSubtitle
#. 2ndSubtitle
#. 2ndSubSubtitle
所需的编号需要一组自定义 CSS 规则。 Docutils 支持一些编号样式(参见 https://docutils.sourceforge.io/test/function/expected/standalone_rst_html5.html#enumerated-lists)但不是这个。