4

我正在尝试使用 sphinx 来记录我正在编写的django应用程序。到目前为止，我有我的code.rst设置来查看models.py，当我运行时，make html我得到了自动文档，但是我得到了一个警告：

警告：autodoc 无法导入/查找属性“myapp.models.MyModel.image”，它报告错误：“image”，请检查您的拼写和 sys.path

整个跟踪日志是：

Traceback (most recent call last):
  File "C:\blah\lib\site-packages\sphinx\ext\autodoc.py", line 326, in import_object
    obj = self.get_attr(obj, part)
  File "C:\blah\lib\site-packages\sphinx\ext\autodoc.py", line 232, in get_attr
    return safe_getattr(obj, name, *defargs)
  File "C:\blah\lib\site-packages\sphinx\util\inspect.py", line 70, in safe_getattr
    raise AttributeError(name)
AttributeError: image

MyModel.image是一个图像场，简单地在模型上定义为：

#: image file location for ``MyModel``
image = models.ImageField(upload_to="images/")

如果我将图像更改models.Charfield为例如它运行良好。有什么原因ImageField会导致狮身人面像问题吗？

我的代码.rst：

.. automodule:: dynamicbanners.models
   :members:
4

2 回答 2

1

所以在阅读了评论之后，这似乎是 Django 的一个怪癖sphinx.ext.autodoc。希望尽快将修复程序放入 Django 1.6，否则我认为即将发布的 Sphinx 1.2 版本可能会提供解决方法，但现在我需要找到某种解决方法。

于 2013-11-14T17:25:39.187 回答
0

看起来这已在 Django 1.8 中修复 - https://code.djangoproject.com/ticket/12568

于 2015-07-17T13:46:12.970 回答