Latex 强制Sphinx使用longtable指令，以便在长表中正确添加分页符

我正在从事一个项目，我们将文档生成为HTML和PDF

当表格有30多行时，sphinx正确地使用Latex longtable包。 但是，对于较小的表，它使用表格式包

我的问题是有些表的行数少于30行，但由于行数很大，因此需要分页符

从我所有的阅读（具体来说，这里：）来看，似乎我应该通过指定“：class:longtable”来强制斯芬克斯使用longtable

不幸的是，我没有成功地添加此规范，因为我的表没有使用单独的指令指定

以下是如何定义我的表：

.. tabularcolumns:: |p{1cm}|p{4cm}|p{10cm}|

+--------+-----------------+--------------------------+
| Step # | Process Step(s) | Detail                   |
+========+=================+==========================+
| 1      | Testing         | Testing  Testing Testing |
+--------+-----------------+--------------------------+

我得到的所有在线示例都使用列表表或csv表，然后添加longtable命令作为相关指令的一部分。例如：

.. tabularcolumns:: |p{1cm}|p{7cm}|

.. csv-table:: Lorem Ipsum
   :file: _files/lorem-tab.csv
   :header-rows: 1
   :class: longtable

我尝试过这个，但不幸的是，它不起作用：

.. tabularcolumns:: |p{1cm}|p{4cm}|p{10cm}|
   :class: longtable

+--------+-----------------+--------------------------+
| Step # | Process Step(s) | Detail                   |
+========+=================+==========================+
| 1      | Testing         | Testing  Testing Testing |
+--------+-----------------+--------------------------+

尝试制作pdf时，会出现以下异常：

! Package array Error:  Illegal pream-token (:): `c' used.

See the array package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              

l.663 :class: longtable}

！包数组错误：使用了非法的pream令牌（：）：`c'。
有关说明，请参阅阵列软件包文档。
键入H以获得即时帮助。
...                                              
l、 663:class:longtable}

在与同事进行了一些Rubber duck调试之后，我们确定需要添加..table指令。然后，这将包装我的简单表，并为：class:定义提供一个位置

因此，我的表现在定义如下：

.. tabularcolumns:: |p{1cm}|p{4cm}|p{10cm}|

.. table:: My Table
   :widths: auto
   :class: longtable

   +--------+-----------------+--------------------------+
   | Step # | Process Step(s) | Detail                   |
   +========+=================+==========================+
   | 1      | Testing         | Testing  Testing Testing |
   +--------+-----------------+--------------------------+

这对问题进行了排序，它仍然从tablercolumns指令中读取列规范