如何自定义Sphinx RtD Theme默认搜索设置?

时间:2017-05-24 09:22:33

标签: python-sphinx read-the-docs

如何覆盖Sphinx RTD主题附带的默认搜索html。我在Sphinx 1.5上,主题总是导入而不是静态。

1 个答案:

答案 0 :(得分:3)

请参阅Sphinx文档中的Templating

  

要自定义文档的输出,您可以通过将与原始文件名同名的文件添加到Sphinx快速入门为您生成的结构的模板目录中来覆盖所有模板(布局模板和子模板)

     

Sphinx将首先在templates_path的文件夹中查找模板,如果它找不到它正在寻找的模板,它将回退到所选主题的模板。

在您的情况下,将已安装软件包中的RTD Sphinx主题search.html复制到模板目录中,然后根据自己的喜好进行修改。然后将templates_pathconf.py的值设置为其位置。