Как сменить языковой плагин "поиск"?

Question

Я использую Markdown. Есть плагин под названием поиск. В этом плагине поиск слов на русском не работает, но поиск английских слов работает. Как сделать так, чтобы поиск по английским и русским словам работал в этом плагине?

Answer 1

MkDocs версии 0.17 и более ранние поддерживают только английский для поиска. MkDocs полагается на lunr.js для поиска, и сам по себе lunr.js поддерживает только английский язык. Поэтому в настоящее время невозможно поддерживать другие языки.

Однако поисковый плагин для MkDocs был недавно реорганизован для использования языков Lunr (среди других изменений), и это изменение будет доступно в MkDocs версии 1.0, которая, как ожидается, будет выпущена в ближайшие несколько недель (я являюсь членом команды разработчиков). для MkDocs). Предварительный просмотр документации по новым функциям можно найти здесь и скопировать ниже для дальнейшего использования.

Напоминаем, что приведенная ниже документация относится только к MkDocs версии 1.0, которая еще не была выпущена.

Поиск

По умолчанию поисковый плагин поставляется с MkDocs, который использует lunr.js в качестве поисковой системы. Для изменения поведения поискового плагина доступны следующие параметры конфигурации:

...

языки

Список языков, используемых при построении поискового индекса, как определено их кодами языка ISO 639-1. С Lunr Languages поддерживаются следующие языки:

• da: Датский
• du: Голландский
• en: Английский
• fiФинский
• fr: Французский
• de: Немецкий
• hu: Венгерский
• it: Итальянский
• jp: Японский язык
• no: Норвежский язык
• pt: Португальский
• ro: Румынский
• ru: Русский
• es: Испанский
• svШведский
• thТайский
• tr: Турецкий

Вы можете добавить дополнительные языки.

Предупреждение:

While search does support using multiple languages together, it is best not
to add additional languages unless you really need them. Each additional
language adds significant bandwidth requirements and uses more browser
resources. Generally it is best to keep each instance of MkDocs to a single
language.

Замечания:

Lunr Languages does not currently include support for Chinese or other Asian
languages. However, some users have reported decent results using Japanese.

по умолчанию: ['en']