Sphinx 的智能表格 (reStructuredText)答案

【问题标题】：Smart tables for Sphinx (reStructuredText)Sphinx 的智能表格 (reStructuredText)
【发布时间】：2022-06-22 06:12:21
【问题描述】：

是否有任何智能表扩展可用于在 RST 中使用表？

使用具有多列的表格，必须键入每一行和每一列，这太乏味了。特别是如果我想合并或拆分表格中的单元格，如下所示：

我正在尝试使用平板获取上表。任何人都可以建议如何获得这个？

.. flat-table:: Characteristics of the BLE badge
   :header-rows: 1

   * - Col 1
     - Col 2
     - Col 3
   * - :rspan:`2` 0xfee7
     - 0xfec7
     - WRITE
   * - 0xfec8
     - INDICATE
   * - 0xfec9
     - READ
   * - 0xfee0
     - 0xfee1
     - NOTIFY, READ, WRITE

使用Linuxdoc 扩展来使用平面表。

【问题讨论】：

grid tables 做你想做的事吗？
我可以使用网格或平面表，只要我能够合并屏幕截图中显示的列或行。
您是否能够让网格表为您工作？如果没有，请使用您尝试过的内容编辑您的问题。网格表语法可能很棘手。
不，我无法获得包含我需要的列类型的网格。我得到一个普通的网格表（代码已经在问题中了）。
请通过编辑您的答案并粘贴网格表的 reStructuredText 来分享您对网格表的尝试。

标签： python-sphinx restructuredtext

【解决方案1】：

linuxdoc 手册包含一个包含行和列跨度组合的示例。

以下 reStructuredText 生成您的表格：

.. flat-table:: Spanning table cells
   :header-rows: 2

   * - :rspan:`1` Col 1
     - :rspan:`1` Col 2
     - :rspan:`1` Col 3
     - :cspan:`2` Col 4

   * - Col 4a
     - Col 4b
     - Col 4c

   * - 1
     - 2
     - 3
     - 4a
     - 4b
     - 4c

请注意，如果您将 header-rows 选项设置为 1，linuxdoc 会生成格式错误的表。

【讨论】：