Python文档字符串中的csv表格式（Sphinx） - 一个单元格中的多行

Question

我正在使用Sphinx来记录Python项目。

似乎与.. csv-table::指令存在一些不一致。

主要问题是单元格中的新行。还有我可疑的心理健康。

以下代码：

.. csv-table::
    :header: Header1, Header2, Header3

    A, B, "These lines appear as one line, 
    even though they are written in two lines."
    C, D, "| These lines appear as two lines, 
    | but they are indented, and my OCD will simply not allow it."
    E, F, "| If I continue this line in another line,
    it will appear in a new line."
    G, H, "If there is a blank line between the two lines,

    there will be a blank line between the lines."

将呈现为：

我搜索了整个reStructuredText手册，但找不到解决方法。

有没有办法在一个单元格中写入两行，这些行将显示为第二行，但没有缩进？

主题是sphinx_rtd_theme。

我找到了theme.css文件（C：\ Python34 \ Lib \ site-packages \ sphinx_rtd_theme \ static \ css \ theme.css），但我找不到换行样式的表定义部分

Answer 1

行块在 sphinx_rtd_theme 中有左边距值。摆脱它们的一种方法是创建一个自定义CSS文件，该文件导入主题的样式规则，并为没有该边距的表格中的行块添加规则。假设Sphinx项目的标准文件和路径名：

在Sphinx项目中创建一个_static/css/mystyle.css文件，其中包含以下内容：

@import "theme.css";

table.docutils div.line-block {
    margin-left: 0;
}

将以下选项添加到conf.py：

html_style = 'css/mystyle.css'

重建Sphinx项目。