Sphinx создает ссылки в списке переменных на классы с одинаковыми именами - PullRequest
0 голосов
/ 28 сентября 2018

Я использую расширение apidoc в Sphinx для создания документации для проекта 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, которую я не могу изменить.

Есть ли простой способостановить эти ссылки от вставки?

...