次のようなモジュールがあります。
#!/usr/bin/env python
#: Documentation here.
#: blah blah blah
foobar = r'Some really long regex here.'
def myfunc(val=foobar):
'''Blah blah blah'''
pass
...そして、次の.rst
ようなファイルがあります。
:mod:`my_module` Module
-----------------------
..automodule:: my_module
:members:
:private-members:
:show-inheritance:
ドキュメントをビルドすると、次のようなスニペットを含む html ファイルが得られます。
mymodule.foobar. foobar = 'とてつもなく長く醜い正規表現がここにある'
追加のドキュメントはこちら
私のモジュール。myfunc ( val='とてつもなく長く醜い正規表現がここにある' )
何とか何とか何とか
このstackoverflowの投稿に基づいて、モジュールを次のように変更することで変更できると思いました:
#!/usr/bin/env python
#: .. data:: my_module.foobar
#: Extra documentation here
foobar = 'Some really long regex here.'
def myfunc(val=foobar):
'''.. function:: my_module.myfunc(val=foobar)
Blah blah blah'''
pass
...しかし、それはうまくいきませんでした。体の一部として、醜いものの下に必要な署名を追加しただけです。これを適切にオーバーライドする方法を誰かが知っていますか?
(私はSphinx v1.1.3を使用しています。)