python - 如何使 Sphinx Autodoc 显示继承选项与 Django 类的 Intersphinx 链接一起使用？

Question

我正在使用show-inheritanceSphinx Autodoc 的选项来列出我所有类的基类。其中一些类链接到 Django 类，但不幸的是，Intersphinx 无法找到它们。

问题的原因是 Autodoc 将基类列为 (say) django.forms.widgets.Select，但 Django 仅提供 objects.inv 文件列表django.forms.Select。尽管这两个条目都是相同的类并且都是导入它们的有效方式，但这会抛出 Intersphinx。

有没有办法解决这个问题？是否还有其他列出了别名的 Django objects.inv 来源？

Answer 1

好的，我自己解决了这个问题。在我看来，最谨慎的方法是objects.inv用缺失的引用修补 Django 的文件。

我已经编写了一个 Java 代码来自动执行此操作。您可以使用它自己为任何已发布的 Django 版本创建补丁版本。

代码位于https://github.com/applegrew/sphinxutil。

此外，我还提供了objects.invDjango 版本 1.4.1 的修补文件。