Sphinx 문서 : 오류 : 알 수없는 지시문 유형 "program-output"

Question

Sphinx로 문서를 만들려고하고 있는데 두 컴퓨터에서 똑같은 문제가 발생합니다. 프로그램 출력 지시문이 작동하지 않습니다. 설치가 잘 갔다

$ sudo pip install sphinxcontrib-programoutput 

, 문서가 좋은 찾고 HTML로 아름답게 컴파일하지만, 명령 출력 그냥 작동하지 않습니다

나는 다음 programoutput 확장, 스핑크스를 설치했습니다. 나는 다음과 같은 출력 (경로 약칭 함) 취득이 컴파일 할 때 이제

.. program-output:: python -V 

:

/path/to/test.rst:1: ERROR: Unknown directive type "program-output". 

나는 test.rst 한 줄을 포함라는 파일을 슈퍼 간단한 테스트 케이스 생성

프로그램 출력을 별칭 명령 출력으로 변경하더라도 놀라운 결과는 아닙니다. 나는 내가 여기서 잘못하고있는 것이 무엇인지 궁금합니다. 설치 지침에 따라 다시 시도해보고 --upgrade 플래그로 다시 설치했지만 아무 것도 작동하지 않습니다.

Answer 1

bmu 덕분에 문제가 발견되어 실제로 conf.py에 추가해야했습니다.

이제 다음 질문 : "왜이 확장 프로그램의 설치/사용 설명서에 없습니까?" 이 확장 프로그램에서 인터넷 검색을 할 때 가장 먼저 얻는 링크 인 http://packages.python.org/sphinxcontrib-programoutput/에 언급되어 있지 않습니다.

는 어쨌든 완전한 답변, 너무 다른 사람들에게 유용 희망 :

이동 문서의 나머지 부분은 사용자의 문서 (예를 들어, ~/Projects/project-name/doc)의 문서 루트. extensions = []를 말한다 라인에 대한

편집 파일 conf.py

봐 (내 경우에는 빈리스트)

에

변경이 : extensions = ['sphinxcontrib.programoutput']

그리고 기적적으로 갑자기 작동을 시작합니다.