如何自定义sphinx.ext.autosummary rst模板？

Question

这里在狮身人面像的文档中说，这些模板可以重新定义。因此，我尝试将module.rst从/site-packages/sphinx/ext/autosummary复制到source/_templates/autosummary (也尝试了source/_templates)，并做了一些细微的更改。但在我重新生成文档之后什么都没变。

也许我应该在.. autosummary::标签中添加一些特定的选项来指定自定义模板目录？(在conf.py目录中，向右设置，并请参阅html模板)

UPD:源代码：https://github.com/actionless/wooper/blob/master/docs.sh

Answer 1

如果您执行以下操作，它应该会工作：

1. 确保在conf中将templates_path配置变量的值设置为['_templates']。
2. 将自定义模板放在_templates子目录中。
3. 使用:template:选项： 。。自动摘要:模板: mytemplate.rst

Answer 2

编辑:我最初在这里贴出了一个错误的答案。不过，在这里也可能有帮助。

• _

可以通过在_templates文件夹中添加一个自定义文件来“否决”默认模板。例如，如果要更改调用自动摘要指令时使用的类的模板，请在此路径下创建自定义class.rst文件：

• _templates/autosummary/class.rst

在不需要显式指定:template:的情况下，应该自动获取。