我正在使用 Sphinx 的 apidoc 扩展来为 Python 项目生成文档。这比我预期的要古怪,但我已经完成了大部分工作。然而,一个怪癖让我难住了。
我有几个带有文档字符串的类,其中包括以下内容:
"""
:ivar normal_attr1: This is a normal attribute.
:ivar doppleganger: This is an attribute with the same name as a class in
another module.
""""
Sphinx 会自动添加一个从“doppleganger”到它共享名称的类的链接——我找不到阻止它的方法。在一般情况下,我只会更改其中一个名称,但不幸的是,这两个名称均来自我无法更改的 XSD 规范自动生成的代码。
有什么简单的方法可以阻止这些链接被插入?