Sphinxスタイルのドキュメントストリングにハイライトまたはコードブロックを挿入するにはどうすればよいですか？例えば

Question

：

def foo(): 
    ''' 
    .. highlight:: python 
    import sys 
    ''' 

は（それはそのまま単語「ハイライト」を印刷し、特別な方法で次のコードをフォーマットしない）は、所望の出力を生成しません。 code-blockでも同じです。

どのようなものであっても、ジェネレータはほぼ同じで出力は成功しますが、希望する出力は成功しません。

Answer 1

コードをdocsと比較すると、ハイライトと実際のコードの間にインデントと空白行がありません。これは次のようになります。

def foo(): 
    ''' 
    .. highlight:: python 
    .. code-block:: python 

     import sys 
     ... 
    '''