Question

我想在另一个模块（say module_2.py）的另一个方法中添加一个模块（say module_1.py）的方法的链接。我希望该链接可以在Sphinx中使用。

假设：

module_1.py

class ABC:
   def foo(self):
      """
     See docstring of module_2.py bar():<link to bar() in module_2.py>
      """
      print("foo")

module_2.py

class XYZ:
    def bar(self):
    """
     This function prints hello.
    """
    print("hello")

Answer 1

要真正获得超链接，您的方法引用需要包含完整的路径。创建任何链接的最简单方法是使用:obj:交叉引用：

"""See docstring of :obj:`path.to.module_2.XYZ.bar`."""

请参阅path.to.module_2.XYZ.bar的文档字符串。

您可以使用tild ~将锚文本缩短到路径的最后一个元素：

"""See docstring of :obj:`~path.to.module_2.XYZ.bar`."""

请参阅bar的文档字符串。

或这样指定custom text：

"""See docstring of :obj:`XYZ.bar <path.to.module_2.XYZ.bar>`."""

请参阅XYZ.bar的文档字符串。

这可能是最易于阅读的解决方案。

为完整起见，请注意:obj:是一般的无类型引用，但是Sphinx为several other categories of cross-reference提供了一些特定的行为。

Answer 2

你可以写：

class ABC:
  def foo(self):
    """
    See docstring of :py:meth:`bar() <XYZ.bar>` in :py:mod:`module_2`.
    """
    print("foo")

显示的标记使用角色链接到已记录的元素。如果Python是文档的默认域，则可以省略:py。角色meth链接到方法名称。可以使用带点的名称。同样，mod链接到模块名称。角色的内容写在``之间。内容（逻辑链接名称可以具有不同的可视内容。因此，逻辑链接名称写在<>中。示例：:role:`text <logical name>`。

更多信息：http://www.sphinx-doc.org/en/stable/domains.html#role-py:meth

链接到python docstring中另一个模块的类方法

2 个答案: