将 CSS 类添加到 Sphinx 表格单元格

Question

有没有办法将 CSS 类添加到 Sphinx 生成的 HTML 表中？例如，我想修改以下RST表定义：

+-------+
| cell1 |
+-------+
| cell2 |
+-------+

生成以下 HTML（大致）：

<table>
    ...
    <tbody>
        <tr><td>cell1</td></tr>
        <tr><td class="someClass">cell2</td></tr>
    </tbody>
</table>

以下 RST 将指定的类添加到单元格内的新段落元素（而不是单元格本身）：

+--------------------------+
| cell1                    |
+--------------------------+
| .. rst-class:: someClass |
| cell2                    |
+--------------------------+

有没有办法修改原来的RST源码来生成指定的HTML表格？

Answer 1

不，不幸的是，在标准 rST 中无法做到这一点。

“class”指令（Sphinx 中的“rst-class”）在其内容或紧随其后的第一个非注释文档树元素上设置类属性值。由于表格单元格嵌套在表格行元素中，因此无法将类参数值传递给第一列中的单元格。

作为解决方法，您可以使用

+--------------------------+
| cell1                    |
|                          |
| .. rst-class:: someClass |
+--------------------------+
| cell2                    |
+--------------------------+

在第二个

<tr>

上获得“someclass”并使用

tr.someclass:first-child:

选择器。

（请注意，类值已

标准化。）