在reStructuredText中锚标引用标记(rst)

时间:2015-05-04 16:19:09

标签: html python-sphinx restructuredtext

我有一个脚本,它使用简化语法自动构建表,例如:

.. 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并不会自动将id分配给tr行,所以我想知道是否有办法手动分配它。像

这样的东西
 * - .. _booleanVarRow:  booleanVar

产生如下结果:

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

甚至

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

会完成这项工作

谢谢!

1 个答案:

答案 0 :(得分:0)

找到它。这是正确的语法:

.. 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 :)间隔开来与行对齐