Расширенный поиск в HTML-файлах
HTML-файлы, созданные в Dr.Explain, поддерживают два режима поиска: базовый и расширенный. Базовый поиск выполняет простой поиск по ключевым словам. Расширенный поиск обеспечивает повышенную точность за счёт анализа словоформ и синонимов.
Что такое расширенный поиск?
Расширенный поиск — это серверная система, которая обрабатывает поисковые запросы через специальный сервис на базе Docker, легко подключаемый к вашему существующему сайту документации.
Ключевые преимущества
Серверная система поиска даёт несколько преимуществ по сравнению с традиционным поиском на стороне клиента:
-
Улучшенное ранжирование результатов поиска. Более релевантные результаты отображаются вверху благодаря продвинутым алгоритмам ранжирования.
-
Фрагменты результатов поиска (сниппеты) с выделением совпадений. В результатах поиска показываются не просто ссылки на разделы, но и фрагменты текста, в которых подсвечены найденные слова.
-
Поддержка синонимов и словоформ. При поиске учитываются синонимы и грамматические формы слов (например, при поиске по слову "условие" найдутся в том числе разделы со словом "требование", а по "ребенок" — "дети").
-
Улучшенные результаты поиска по документации с большим количеством разделов. Продвинутые алгоритмы индексации и ранжирования учитывают контекст и обеспечивают высокую точность, сокращая количество нерелевантных совпадений.
-
Поддержка языка поисковых запросов. Если вам нужно найти разделы, содержащие конкретные слова или не содержащие определённых слов, вы можете использовать язык запросов расширенного поиска.
На следующих скриншотах показано сравнение результатов поиска:
|
Базовый поиск
|
Расширенный поиск
|
 |
 |
Когда использовать расширенный поиск
Серверный поиск идеально подходит для:
-
Больших массивов документации, содержащих сотни или тысячи разделов.
-
Внешней документации, где производительность поиска и релевантность результатов критически важны.
-
Корпоративных систем, где требуется централизованное управление поиском.
-
Документации, требующей расширенных функций поиска, таких как поддержка синонимов и словоформ, а также подсветка результатов.
В следующей таблице сравниваются функции базового и расширенного поиска:
|
Критерий
|
Базовый поиск
|
Расширенный поиск
|
|
Сложность настройки
|
Не требует настройки сервера
|
Требует Docker
|
|
Релевантность поиска
|
Поиск совпадений по ключевым словам
|
Продвинутые алгоритмы ранжирования
|
|
Сниппеты результатов
|
Нет
|
Да, с подсветкой
|
|
Поддержка синонимов
|
Нет
|
Да
|
|
Поддержка словоформ
|
Нет
|
Да
|
|
Инфраструктура
|
Работает на стороне клиента; инфраструктура не требуется
|
Требуется Docker
|
|
Для чего лучше всего подходит
|
Небольшие массивы документации
|
Крупные, сложные массивы документации
|
Смотрите подробные инструкции по установке.