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

时间:2017-03-27 10:33:45

标签: python-sphinx

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

此致 罗伯特

1 个答案:

答案 0 :(得分: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已经很久了)。