我正在将旧文档转换为 ReST。 文档具有以下结构:
现在的问题是如何通过 ReST 获得此信息。以下内容不起作用:
[…] are listed below.
::
dataio - Data format conversion package (RFITS, etc.)
dbms - Database management package (not yet implemented)
…
system - System utilities package
utilities - Miscellaneous utilities package
A package must be loaded in order […]
我不知道原始文档,但至少 Sphinx 有一个 code-block 指令,我认为它可以更好地控制缩进。
另一方面,我看到其他人使用 csv 表 来实现类似的结果。
根据rST规范, 如果所有行都比“文字块标记”缩进更多,则给定的示例应该(并且确实)有效。
::
。
修复以下无效示例
#. ::
dataio - Data format conversion package (RFITS, etc.)
dbms - Database management package (not yet implemented)
system - System utilities package
utilities - Miscellaneous utilities package
只需将所有行缩进至少一个空格即可。¹ 使用 Docutils 0.19 进行测试