相关疑难解决方法(0)

自定义`sphinx-apidoc`的模板

我一直在使用最近尝试狮身人面像,apidoc狮身人面像,以帮助生成从Python项目的API狮身人面像的具体reStructuredText的.

但是,我得到的结果是:

<code>sphinx-api</code>用于其输出?具体来说,我想:</p>

<ul>
<li>摆脱所有

  • 我的__init__.py文件中的docstring结果直接显示在包下面,因此,如果我单击包名,我首先看到的是包文档.目前,本文档位于每个软件包部分末尾略微奇怪的"模块内容"标题下.
  • 我认为"Submodules"和"Subpackages"标题是多余的,因为包/模块的正常标题是"xxx.yyy package"和"xxx.yyy.zzz module".

    我希望上面这个小例子的结构是

    • orexplore.components包
      • orexplore.components.mbg120模块
    • orexplore.simulators包
      • orexplore.simulators.test包
        • orexplore.simulators.test.mbg120模块
      • orexplore.simulators.mbg120模块

    点击包的地方,我在页面上看到的第一件事就是包文档.

    或者甚至只是

    • orexplore.components
      • orexplore.components.mbg120
    • orexplore.simulators
      • orexplore.simulators.test
        • orexplore.simulators.test.mbg120
    • orexplore.simulators.mbg120

    如果有一些方法可以在视觉上区分包/模块(颜色?会徽?)而不是相当冗长的"包"和"模块".

    python python-sphinx

    14
    推荐指数
    3
    解决办法
    3323
    查看次数

    标签 统计

    python ×1

    python-sphinx ×1