RST有序列表被中间段落打断后编号重置为1如何解决
RST有序列表中间插入内容后序号续接解决方案
问题原因:RST默认会将被非列表内容分隔的两段有序列表识别为两个独立列表,无论手动填写的起始编号是多少,都会默认从1开始重新计数。
针对两种不同的场景有对应的解决方法:
场景1:中间插入的文本属于上一个列表项的内容
如果插入的Text...、Text..是第3条列表项的附属内容,不需要独立于列表展示,只需要将插入的文本缩进至和列表项内容对齐即可,列表会自动判定为连续序列,序号正常续接:
1. text1 2. text2 3. text3 Text... Text.. 4. text4 5. text5
场景2:中间插入的文本是独立于列表的正文内容
如果插入的文本不属于任何列表项,是独立的正文段落,你可以通过指定第二段列表的起始编号实现续接,不同渲染器的兼容写法如下:
通用兼容写法
使用列表指令显式指定起始编号:
1. text1 2. text2 3. text3 Text... Text.. .. enumerate:: :start: 4 text4 text5
Sphinx等扩展渲染器写法
添加续接标记即可直接识别连续序号:
1. text1 2. text2 3. text3 Text... Text.. .. rst-class:: continue 4. text4 5. text5
轻量解析器兼容写法
在手动编号后加#标记续接:
1. text1 2. text2 3. text3 Text... Text.. 4.# text4 5.# text5
内容的提问来源于stack exchange,提问作者bakun
相关产品推荐
相关产品推荐

