在Sphinx autodoc中使用模块文档字符串

在Sphinx autodoc生成的文档中,我希望每个模块都有一个介绍文本。我的逻辑这与模块docstring有关。但是Sphinx忽略了它,因为它在生成的HTML文件中没有出现。

# -*- coding: utf-8 -*-
import mypackage

"""This is the modules docstring.
"""


def bar(bar):
    """
    This is the function named bar.

    Parameters:
        bar (str): Just a parameter.

    Returns:
        str: Just an 'a'.
    """
    mypackage.foo(bar)
    return('a')

我不确定这是否在斯芬克斯的概念中,或者斯芬克斯是否希望我以另一种方式意识到这一点。

但重点是我不想,但文件 rst -文件。每个文档内容都应该来自 py -文件本身。