Sphinx 스타일 문서화 문자열에 하이라이트 또는 코드 블록을 삽입하려면 어떻게해야합니까? 예를 들어

Question

:

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

이 (가 그대로 단어 "하이라이트"를 인쇄하고 특별한 방법으로 다음 코드를 포맷하지 않음) 원하는 출력을 생성하지 않습니다. code-block에 대해서도 동일합니다.

다른 들여 쓰기 등을 시도해 보았습니다. 발전기는 대략 동일하지만 원하는 출력이 아니더라도 성공합니다.

Answer 1

코드를 docs과 비교하면 들여 쓰기가 누락되고 강조 표시와 실제 코드 사이에 빈 줄이 생깁니다. 이것은 다음과 같아야합니다 :

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

     import sys 
     ... 
    '''