最近要了解API接口文档工具,故而了解到MkDocs ,这个工具用来写静态的API文档看起来不错
MkDocs需要 Python 和 Python package manager pip,而我的环境是Mac OS X 10.10.5 系统默认已经安装好Python,需要再安装pip,从pip官网了解到Python 2.7.9之后版本(在python2系列),和Python 3.4及之后的版本已经包括pip,但在系统中执行
laicreasydeMacBook-Pro:~ lai$ python --version
--version Python 2.7.10
laicreasydeMacBook-Pro:~ lai$ pip --version
-bash: pip: command not found
却没有找到pip命令,再度执行
laicreasydeMacBook-Pro:site-packages lai$ whereis pip
laireasydeMacBook-Pro:site-packages lai$ which pip
才发现系统根本没有安装pip,而到了引用的网址上看更印证了只有Python3.4之后的版本才默认安装pip
pip is the preferred installer program. Starting with Python 3.4, it
is included by default with the Python binary installers
于是自己安装。按照pip官网的提示,先下载get-pip.py(这个文件比较难下载下来,我下了几次都失败了,附件中我给出这个文件),然后执行
sudo python get-pip.py
输入密码,即可安装。加sudo是因为需要root权限,否则报错(Permission denied)
另外,Mac下若无必要,不用更新Python(我没尝试,2.7已经够我需求了,详见http://segmentfault.com/q/1010000000532208)
pip下载地址:http://download.csdn.net/download/creasylai19/9098161