如何使用 Python 3.5 让 Sphinx 在 PyCharm 中工作

Question

这是我第一次在 PyCharm 5.0 和 Python 3.5 中使用 Sphinx。

当我sphinx task在 PyCharm 中运行时，出现以下错误：

File "C:\Program Files (x86)\JetBrains\PyCharm 5.0\helpers\docutils\__init__.py", line 63, in <module>
    class ApplicationError(StandardError): pass
NameError: name 'StandardError' is not defined

在这个页面上，我发现在 Python 3.xStandardError中现在被替换为Exception. 但是，当我尝试编辑__init__.py文件时，PyCharm 阻止我保存它。

我还注意到它__init__.py基于 docutils 0.8 版。这并不直观，因为我在我的 virtualenv 中安装了 docutils 0.12 版。这意味着版本 0.12 被忽略。

有谁知道如何解决这一问题？

Answer 1

更新：PyCharm 5.0.2 修复了这个问题，Sphinx 运行配置在 Python 3 下工作

不幸的是，PyCharm 5.0.2 之前的帮助程序中提供的 Python 代码与 Python 3 不兼容。PyCharm 问题跟踪器有一张票。我曾经尝试修复所有的小嘘声，但后来遇到了一些更大的嘘声。

因此，只需创建一个运行配置，调用：

• Script (on Mac): /Users/paul/projects/jetbrains/env35/bin/sphinx-build
• Script parameters: -b html -d _build/doctrees . _build/html

...并将工作目录设置为您想要_build目录的位置。

编辑：添加了有关如何在 pycharm 中创建和编辑运行/调试配置的链接以及 Windows 屏幕截图。脚本位置是“脚本”而不是“bin”。

在 PyCharm 5.0 中创建和编辑运行/调试配置

PyCharm 5.0 屏幕截图（在 Windows 上）