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

2024-01-09

我在用sphinx http://sphinx.pocoo.org/用于为项目生成 html 文档。我广泛使用字段列表 http://docutils.sourceforge.net/docs/user/rst/quickref.html#field-lists.

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

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

我想将换行限制增加到更大的值(例如 40)。我发现限制是由--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这样我就能得到想要的输出?


如果没有异议,Sphinx-1.2 将支持 html writer 的 docutils.conf。https://bitbucket.org/birkenfeld/sphinx/commits/67682aca https://bitbucket.org/birkenfeld/sphinx/commits/67682aca

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

覆盖 sphinx/docutils 中的默认字段名称限制 的相关文章

随机推荐