いくつかの Python コードのドキュメントを書いていますが、コメントを適切に挿入できません。.rst ファイルに書き込んだ内容と、生成された html に表示される内容の間に問題があります。次のようになります。
.rst ファイル:
.. sourcecode:: python
class Foo( argument_1, argument_2 ): # argument_1 is blabla, arg2 is..
def bar(): # method bar does ...
print 'foo' # another comment
def foo_bar(): # foo_bar method explanation
print 'foo_bar body' # ....
生成された .html ファイルでは、コメントが整列されていないことを除いて、問題なく表示されます。
.html ファイル:
class Foo( argument_1, argument_2 ): # argument_1 is blabla, arg2 is..
def bar(): # method bar does ...
print 'foo' # another comment
def foo_bar(): # foo_bar method explanation
print 'foo_bar body' # ....
それを修正する方法はありますか?Ubuntu 11.04 で gedit を使用して、このドキュメントを作成しています。タブをスペースに置き換えて、タブの幅で少し遊んでいますが、役に立ちませんでした。