如何定制Sphinx RTD主题默认搜索设置？ [英] How do I customize Sphinx RtD Theme default search settings?

问题描述

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

推荐答案

请参阅Sphinx文档中的Templating。

要自定义文档的输出，您可以覆盖所有模板(布局模板和子模板)，方法是将与原始文件名相同的文件添加到Sphinx QuickStart为您生成的结构的模板目录中。

Sphinx将首先在TEMPLATES_PATH的文件夹中查找模板，如果在那里找不到它要查找的模板，它将回退到所选主题的模板。

在您的例子中，将RTD Sphinx主题的search.html从您安装的包复制到您的模板目录中，并根据您的喜好对其进行修改。然后将conf.py中的templates_path的值设置为其位置。

这篇关于如何定制Sphinx RTD主题默认搜索设置？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！