バージョン 3.0.1 の epydoc を使用します。
私はこの簡単なことを試しました:
def SetNetwork(self, PyLabNetwork net):
"""
Set the net !!!
@param self: How long they should think.
@type self: C{int} or L{PyLabNetwork}
@param net: How long they should think.
@type net: C{int} or L{PyLabNetwork}
"""
self.network = net
これを実行しました:
epydoc -v -o ./html --name epydoc --css white --docformat epytext cyelp
しかし、epydoc によって作成された html では、メソッド プロトタイプは、記述されたパラメーターの代わりに 3 つの連続したドットで表示されます。
SetNetwork(...) << ??? NOTHING INSIDE ???
Set the net !!!
Parameters:
self (int or PyLabNetwork) - How long they should think.
net (int or PyLabNetwork) - How long they should think.
何か案が ?どうもありがとう
編集:申し訳ありませんが、完全に機能する簡単なスクリプトをテストしました。Cython でコンパイルされた共有オブジェクト (.so) であるため、前のケースは機能しませんでした。それは違いを生みます。ソースも表示できません。関数プロトタイプの解析に関して、epydoc は docstring のみに取り組んでいると思っていましたが、それよりも少し複雑なようです...
EDIT2:さらに、「embedsignature」cythonコンパイルディレクティブを「True」に渡してコンパイルすると、何かが得られます-これはまだ間違っていますが、現象をよりよく理解しています:
SetNetwork(...)
PyLabNode.SetNetwork(self, PyLabNetwork net)
Set the net !!!
Parameters:
self (int or PyLabNetwork) - How long they should think.
net (int or PyLabNetwork) - How long they should think.
別名 : epydoc は、cython 化された署名が埋め込まれている方法を理解していません...
もっと具体的な説明があれば、私はまだあなたの男です. ありがとう