Python模块参考Sphinx文档

Question

Python模块参考Sphinx文档

15

让我们考虑以下函数：

def format_send_event(self, message_identifier, payload=""):
    """
    Format a SendEvent.

    :param message_identifier: Message identifier (defined in the :py:module:`MyModule.constants` file).
    :type message_identifier: int
    :param payload: Payload of the message.
    :type payload: str
    """
    # Do something

当我使用sphinx-build编译它时，我遇到了以下错误：

...MyModule/handlers.py:docstring of MyModule.handlers.MyClass.format_send_event:3: ERROR: Unknown interpreted text role "py:module".

看起来sphinx-builder无法理解标签:py:module:。

在Sphinx中用于引用模块的标签是什么？

- FunkySayu

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Michael Rawson · Accepted Answer

根据文档，你应该使用:py:mod:来进行交叉引用。

通常，标签的较短版本似乎用于交叉引用，而较长的名称用于文档记录。