如何为 Sphinx 自定义模块名称

Question

就狮身人面像而言，我是新手。我的项目结构如下：

• argparse_actions/
  • argparse_actions/
    • __init__.py
    • folder_actions.py
    • ip_actions.py
  • 文档/
    • _建造/
    • index.rst ==> 这是起点、主页或根文档。
    • 和更多...

__init__.py 看起来像这样：

from folder_actions import *
from ip_actions import *

folder_actions.py看起来像这样：

'''
Folder Actions
==============

This module implements some reusable custom actions.

.. autoclass:: FolderExistsAction
.. autoclass:: FolderCreateAction
   :members:

'''

# The rest of the code

生成的 HTML 文档看起来不错，除了这部分：

类folder_actions。FolderCreateAction ( ... )

我知道folder_actions模块前缀是正确的，但我想将其更改为使用包名称，如下所示：

类argparse_actions。FolderCreateAction ( ... )

有没有办法让我实现这一目标？

更新

• 根文件在 doc/index.rst

• 如果我将文档字符串从folder_actions.pyto移动__init__.py，则文档将如下所示：

  class __init__.FolderCreateAction( ... )
  

• 仅供参考，我的项目现在在BitBucket 上

更新 2

我不知道为什么我的更改没有推送到 BitBucket，但这无关紧要。请看一下推送到GitHub的同一个项目。我感谢你的帮助，mzjn。

Answer 1

经过几个月的中断，我终于找到了解决方案：通过将以下行添加到folder_actions.py和ip_action.py模块的文档字符串中：

.. module:: argparse_actions

优选地，该行应该是模块文档字符串的第一行。