首先安装python3.5,配置好环境变量
注意:我python3.5用的是python.exe,默认对应pip,2.7用的是python2.exe,使用pip2安装操作,
安装mkdocs,因为我有两个python环境,所以带上我的python版本运行,以下操作都是两个版本的,选择其一即可
pip install mkdocs //python3
pip2 install mkdocs //python2
附带python2的环境,安装有问题时尝试 pip2 install mkdocs==1.0.4 这样安装指定版本
其次安装material
pip install mkdocs mkdocs-material //python3
pip2 install mkdocs mkdocs-material //python2
若下载慢,可更换安装源为豆瓣
pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material
新建项目
python -m new my-project // python3
python2 -m new my-project // python2
会生成my-project目录,进入该目录里,可以看到默认放置了一些文件,包括mkdocs.yml,这是主配置文件
使用主题
mkdocs.yml里添加:
theme:
name: material
运行
进入my-project目录里,执行,
python -m mkdocs serve // python3
python2 -m mkdocs serve // python2
主要是看你配置的python运行代码是什么,比如上边我设置python2运行的就是用的python2.exe。
通过浏览器访问本地ip的8000端口(比如http://127.0.0.1:8000/) 查看效果