在 reStructuredText CSV 表中创建引用

【问题标题】：Create a reference inside a reStructuredText CSV table在 reStructuredText CSV 表中创建引用
【发布时间】：2019-02-21 11:51:45
【问题描述】：

我有一个这样的 CSV 表

.. csv-table::
   :header: Name, BrowseName, DataType, Description
   :widths: 16,16,16,52

   "Enabled", "Enabled", "Boolean", "Alarm can..."

我想在 HTML 输出中创建对一行的引用。我试图将.. _reference: 放在表中的每个位置，但要么出现编译错误，要么出现空单元格。我也尝试使用 reST 替换定义，但没有成功。

你知道是否有办法在那种表中添加这样的引用或引用只在网格表中有效？

【问题讨论】：

标签： python-sphinx restructuredtext

【解决方案1】：

您可以在 CSV 中插入任意 reST，类似于 this answer。对齐很棘手，所以我建议将所有内容统一缩进 4 个空格。根据 Sphinx 在 :ref: role 上的文档，标签插入第二行，并且必须为 :ref: 指令指定标题和标签。

:ref:`link to hello <mylabel>`

.. csv-table:: Test csv-table with multi-paragraph
    :header: "a", "b", "c"

    Cat,"Chunk that is updated periodically via copy-and-paste.

    Line #2, #3, etc", "Kitten"
    Dog,".. _mylabel:

    Hello", "Puppy"
    Walrus,"#.  List Item 1
    #.  List Item 2
    #.  List Item 3", "Pup"

【讨论】：