它将覆盖斯芬克斯/ docutils的默认字段名称限制(Overriding the default

我使用的狮身人面像生成HTML文档的一个项目。 我大量使用的领域名单 。

当生成HTML，如果标签的lenght为至多14个字符的每个标签/值对呈现为一个单一的表行有两个细胞。

如果一个人对的标签是超过14个字符，标记/值呈现为两个表行。

我想提高包装限制为较大的值（如40）。 我发现，在限制由控制--field-name-limit docutils的的选项。 但是，我找不到如何设置通过狮身人面像这个值。

我创建了一个docutils.conf中包含以下内容的文档的根文件：

[general]
dump_settings: 1
dump_internals: 1

[html4css1 writer]
field_name_limit: 40

当我运行狮身人面像阅读文件。 的设置和内部印刷-因为在这些值的[general]部分。 间的打印的值， field_name_limit被打印到具有值40 。 尽管如此，我所描述的包装仍然出现在HTML输出。

如何设置的值field_name_limit让我得到所需的输出？

Answer 1:

狮身人面像，1.2将支持HTML作家如果没有异议docutils.conf。 https://bitbucket.org/birkenfeld/sphinx/commits/67682aca

Answer 2:

我觉得你的方法是行不通的，因为狮身人面像使用自己的HTML作家。

不过，我认为它应该工作，如果你适应的风格field_name 。 我（一次）使用了自定义的CSS文件，

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

或将其设置为一个固定的宽度。

Answer 3:

这样做的一个方法是重写延长原始的HTML商自定义狮身人面像器类的设置，并设置self.settings.field_name_limit = 0在prepare_writing(self, docnames)功能。 也就是说，这是一个有点矫枉过正，除非你已经有一个自定义生成器类...

文章来源: Overriding the default field name limit in sphinx/docutils