Mkdocs项目文档生成器（配置安装）

Mkdocs项目文档生成器（配置安装）

中文文档

• 由于Mkdocs的使用需要python环境，所以首先需要配置python环境
• 首先下载python安装程序包，由于python2比较流行我就以python2.x来说明使用方法。
• Python最新源码，二进制文档，新闻资讯等可以在Python的官网查看到：

Python官网
python2.7的下载页面地址

选择对应的系统：

1. 下载之后，双击打开，直接下一步下一步直到完成。过程中可以自定义安装目录，这里不做介绍了。
2. 安装成功之后需要配置环境变量。打开控制面板->系统和安全->系统->高级系统设置->环境变量，配置系统环境变量，然后加入Path中（配置自己的安装目录）：

D:\Python\Python27\; D:\Python\Python27\Scripts\

1. 为了以后可以按照python3 可以在安装目录中更改python.exe为python2.exe如图
   
2. 打开cmd运行窗口输入python2 -V 验证是否安装成功如图：
   
3. 安装pip。由于python2.7 自带了pip所以就不用安装了。它的目录在
   D:\Python\Python27\Scripts 即Scripts目录下
   如图
   
4. 在cmd中输入 pip –version查看版本，由于我用这个方式有异常目前还没有解决，如图
   

5. 我尝试着解决方法有
   更新pip

   python2 -m pip install –upgrade pip

6. 目前没有解决所以我只能费点事多写几行代码如图

python2 -m pip -V

• 到此Mkdocs所需要的环境都安装好了。接下来就是安装Mkdocs了

运行

pip install mkdocs

如果和我遇到同样的问题就需要多写些代码如

python2 -m pip install mkdocs

等待几分钟就可以安装完成了，检查是否安装成功

mkdocs -h

如图

到此就安装完成了，大家一起学习怎么使用吧！越努力越幸福！