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

【问题标题】：How to get Sphinx working in PyCharm with Python 3.5如何使用 Python 3.5 让 Sphinx 在 PyCharm 中工作
【发布时间】：2016-03-03 16:35:45
【问题描述】：

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

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

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 将被忽略。

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

【问题讨论】：

标签： python-3.x pycharm virtualenv python-sphinx docutils

【解决方案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 屏幕截图。脚本位置是 'Scripts' 而不是 'bin'。

Creating and Editing Run/Debug Configurations in PyCharm 5.0

PyCharm 5.0 屏幕截图（在 Windows 上）

【讨论】：