我使用sphinx为项目生成html文档,并大量使用字段列表。
生成html时,如果标签长度不超过14个字符,则每个标签/值对将呈现为单个表行具有两个单元格。
如果一个标签的长度超过14个字符,则该标签/值将呈现为两个表行。
我想将换行限制提高到更大的值(例如40)。我发现限制由docutils的--field-name-limit
选项控制。但是,我无法找到如何通过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
的值,以获得期望的输出?