如何处理 ReStructuredText 代码块中不同的缩进?

问题描述 投票:0回答:2

我正在将旧文档转换为 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 […]
restructuredtext
2个回答
0
投票

我不知道原始文档,但至少 Sphinx 有一个 code-block 指令,我认为它可以更好地控制缩进。

另一方面,我看到其他人使用 csv 表 来实现类似的结果。


0
投票

根据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 进行测试

© www.soinside.com 2019 - 2024. All rights reserved.