在 reStructuredText (rst) 中锚定对 <tr> 标记的引用答案

【问题标题】：anchor reference to <tr> tag in reStructuredText (rst)在 reStructuredText (rst) 中锚定对 <tr> 标记的引用
【发布时间】：2015-05-04 16:19:08
【问题描述】：

我有一个使用简化语法自动在 rst 中构建表格的脚本，例如：

.. 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 不会自动将 ids 分配给 tr 行，所以我想知道是否有办法手动分配它。类似的东西

 * - .. _booleanVarRow:  booleanVar

产生如下结果：

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

甚至

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

会做的工作

谢谢！

【问题讨论】：

标签： html python-sphinx restructuredtext

【解决方案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: ) 与行对齐

【讨论】：