如何更改语言插件“搜索”?

时间:2018-07-12 12:39:59

标签: markdown mkdocs

我使用Markdown。有一个名为搜索的插件。在此插件中,无法使用俄语搜索单词,但可以搜索英语单词。如何在此插件中搜索英语和俄语单词?

1 个答案:

答案 0 :(得分:1)

MkDocs版本0.17和更早版本仅支持英语搜索。 MkDocs依靠lunr.js进行搜索,而lunr.js本身仅支持英语。因此,当前无法支持其他语言。

但是,MkDocs的搜索插件最近refactored使用了Lunr Languages(还有其他更改),并且该更改将在MkDocs 1.0版中可用,预计将在接下来的几个版本中发布周(我是MkDocs开发团队的成员)。可以在here中找到有关新功能的文档的预览,并将其复制到下面以供将来参考。

提醒一下,下面的文档仅适用于尚未发布的MkDocs 1.0版

  搜索      

MkDocs默认提供一个搜索插件,该插件使用   lunr.js作为搜索引擎。以下配置选项是   可用于更改搜索插件的行为:

     

...

      lang      

将搜索索引构建为时要使用的语言列表   由其ISO 639-1语言代码标识。使用Lunr Languages,   支持以下语言:

     
      
  • da:丹麦语
  •   
  • du:荷兰语
  •   
  • en:英语
  •   
  • fi:芬兰语
  •   
  • fr:法语
  •   
  • de:德语
  •   
  • hu:匈牙利语
  •   
  • it:意大利语
  •   
  • jp:日语
  •   
  • no:挪威语
  •   
  • pt:葡萄牙语
  •   
  • ro:罗马尼亚语
  •   
  • ru:俄语
  •   
  • es:西班牙语
  •   
  • sv:瑞典语
  •   
  • th:泰语
  •   
  • tr:土耳其语
  •   
     

您可以contribute additional languages

     

警告:

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']