python-sphinx - 在Sphinx中向表添加类？

Question

我在rst中有一个表，在用Sphinx编译为HTML时，我想向它添加一个类。根据the docs的说法，在表之前添加.. class::指令应将类添加到表中，但是会添加定义列表。

表代码为:

.. class:: special

== == ==
a  b  c
1  2  3
== == ==

结果是:

<dl class="class">
<dt id="special">
<em class="property">class </em><code class="descname">special</code><a class="headerlink" href="#special" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>

<table border="1" class="docutils">
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td>a</td>
<td>b</td>
<td>c</td>
</tr>
<tr class="row-even"><td>1</td>
<td>2</td>
<td>3</td>
</tr>
</tbody>
</table>

我究竟做错了什么？我正在使用Sphinx 1.3.1

Answer 1

Sphinx的默认域是Python，它包含一个class指令，该指令用相同的名称遮盖了原始Docutils指令。

要使其工作，请改为使用rst-class:

.. rst-class:: special

== == ==
a  b  c
1  2  3
== == ==

参见 http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#id2。