sphinx autodoc-skip-memberハンドラー：napoleonを使用しているときに__init __（）を表示できません

Question

のドキュメントストリングをスフィンクスのドキュメントに含める必要があります。

autodoc-skip-memberのハンドラを追加するために私はthe accepted answer to this stackoverflow questionをフォローしていましたが、まだ__init__()のドキュメントを見ることができませんでした。 if name == "__init__":ブロック内のトレースコードは、そのコードに当たっていることを示しています。勘で

私は

extensions = [ 
    'sphinx.ext.autodoc', 
    # 'sphinx.ext.napoleon', 
] 

を残して、私の extensions定義から 'sphinx.ext.napoleon'を削除してから、私は __init__()マニュアルを参照してくださいすることができます。

the napoleon documentationに記載されている唯一のものはnapoleon_include_special_with_docです（デフォルトはTrue）。明示的にTrueに設定すると、conf.pyには何も変更されていないようです。

ETA：

def __blah__(self): 
    '''blah blah blah''' 
    print self.__class__ 

は私が生成されたドキュメントで__blah__()を参照してください。私は次のメソッドを追加した場合。

• 私は__repr__または__str__、 に__blah__の名前を変更した場合、私は生成されたドキュメントでそれらを参照してください。
• 私が既存の__init__をコメントアウトして変更する場合 __blah__から__init__私はそれが表示されません。

したがって、__init__()に固有のようです。

これは既知の問題ですか？また、ナポレオンを使用する際にこれを制御する別の方法がありますか？

Answer 1

https://github.com/sphinx-doc/sphinx/issues/2374のRobのパーソンで、「autodoc-skip-member」イベントのハンドラも設定する拡張子を使用している場合は、ハンドラの1つだけが使用されます。これは手元にある問題のようです。おかげでロブ！

Answer 2

ナポレオンは、__init__メソッドをどのように扱うかについて、オートドック設定を行います。

オートドックの設定をconf.pyで確認してください。特に、autoclass_contentがinitまたはbothのいずれかに設定されていることを確認してください。