python - 如何自定义 sphinx.ext.autosummary 第一个模板？

Question

Here在 Sphinx 的文档中说可以重新定义那些模板。所以我尝试将 module.rst 从 /site-packages/sphinx/ext/autosummary 复制到 source/_templates/autosummary (也尝试过source/_templates) 稍作改动。但在我重新生成文档后，一切都没有改变。

也许我应该向 .. autosummary:: 标签添加一些特定选项以指定自定义模板目录？ (在 conf.py 目录中设置正确，sphinx 也可以看到 html 模板)

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

Answer 1

如果您执行以下操作，它应该会起作用:

1. 确保 templates_path 配置变量的值在 conf py 中设置为 ['_templates']。
2. 将自定义模板放在_templates 子目录中。

3. 使用 :template:选项:

   .. autosummary::
     :template: mytemplate.rst