mkdocs 搜索如何支持中文?

2018-11-22 09:26:06 +08:00
 zhiqiang

不知道这里用 mkdocs 的人多不。

目前 mkdocs 官方还不支持中文。

在网上找了一些方法,都无法正常搜索中文。有操作过的人来说一说?

9009 次点击
所在节点    Markdown
10 条回复
chungzhao
2018-11-22 11:51:47 +08:00
没见过 mkdocs 的项目有搜索的(或者是我看过的 mkdocs 项目很少?),用 vuepress 吧
RYAN0UP
2018-11-22 11:59:15 +08:00
zhiqiang
2018-11-22 12:34:16 +08:00
@RYAN0UP 对。这个怎么弄的?
RYAN0UP
2018-11-22 15:53:32 +08:00
@zhiqiang 不知道耶😂,好像是这个主题带的
shinytea2017
2018-11-22 16:36:55 +08:00
不想自己折腾的话, 直接使用 mkdocs-material: A Material Design theme for MkDocs

可搜索中文, 单词肯定支持, 句子不知道.
saulshao
2018-11-22 18:01:37 +08:00
我大概研究过一下,但是我对于中文搜索的需求没那么急迫,因此并没有真正实践。
原因很简单:
mkdocs 使用的主题,是一个 js 插件包,这个包建立的搜索索引,不支持任何东方语言(双字节字符集)。
为此,你可以替换那个关于搜索的插件文件,但是可能要做一些额外的配置(抱歉我没有继续研究)。
#5 提到的这个信息我头一次听说。我建议你直接根据他说的尝试一下,应该这个主题是替换过我说的插件包的。
kingsonl
2018-11-22 18:33:47 +08:00
支持的,可参考楼上思路谷哥一下有相关教程。
zhaojames077
2018-11-22 18:54:04 +08:00
我记得是需要把 mkdocs 源码里的 lunar.js 替换为国人修改的版本
zhiqiang
2018-11-27 09:21:02 +08:00
汇报一下最后的方案。

主题是没办法替换的,因为原主题已经集成了一些东西。

替换 js 文件之前就试过,没成功,而且替换之后每次升级就需要重新操作,太麻烦。

后来是自己写了一个简单的 js 文件,不用索引,直接强搜所有文档。几十个文档,也瞬间就能搜完。
ccreading
2021-01-09 00:16:50 +08:00
@zhiqiang 兄弟可以分享下写的 js 吗

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/510280

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX