段落标记不在RestructuredText表格单元格中呈现

时间:2016-09-07 14:16:00

标签: python-sphinx restructuredtext docutils

我在restructuredtext中定义了下表:

+-------------------------+--------------------+
| Label                   |Description         |
+=========================+====================+
| foo                     |Two options:        |
|                         |                    |
|                         |* Thing 1           |
|                         |* Thing 2           |
+-------------------------+--------------------+
| bar                     |Bar does something. |
+-------------------------+--------------------+

当它在html中呈现时(使用Sphinx),“两个选项:”文本将包含在段落标记中。 “ Bar执行某些操作。”文本不会使用段落标记进行呈现。应用样式表时,这会导致单元格文本看起来不同:

enter image description here

是否有办法强制两种情况都采用相同的行为?

1 个答案:

答案 0 :(得分:1)

Sphinx改变CSS声明的方法:在你的conf.py中添加一行

templates_path = ['my_template_path']

并在 my_template_path 中添加文件layout.html。在那里,您可以覆盖主题的css类,这些类定义了表内容的布局。类名取决于您的主题。尝试使用浏览器的开发人员功能找到它。在我的主题中,第一段的定义是 class =“first”。在这里,我用

覆盖它
td > p.first { margin: 0; }

列表ul有 class =“last simple”,由

覆盖
td > ul.last.simple { margin: 0; }

layout.html 的格式应为

{% extends "!layout.html" %}
<style type="text/css">

/* Add class definitions here */

</style>

希望有所帮助。更多解释herethis stackoverflow-thread