python - モジュール内の Sphinx autodoc 関数

Question

私はスフィンクスを始めたばかりで、喜んで学びます。

さまざまな機能をファイル内のさまざまなセクションに分割したいと考えていindex.rstます。したがって、各関数には独自のヘッダーがあります。

たとえば、という名前の python ファイルがtest.pyあり、そのファイル内に 2 つの関数がある場合:

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

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

index.rsttest.py ファイル内の 2 つの関数を分離するにはどうすればよいですか?

: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: