Какой-то способ отключить автоматическую перекрестную ссылку на имена атрибутов в ivar
При использовании Napoleon с Google Docstrings (я не проверял NumPy, но я подозреваю, аналогичные проблемы) с napoleon_use_ivar опция установлена в Trueсоздает ссылки на имена переменных экземпляра. Эти имена, очевидно, очень распространены (такие как "имя"), и привязка их к некоторому случайному определению не помогает - есть ли способ отключить это?
Учитывая следующую строку документации:
"""
Attributes:
name (str): Friendly name
"""
Будет предпринята попытка перекрестной ссылки name в выводе html. Он жалуется на это, учитывая двусмысленность цели:
/home/nbastin/geni-lib/geni/rspec/pgad.py:docstring of geni.rspec.pgad.AdInterface:None: WARNING: more than one target found for cross-reference u'name': geni.rspec.igext.AddressPool.name, geni.rspec.vtsmanifest.GREPort.name, geni.rspec.vtsmanifest.InternalPort.name, geni.rspec.pg.
Node.name, geni.rspec.vtsmanifest.PGLocalPort.name, geni.rspec.pg.Interface.name, geni.rspec.vtsmanifest.GenericPort.name, geni.rspec.vtsmanifest.ManifestContainer.name, geni.urn.GENI.name, geni.rspec.vtsmanifest.InternalContainerPort.name
Тем не менее, он по-прежнему создает ссылку в выводе HTML - если вы нажмете на name Атрибут он с радостью отправляет вам на случайный символ, который не имеет ничего общего с текущим атрибутом. Есть ли способ отключить это поведение?
Если napoleon_use_ivar установлен в False этого не происходит, но вывод атрибута совсем не компактен и его очень трудно прочитать.
Это не специфично для Наполеона - если вы укажете атрибуты вручную ivar он также перекрестно ссылается на них так, как вы не можете контролировать:
:ivar name: Friendly name
:vartype name: str
Это все еще получает ссылку для name,