擅长:python、mysql、java
<p>不确定这是否真的回答了你的问题,但也许你找错了地方,没有找到大纲。('wrong',因为它似乎相当合理地期望它出现在您的<code>automodule</code>指令所在的位置)。从<a href="http://sphinx-doc.org/markup/desc.html" rel="nofollow">module markup</a>(emphasis mine)的文档中:</p>
^{bq}$
<p>因此对于模块注释字符串:</p>
<pre><code>"""
.. module:: CONF
:synopsis: Configuration module, tells where data files are.
continuation possible here... (though goes against the point of synopses...)
:platform: Windows
"""
</code></pre>
<p>大纲出现在模块索引中</p>
<blockquote>
<h2>c</h2>
<p>CONF <em>(Windows)</em> <em>Configuration module, ...</em>.</p>
</blockquote>
<p>或者,对于模块注释字符串(注释缩进):</p>
^{pr2}$
<p>将在您放入<code>automodule::</code>指令的地方呈现,但在模块索引中<em>不是</em>。对我来说,样式是在成员函数中呈现参数。在</p>
<p>作为一个有点讨厌的解决方法,您可以将这两个<code>:synopsis:</code>声明结合起来,尽管这显然不是很容易维护的。在</p>