python Sphinx windows 安装

本文来自sphinx官网，翻译为中文，有错误的地方，希望大家指出，网址如下:

http://sphinx-doc.org/latest/install.html

总共分为三步

1.    安装python

（略）最好按照python自己的路径去安装，不要修改路径

2.    安装easy_install

Python有一个非常强大的easy_install命令行工具，利用这个工具，我们可以通过一行命令下载和安装第三方库。这是由“setuptools”项目https://pypi.python.org/pypi/setuptools.提供的。

为了安装setuptools，打开网址： https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py，把里面的内容存储到c盘下的ez_setup.py，然后我们打开cmd，定位到c盘，运行如下代码：

C:\> python ez_setup.py

然后就如同下面这样：

然后就会下载安装包，耐心等待即可。

 

安装完成

当setuptools和它的easy_install安装之后，我们就可以使用这个工具安装Sphinx

3.    通过easy_install安装 Sphinx

运行cmd工具，输入：

C:\> easy_install sphinx

可能出现：

这个时候我们得设置环境变量。右键我的电脑，选择属性，然后按照图中1，2，3，4，5打开path，把

C:\Python27\Lib\site-packages\markupsafe-0.23-py2.7.egg

加入到Path中去，这个路径随您python安装路径的不同而不同，

 

现在在运行：

C:\> easy_install sphinx

就会出现如下图，可能不太一致

安装完成之后，可以使用sphinx-build命令查看sphinx是否安装成功

打开cmd输入：

spinx-build

可能出现不是内部或外部命令，我们只需要把下面加入环境变量的path中去就可以了

C:\Python27\Lib\site-packages\sphinx-1.2.2-py2.7.egg;

注意，这个路径应该按照实际来，打开自己的python路径的Lib文件夹找到sphinx，然后把路径复制进来，注意“;“是小写的分号。

最后，输入spinx-build，出现：

表示安装成功。

 到这里，spinx已经安装成功了， 到这个网址 FirstSteps with Sphinx ，来做你的sphinx项目吧！！