我们在Linux / OSX python环境中使用Sphinx作为文档,但我们在Windows上有人希望能够获得一个可以编辑和构建Sphinx文档的环境。
是否可以在Windows上设置Sphinx?我猜测困难的部分是安装python环境和所有依赖项,但我在Windows上有0次python经验,所以有人可能能够指出我一种直接的方式继续。
要在Windows上安装python,请下载Python。运行可执行文件,你就完成了。
如果您安装了pip,则可以打开命令提示符并输入
pip install -U Sphinx
如果您没有安装pip,那么首先需要在命令提示符下使用以下命令来安装它
python -m pip install -U pip
你现在可以使用pip-win轻松地在windows上的virtualenv中设置sphinx。
首先,下载并安装Python。如果你想使用latexpdf构建器,你还需要为windows安装TeX Live或MiKTeX。
接下来,运行pip-win.exe。它会自动拉出所需的setuptools,并在你的系统上安装pip和virtualenv。加载后它会拉出你刚刚安装的Python,但如果你将它安装在默认目录以外的位置,你可以轻松输入绝对路径或浏览它。
接下来,在Command:行中,您可以通过输入以下内容来创建新的virtualenv:
venv -c C:\foo\sphinx-venv
这将在你的virtualenv中打开一个命令提示符。在此之后,您可以使用pip命令安装sphinx:
<sphinx-venv> C:\foo\> pip install sphinx
现在,sphinx安装在Windows机器上的虚拟环境中。您可以使用停用来逃避新环境。
如果您希望再次进入virtualenv以构建更多sphinx项目,您可以打开pip-win并运行:
venv C:\foo\sphinx-venv
或者您可以创建自定义python文件来激活您的sphinx环境并构建您的sphinx文件,例如:
import os
os.system("cmd /c \"CALL C:\\foo\\sphinx-venv\\Scripts\\activate.bat && make html\"")
到目前为止,在Windows上使用Python的最简单方法是WinPython,它是一种便携式发行版,与任何其他便携式应用程序一样简单易用。它将为您提供WinPython命令提示符的图标,您可以从中使用pip等,就像在任何其他(例如Linux)系统上一样,或者您可以使用WinPython的控制面板下载软件包并安装它们。