使用mkdocs管理文档

想把leetcode刷题记录放在博客上，但是博客弄得比较花哨，不适合放这种过于严肃的东西🤠。在网上浏览看到了这位大佬的博客——SMSLIT，使用了mkdocs来管理，看起来条理清晰，简单大方。于是我也准备搭建自己的mkdocs。

1. 下载mkdocs

打开命令行，使用pip下载mkdocs(pip下载速度慢的可以看我这篇文章——Windows下给pip换为国内源)

没有安装python的小伙伴自行搜索一下哈，很简单，这里就不多赘述了。

1	pip install mkdocs

查看版本，如下图说明安装成功

2. 新建MyDocs

使用命令

1	mkdocs new MyDocs

新建MyDocs。

类似于Hugo、Hexo静态博客，切换进MyDocs文件夹，目录结构如下

- docs
mkdocs.yml

其中mkdocs.yml是配置文件，docs是放文档的目录。

3. 在本地启动mkdocs

1	mkdocs serve

注意是serve不是server！！！

在本地启动mkdocs

即在localhost:8000即可看到新建的mkdocs。

4. 修改主题

在这里选择自己心仪的主题——MkDocs Theme.

我选的是MkDocs Bootstrap Theme

使用pip进行安装

1	pip install mkdocs-bootswatch

安装后在配置文件中添加一句即可切换主题

1	theme: flatly

5. 设置子目录

配置文件当中这样写

nav:
    - 简介: index.md
    - about: 
      - 'hey': 'hey.md'

6. Markdown扩展

这个主题的官方文档里没有具体说明，直接写文章的话有些markdown语法它识别不出来。我找了半天👀，发现Material for MkDocs主题中介绍了pydown，所以我就直接把这个配置拿过来了，使用Bootstrap主题也可以正常使用。

markdown_extensions:
  - admonition
  - codehilite:
      guess_lang: false
      linenums: false
  - toc:
      permalink: true
  - footnotes
  - meta
  - def_list
  - pymdownx.arithmatex
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:pymdownx.emoji.to_png
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tasklist
  - pymdownx.tilde