如何在html输出中禁用突出显示 [英] How to disable highlighting in html output

问题描述

我使用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

问候， 罗伯特

推荐答案

突出显示的文本由<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放在您的Sphinx项目的_static文件夹中，并添加或修改the following lines in conf.py：

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

以上操作将禁用搜索结果页和每个链接页上的突出显示。

使用Sphinx 1.6.5测试(1.1.3相当旧)。

这篇关于如何在html输出中禁用突出显示的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！