reStructuredText 中对 <tr> 标记的锚点引用（第一个）

Question

我有一个脚本可以使用简化的语法首先自动构建表，例如：

.. list-table::
      :widths: 5, 32
      :header-rows: 1

      * - Name
        - Default Value

      * - numVar
        - 515
      * - stringVar
        - "Hello World"
      * - arrayVar
        - [1,9,42,14,10,11,-1]
      * - booleanVar
        - true
      * - objectVar
        - {"keyA":"valueA","keyNum":3}
      * - nullVar
        - null

我想创建一个外部页面，其中包含对特定行的锚点引用，因此当用户单击它时，它会向下滚动到正确的行。例如：

 <a href="doc.html#booleanVarRow">booleanVar</a>

但是rst不会自动为tr行分配id，所以我想知道是否有办法手动分配它。像

 * - .. _booleanVarRow:  booleanVar

产生如下结果：

<tr id="booleanVarRow"> ... </tr>

甚至

<tr>
    <td><span id="booleanVarRow"></span>booleanVar</td>
</tr>

会做这份工作

谢谢！

Answer 1

找到了。这是正确的语法：

.. list-table::
      :widths: 5, 32
      :header-rows: 1

      * - Name
        - Default Value

          .. _numVarRow:
      * - numVar
        - 515

          .. _stringVarRow:
      * - stringVar
        - "Hello World"

          .. _arrayVarRow:
      * - arrayVar
        - [1,9,42,14,10,11,-1]

          .. _booleanVarRow:
      * - booleanVar
        - true

          .. _objectVarRow:
      * - objectVar
        - {"keyA":"valueA","keyNum":3}

          .. _nullVarRow:
      * - nullVar
        - null

您只需确保锚点 ( .. _something: ) 的间距与行对齐

reStructuredText 中对 <tr> 标记的锚点引用（第一个）

anchor reference to <tr> tag in reStructuredText (rst)

html

restructuredtext

python-sphinx