狮身人面像智能表(reStructuredText)

Question

是否有在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

使用利努克斯多扩展来使用平面表。

Answer 1

首先，安装linuxdoc Python包：

pip install linuxdoc

接下来，将linuxdoc.rstFlatTable添加到狮身人面像项目的conf.py的扩展列表中：

extensions = [
    'linuxdoc.rstFlatTable',
]

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

注意，如果将头-行选项设置为1，linuxdoc将生成格式错误的表。