Как отключить выделение в html-выходе

Я создаю документацию Sphinx с помощью make html. Все в порядке с этим. Но когда я использую функцию поиска, я получаю ссылку на добавляемый термин поиска, например:

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

Выделенный текст отображается элементом <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 в папку _static вашего проекта Sphinx и добавьте или измените следующие строки conf.py:

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

Вышеуказанное отключает выделение на странице "Результаты поиска" и на каждой связанной странице.

Протестировано с помощью Sphinx 1.6.5 (1.1.3 довольно старое).