2016-10-14 1 views

답변

1

make

는 스핑크스 명령하지 실행할 때이 일어날 수 있도록 수정해야 할 conf.py 설정은 무엇


질문
. 이 명령은 실제로 make (Makefile 포함) 또는 make.bat (운영 체제에 따라 다름) 중 하나를 실행 한 다음 sphinx-build을 호출하기 전에 관련 파일을 찾습니다. make 파일을 수정하거나 적절한 환경 변수를 설정해야합니다.

1

출력 디렉토리는 conf.py 설정이 아닙니다. 이것은 에 대한 인수 (builddir)입니다. Makefile에 설정하십시오.

conf.py에서 패키지가있는 곳은 updatingsys.path입니다.

1

다른 언급 된대로 Makefile을 편집 할 수 있습니다. 나는 보통 sphinx-build 명령을 사용한다.

$ sphinx-build [options] sourcedir outputdir 은 (HTML은 기본 빌드 옵션입니다, 당신은 -b html를 사용하여 지정할 수 있습니다) 당신이 자동 생성 API 문서를 인 경우에만 문제

패키지의 위치를. 당신은/스핑크스/myproject라는로부터 구축 할 수있는 명령을 실행하는 경우 사용하십시오 :

$ sphinx-build ./ /myhtmlfiles/myproject

이것은, 하위 디렉토리에 /sphinx/myproject/myhtmlfiles/myproject을 빌드 출력을 배치합니다. 빌드 위치가 sphinx/myproject의 하위 디렉토리가 아닌 경우 올바른 경로를 지정해야합니다. 당신은 API 문서를 자동으로 생성 할 경우

, 당신은 sphinx-apidoc를 사용하는 것이 좋습니다 :

$ sphinx-apidoc [options] -o outputdir packagedir [pathnames]