1.安装mkdocs和material主题
[工欲善其事,必先利其器] - 搭建技术博客/个人主页 - 使用MkDocs和Material - 知乎 (zhihu.com)
2.添加中文搜索
MkDocs中文搜索 — Cloud Atlas beta 文档 (cloud-atlas.readthedocs.io)
pip install mkdocs
pip install mkdocs-material
pip install jieba
mkdocs new my-project
cd my-project
mkdocs serve
# mkdocs.yml
site_name: 标题
nav:
- 主页: index.md
- 测试: 测试文件.md
- 关于: about.md
#theme: readthedocs
theme:
name: material
language: zh
dev_addr: '0.0.0.0:37001'
plugins:
- search:
lang:
- en
- ja
separator: '[\s\-\.]+'