使用Sphinx自动记录Python 3文档

Question

当我运行 Sphinx 时，出现了以下错误:

"invalid syntax (DaPL.py, line 79)", please check your spelling and sys.path

然而，该文件运行得非常完美。问题出在以下这一行:

print("Warning: A value for", k, "was not specified. It will be inferred.",
    file=sys.stderr)

我该如何解决这个问题？

编辑：

我在一个自动文档正确的模块中添加了另一条有效的打印语句，并得到了相同的错误：

print('one', 'two', 'three', file=sys.stderr)

当我删除file=sys.stderr时，就不再出现错误。

- grasingerm

---

你在使用sphinx时有哪些选项？有没有办法使问题可重现？ - David Robinson

@DavidRobinson 这并不是我的 sys.path，因为我有其他一些模块可以正确地自动记录文档。 我正在使用 autodoc、viewcode 和 todo 扩展。 其余的都是快速启动的默认设置。 - grasingerm

Sphinx的主要目的并不完全是你想要实现的那个，对于你所尝试做的事情，有一个适合这项工作的http://epydoc.sourceforge.net/。 - user1797612

看起来 Sphinx 是在 Python 2 解释器上运行的。请参见 http://www.mail-archive.com/[e-mail]/msg05203.html - mzjn

@mzjn，我认为你是对的，但我不确定如何强制它使用Python 3。我已经查看了Makefile和conf.py，但没有成功。 - grasingerm

@clementine：如果您在UPDATE下面所写的解决方案解决了问题，我认为您应该将其提交为答案（并接受它），以便清楚地表明问题已得到解答。 - mzjn

Answer 1

在使用easy_install安装sphinx时，我需要指定easy_install3。这将使python3成为默认解释器。

easy_install3 sphinx

- grasingerm