Python 模块中的Sphinx autodoc函数

Python 模块中的Sphinx autodoc函数,python,documentation,python-sphinx,docstring,autodoc,Python,Documentation,Python Sphinx,Docstring,Autodoc,我刚刚开始接触斯芬克斯,并愿意学习 我想在index.rst文件中将我的各种函数分成不同的部分。因此,每个函数都有自己的头 例如,如果我有一个名为test.py的python文件,在该文件中我有两个函数: def foo(): """This prints bar""" print("bar") def bar(): """This prints foo""" print("foo") 如何在index.rst中分离test.py文件中的两个函数 :mod:`

我刚刚开始接触斯芬克斯,并愿意学习

我想在
index.rst
文件中将我的各种函数分成不同的部分。因此,每个函数都有自己的头

例如,如果我有一个名为
test.py
的python文件,在该文件中我有两个函数:

def foo():
    """This prints bar"""
    print("bar")

def bar():
    """This prints foo"""
    print("foo")
如何在
index.rst
中分离test.py文件中的两个函数

:mod:`test` -- foo
.. automodule:: test.foo
   :members:
   :undoc-members:
   :show-inheritance: 
:mod:`test` -- bar
.. automodule:: test.bar
   :members:
   :undoc-members:
   :show-inheritance: 
如果我能找出如何分离函数,使它在
index.html
中看起来更干净,那就太好了!由于现在的情况,如果我只运行以下命令,则输出不是很干净:

:mod:`test` -- these are my functions
--------------------------------------------
.. automodule:: test
   :members:
   :undoc-members:
   :show-inheritance:
你可以用。像这样:

测试模块
===============
测试模块包含。。。
.. currentmodule::test
foo函数
----------------
.. 自动函数::foo
条形函数
----------------
.. 自动功能::条