Sphinx在链接Python对象方面非常出色。例如,编写以下代码:
:func:`foo.bar`
会直接链接到foo.py
中的bar
函数。我希望实现同样的功能,但不是创建可点击的链接,而是将bar()
的代码作为文本。
.. code-block:: language
指令要求您手动编写要添加的代码。但我想使用intersphinx链接到已存在于外部Sphinx项目中的代码,而不是自己编写代码。 :mod:
、:func:
等只创建链接,不包含源代码。
还有.. literalinclude:: filename
,但在我的情况下,我不能使用它,因为该函数来自Sphinx项目之外(使用intersphinx进行链接,不是实际项目的一部分)。即使.. literalinclude:: filename
可以跨项目工作,我认为我仍然需要使用:lines:
过滤每个函数,这将非常麻烦。
如何通过命名空间路径引用函数/类,并使用它将其源代码直接添加到sphinx rst文件中?(不是作为可点击的链接,而是字面上的代码)。