Wie lege ich Highlight oder Code-Block in Sphinx-artige Docstrings?

Question

Zum Beispiel:

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

produzieren nicht gewünschte Ausgabe (druckt das Wort „Highlights“ wörtlich und nicht formatiert den folgenden Code in einer besonderen Art und Weise). Gleiches passiert für code-block.

Ich habe versucht verschiedene Einrückung usw. Egal was, Generator gelingt mit etwa gleich, aber nicht die gewünschte Ausgabe.

Answer 1

Vergleicht man den Code mit den docs, Sie fehlen Vertiefung und eine Leerzeile zwischen dem Höhepunkt und dem eigentlichen Code. Es sollte so sein:

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

     import sys 
     ... 
    '''