私はフィルター設計 GUI を設計しており、HTML 形式を必要とする QTextBrowser で Python の scipy.signal からのドキュメント文字列を表示したいと考えています。私はdocutilsが私のために仕事をするべきだと思うので、私は試しました
from docutils.core import publish_string
from scipy.signal import remez
self.txtFiltInfoBox.append(publish_string(remez.__doc__,
writer_name='html'))
ここで、txtFiltInfoBox は QTextBrowser インスタンスです。ただし、publish_string は、docstring で検出された最初の見出し (「パラメーター」) でチョークします。
docutils.utils.SystemMessage: <string>:10: (SEVERE/4) Unexpected section title.
Parameters
----------
その理由は、メソッドの docstring 全体がインデントされており、reST マークアップが無効になっているためだと思います。docstring をデデントしたり、publish_string に特定の数の先頭の空白を無視するように指示したりする簡単な方法はありますか?
完全なコードはpyFDA projectにあります。