Sphinx 自动摘要生成表中的自动换行

问题描述

我使用 Sphinx 为我的项目生成文档,扩展名为 autosummary。它会生成一个包含我的模块名称及其摘要的表格。

这是结果的图像:

Table generated by autosummary

但是,行太长,我们必须使用滑块来阅读整个说明。

我想换行描述文本,去掉滑块。我到处搜索,一无所获。

我尝试将 | xxxx<br /> xxxx 添加到我的描述中,但没有奏效。

先谢谢你!

解决方法

用您自己的样式覆盖表格上的 CSS。具体:

.wy-table-responsive table td,.wy-table-responsive table th {
  white-space: normal;
}

应该解决大部分问题。或者使用在其样式中不使用滚动表的主题。