PyCharm 中的 Sphinx 新手

Question

我正在使用 PyCharm 作为我的 IDE 来创建我的 python 应用程序。据我了解，它具有基于两个不同程序的内置文档功能，其中一个是 Sphinx。

我正在尝试设置我的文件夹，但我发现要么缺少有关如何完成此操作的文档，要么我遗漏了一些基本内容。

我的项目文件夹结构如下

app/ - for my main application
plugins/plugin_names/version_id/ - Folder for plugins to main application can use
sphinx/doc/ - setup folder for sphinx generated by quick start.

现在，当我尝试通过 PyCarm 运行时。设置一个运行配置，将其输入到 spinx/doc/source 并输出到 sphinx/doc/build.

当我执行此配置时，出现以下错误

Traceback (most recent call last):
  File "C:\Program Files (x86)\JetBrains\PyCharm Community Edition 4.5.3\helpers\rest_runners\sphinx_runner.py", line 5, in <module>
    from sphinx import cmdline
  File "C:\python34\lib\site-packages\sphinx\cmdline.py", line 23, in <module>
    from sphinx.application import Sphinx
  File "C:\python34\lib\site-packages\sphinx\application.py", line 37, in <module>
    from sphinx.builders import BUILTIN_BUILDERS
  File "C:\python34\lib\site-packages\sphinx\builders\__init__.py", line 23, in <module>
    from sphinx.util import i18n, path_stabilize
  File "C:\python34\lib\site-packages\sphinx\util\i18n.py", line 15, in <module>
    from babel.messages.pofile import read_po
  File "C:\python34\lib\site-packages\babel\messages\__init__.py", line 12, in <module>
    from babel.messages.catalog import *
  File "C:\python34\lib\site-packages\babel\messages\catalog.py", line 23, in <module>
    from babel.dates import format_datetime
  File "C:\python34\lib\site-packages\babel\dates.py", line 28, in <module>
    from babel.util import UTC, LOCALTZ
  File "C:\python34\lib\site-packages\babel\util.py", line 278, in <module>
    from babel import localtime
  File "C:\python34\lib\site-packages\babel\localtime\__init__.py", line 21, in <module>
    from babel.localtime._win32 import _get_localzone
  File "C:\python34\lib\site-packages\babel\localtime\_win32.py", line 18, in <module>
    tz_names = get_global('windows_zone_mapping')
  File "C:\python34\lib\site-packages\babel\core.py", line 58, in get_global
    _global_data = pickle.load(fileobj)
TypeError: an integer is required (got type str)

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\Program Files (x86)\JetBrains\PyCharm Community Edition 4.5.3\helpers\rest_runners\sphinx_runner.py", line 7, in <module>
    raise NameError("Cannot find sphinx in selected interpreter.")
NameError: Cannot find sphinx in selected interpreter.

Process finished with exit code 1

我不知道为什么它必须如此复杂我想要的只是一个程序来获取输入文件并生成和输出 html。

此致

Answer 1

原因是 bable 版本 2.0。降级到 bable 版本 1.3 解决了问题

PyCharm 中的 Sphinx 新手

New to Sphinx in PyCharm

pycharm

python-3.x

python-sphinx