Sphinxを使用してコードのドキュメントを作成する方法を学んでいます。このような例をいくつか見た後:
def complex(real=0.0, imag=0.0):
"""Form a complex number.
Keyword arguments:
real -- the real part (default 0.0)
imag -- the imaginary part (default 0.0)
"""
if imag == 0.0 and real == 0.0: return complex_zero
...
Sphinx がコメントを理解してキャッチできるようにするために、コメントで使用される言語は何ですか? この構文とロジックがないと、Sphinx はコード内のコメントを認識せず、HTML を生成するとモジュールが空になります。
ここに例があります: