如何在html输出中禁用突出显示

Question

我使用make html生成Sphinx文档.一切都很好.但是当我使用搜索功能时,我会得到一个附加搜索词的链接,如下所示:

http://url/search.html?q=searched&check_keywords=yes&area=default
http://url/module.html?highlight=searched

事情是亮点(上面的"搜索")始终存在.禁用它的唯一方法是手动编辑浏览器中的URL.

有没有其他方法可以在没有突出显示部分的情况下链接到文档？

Platform: windows
Sphinx version: 1.1.3

问候,罗伯特

Answer 1

突出显示的文本由元素呈现<span class="highlighted">searched</span>。默认的 CSS 规则（在 basic.css 中）是这样的：

dt:target, span.highlighted {
    background-color: #fbe54e;
}

您可以在自定义 CSS 文件（我们称之为 custom.css）中使用以下内容覆盖此规则：

/* Assume that the 'alabaster' theme is used */
@import url("alabaster.css");
 
/* No search term highlighting */
span.highlighted {
    background-color: transparent;
}

将 custom.css 放入_staticSphinx 项目的文件夹中，并在 conf.py 中添加或修改以下行：

html_static_path = ["_static"]
html_style = "custom.css"

以上禁用了“搜索结果”页面和每个链接页面上的突出显示。

使用 Sphinx 1.6.5 进行测试（1.1.3 相当旧）。