覆盖sphinx/docutils中的默认字段名称限制

Question

我正在使用sphinx为项目生成html文档.我广泛使用字段列表.

生成html时,如果标签的长度最多为14个字符,则每个标签/值对将呈现为具有两个单元格的单个表行.

如果一对标签超过14个字符,则标签/值将呈现为两个表行.

我想将包装限制增加到更大的值(例如40).我发现限制是由--field-name-limitdocutils选项控制的.但是,我找不到如何通过sphinx设置此值.

我docutils.conf在文档根目录中创建了一个文件,其中包含以下内容:

[general]
dump_settings: 1
dump_internals: 1

[html4css1 writer]
field_name_limit: 40

运行sphinx时会读取该文件.打印设置和内部 - 由于部分中的值[general].在打印值中,field_name_limit打印有价值40.尽管如此,我描述的包装仍然出现在html输出中.

如何设置值field_name_limit以便获得所需的输出？

Answer 1

我认为你的方法不起作用，因为 sphinx 使用它自己的 html 编写器。

不过，我认为如果您调整field_name. 我（曾经）使用过自定义 css 文件

.field-name {
    white-space: nowrap;
}

或者将其设置为固定宽度。