擅长:python、mysql、java
<p>我使用<a href="http://epydoc.sourceforge.net/" rel="noreferrer">epydoc</a>而不是狮身人面像,所以这个答案可能不适用。</p>
<p>您描述的用于记录方法和函数的structuredText语法并不是唯一可能的语法。到目前为止,我更喜欢使用<a href="http://epydoc.sourceforge.net/manual-othermarkup.html" rel="noreferrer">consolidated definition list</a>来描述参数,这与Google的方式非常相似:</p>
<pre><code>:Parameters:
path : str
The path of the file to wrap
field_storage: FileStorage
The FileStorage instance to wrap
temporary: bool
Whether or not to delete the file when the File instance is destructed
</code></pre>
<p>如果sphix支持我会试试的。如果没有,你也可以考虑使用epydoc来解决这个问题(尽管现在还没有那么积极的维护)。</p>