Я хотел бы ссылаться на ранее зарегистрированный параметр функции в другом месте в docstring Python. Рассмотрим следующий (предположительно, полностью искусственный) пример:
def foo(bar):
"""Perform foo action
:param bar: The bar parameter
"""
def nested():
"""Some nested function that depends on enclosing scope bar parameter.
I'd like to reference function foo bar parameter here
with a link, is that possible?"""
return bar * bar
# ...
return nested()
Есть ли простой способ вставить ссылку на параметр с помощью разметки Sphinx, или это произойдет автоматически?
(Я полный новичок Sphinx. Я просматривал документы Sphinx и не нашел ответа на этот вопрос или пример, демонстрирующий правильную разметку.)