我一直在使用最近尝试狮身人面像,apidoc从狮身人面像,以帮助生成从Python项目的API狮身人面像的具体reStructuredText的.
但是,我得到的结果是:
__init__.py文件中的docstring结果直接显示在包下面,因此,如果我单击包名,我首先看到的是包文档.目前,本文档位于每个软件包部分末尾略微奇怪的"模块内容"标题下.我认为"Submodules"和"Subpackages"标题是多余的,因为包/模块的正常标题是"xxx.yyy package"和"xxx.yyy.zzz module".
我希望上面这个小例子的结构是
点击包的地方,我在页面上看到的第一件事就是包文档.
或者甚至只是
如果有一些方法可以在视觉上区分包/模块(颜色?会徽?)而不是相当冗长的"包"和"模块".