在reStructuredText CSV表中创建引用

Question

我有这样的CSV表

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

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

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

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

Answer 1

您可以在CSV中插入任意reST，类似于this answer。对齐很棘手，因此我建议将所有内容均匀地缩进4个空格。根据:ref:上的Sphinx文档，标签插入第二行，:ref: role指令必须同时给出标题和标签。

: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"