如何强制Sphinx使用Python 3.x解释器

Question

我试图为一个用Python 3.x编写的项目创建文档，Sphinx是我想要使用的工具，根据official site，它的最后一个版本1.1.2与Python 3.1+兼容。我的操作系统是Archlinux，一个使用Python 3.2+作为默认Python包的Linux发行版。

安装和配置是直接的（easy_install -U Sphinx然后是sphinx-quickinstall），我从未被要求在2.x或3.x Python解释器之间进行选择。但是，当我要求Sphinx创建项目的文档时，我的代码被分析得就像是为Python 2.x编写的一样

Sphinx准备好了吗？我做错了吗？

Answer 1

在Ubuntu上，python3-sphinx是一个单独的包。就我而言，我需要安装python3狮身人面像：

sudo apt-get install python3-sphinx

你也许可以在一台机器上同时运行这两个程序，但我刚刚删除了旧的：

sudo apt-get remove python-sphinx

在此之后，我的旧makefile在Python 3代码中运行得很好。

Answer 2

安装：使用pip为python3安装sphinx（类似的pip3）。

    pip3 install -U sphinx

构建：Makefile（linux/Mac）更改。

    SPHINXBUILD   = python -msphinx

在Makefile的上面一行中，将python更改为python3（或python3.x）like

   SPHINXBUILD   = python3 -msphinx

如果默认python指向2.x版本 Python。

Answer 3

昨晚我碰到你的问题时也遇到了同样的问题。-我也在拱门上。

我想问题可能有很多不同的地方，但我的解决方案是安装了Python 2版本的python-distribute包，因此没有easy_install-2.7的easy_install-3.2。

我相信在我的例子中，错误的python-distribute版本是通过我之前尝试从pacman安装Sphinx（安装版本1.0.8）安装的，所以卸载Sphinx和所有随后不需要的依赖项pacman -Rsu python-sphinx，然后安装python-distribute就得到了正确的easy_install，然后用easy_install重新安装Sphinx，Sphinx安装将按预期工作。

如果你有其他依赖于python-distribute的东西，那么这个过程可能有点不同。但首先要尝试删除python-distribute，然后从中开始工作。

把最后那部分扔掉。今天早上太早了，我还没想清楚呢！python2-distribute和python-distribute是分开的包，我相信它们可以共存。所以，如果这是您的问题，您只需检查您是否有python-distribute（不是“2”），如果没有安装，然后确保使用easy_install-3.2安装Sphinx。

希望这对你有帮助。