跳转至

1. 本地环境搭建

环境说明

  • python: 2.7.13

  • 依赖的python包:

    包名 模块名 版本
    mkdocs mkdocs 1.0.4
    mkdocs-material material 3.0.6
    Markdown markdown 3.0.1
    pymdown-extensions pymdownx 6.0

mkdocs-material部署

安装

pip install mkdocs mkdocs-material
若下载慢，可更换安装源为豆瓣
sudo pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material

初始化项目

mkdocs new my-project

会生成my-project目录，进入该目录里，可以看到默认放置了一些文件，包括mkdocs.yaml，这是主配置文件

修改主题

mkdocs.yml里添加:

theme:
  name: material

添加扩展

mkdocs.yml里添加:

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

可以查看我的mkdocs.yml范例，详见mkdocs.yml范例

mkdocs服务启动

# 在my-project目录里执行
mkdocs serve

通过浏览器打开 http://127.0.0.1:8000/ 查看效果