python-3.x - 如何使用 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

关于this page我发现在Python 3.x StandardError现在替换为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 问题跟踪器有一张票。我曾经尝试修复所有的小问题，但后来遇到了一些更大的问题。

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

• 脚本(在 Mac 上):/Users/paul/projects/jetbrains/env35/bin/sphinx-build
• 脚本参数: -b html -d _build/doctrees 。 _build/html

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

---

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

Creating and Editing Run/Debug Configurations in PyCharm 5.0

PyCharm 5.0 屏幕截图(在 Windows 上)