如何处理ReStructuredText代码块缩进不一致的排版问题

你要实现原文档中包名右对齐、后跟功能说明的排版效果，当前写法失效是因为::标记后的字面量块缩进基准不对，ReST解析时会自动剥离所有行统一的前导缩进，最终渲染出来的对齐效果和预期不符。
可以用以下两种方案实现需求：

方案1：字面量块复刻（完全还原原有对齐效果） #

如果不需要结构化解析内容，只需要1:1还原排版，调整字面量块的整体缩进即可，确保所有内容行的相对缩进和你要的对齐效果完全一致：

[…] 如下所示：

::

      dataio - 数据格式转换包（含RFITS等功能）
        dbms - 数据库管理包（暂未实现）
         …
      system - 系统工具包
   utilities - 杂项工具包

要使用对应包必须先加载 […]

渲染时会保留你写的所有空格缩进，完美还原原文档的对齐效果。

方案2：结构化表格实现 #

如果需要内容可结构化处理、后续方便调整样式，可以用右对齐的两列表格实现：

[…] 如下所示：

.. list-table::
   :align: left
   :widths: auto
   :header-rows: 0

   * -     dataio
     - 数据格式转换包（含RFITS等功能）
   * -       dbms
     - 数据库管理包（暂未实现）
   * -     system
     - 系统工具包
   * -  utilities
     - 杂项工具包

要使用对应包必须先加载 […]

你可以根据自己的需求调整第一列的前导空格数量，实现包名右对齐的效果。

内容的提问来源于stack exchange，提问作者olebole