Rozwiązywanie konfliktów nazw w odnośnikach w Sphinxie z intersphinxem

Question

Piszę dokumenty dla mojej biblioteki Pythona Używając sphinx, dodałem także inną dokumentację sphinx z intersphinx. I działa całkiem nieźle, ale kilka moich funkcji nazywa się tak samo jak w dokumentacji referencyjnej, co prowadzi do zacieniania ich nazw dla odniesień :func:....

Czy istnieje sposób, w jaki mogę odwołać się do funkcji ukrytej do_some() w innej dokumentacji? (:func:`do_some` tworzy link do mojej funkcji do_some())

Answer 1

Według docs można użyć identyfikatora ze swojego intersphinx_mapping jako przedrostek do celu. Przykład:

:ref:`comparison manual <python:comparisons>` 

Myślę, że powinno to działać również w przypadku pracy z funkcjami.