파이썬의 웹 사이트는 어떻게 온라인 문서를 생성합니까?

Question

스핑크스 0.6.5를 사용하여 만들어졌습니다.

는 파이썬의 문서 reStructuredText 사용 알고 있지만, 그것은 http://docs.python.org/whatsnew/2.6.html 및 http://docs.python.org/tutorial/index.html 같은 다른 섹션이 있습니다.

어떻게 reStructuredText에서 이것을합니까? 구조를 유지하면서 여러 디렉토리에 rst2html을 실행합니까?

나는 스핑크스 (Thomas Wouters in an answer에 의해 직접적으로 말한 것처럼 rst2html이 아니다)를 사용하고 있지만, 당신은 전체 페이지가 자동으로 작성된 웹 사이트를 가질 수 있도록 저장소의 소스 코드 파일로 첫 번째 구조를 구성해야하는 방법을 알고 있습니까?

Answer 1

파이썬 설명서에서 마크 업에 대해 reST를 사용하지만 rst2html이 아닌 sphinx을 사용하여 HTML을 생성합니다. sphinx 도구는 모든 개별 .rst 파일을 여러 개의 .html 파일로 변환합니다. 파이썬 문서가 생성되는 방법을 보려면 http://svn.python.org/projects/python/trunk/Doc/Makefile

Answer 2

을 찾아보십시오. sampledoc tutorial on the matplotlib site은 스핑크스를 시작하는 데 매우 유용합니다.

Answer 3

여기 정확히 how to build Python documentation입니다.