스핑크스 (문서 생성기)

스핑크스(Sphinx)는 파이썬 커뮤니티에서 작성하고 사용하는 문서 생성기이다. Python으로 작성되었으며, 다른 환경에서도 사용된다.

 목적 및 기능 
스핑크스는 reStructuredText 파일을 HTML 웹사이트를 비롯하여 PDF, EPub, Texinfo, man 등 다양한 형식으로 변환한다.

reStructuredText는 확장이 가능하며, 스핑크스는 소스 코드로부터 문서를 자동 생성하거나, 수학 기호를 작성하고, 소스 코드를 강조(highlighting)하는 등의 여러 확장 기능을 통해 이러한 확장성을 활용한다.

 HTML 테마 
스핑크스는 HTML 및 HTML 기반 형식에 테마를 적용하는 기능을 제공한다. 스핑크스에는 alabaster, classic, sphinxdoc, scrolls를 포함한 여러 내장 테마가 있다. 파이썬 모듈로 설치할 수 있는 인기 있는 테마는 다음과 같다.
 Read the Docs
 스핑크스 Bootstrap
 Guzzle
 Documatt

 역사 및 사용 
2008년 3월 21일에 첫 번째 공개 버전인 0.1.61611 버전이 발표되었다. 이 도구는 파이썬 프로젝트의 문서를 위해 개발되었으며 현재도 광범위하게 사용되고 있다.

2008년 도입 이후 스핑크스는 Bazaar, SQLAlchemy, MayaVi, SageMath, SciPy, Django, Pylons를 포함한 많은 주요 파이썬 프로젝트에 채택되었다. 또한 블렌더 사용자 매뉴얼 및 파이썬 API 문서 생성에도 사용된다.

2010년, 에릭 홀셔는 소프트웨어 문서 관리의 편의성을 높이기 위한 노력의 일환으로 Read the Docs 프로젝트의 창설을 발표했다. Read the Docs는 매 커밋 이후 스핑크스 문서의 빌드 및 업로드 과정을 자동화한다.

 리눅스 커널 
리눅스 커널의 문서화 하위 시스템은 2016년에 변화를 겪었다. 4.7 사이클부터 문서화 도구로 스핑크스를 사용하기 시작했다.
 LCA2016 발표: 
 LCA2017 발표: 

 같이 보기 
 문서 생성기 비교
 Read the Docs
 reStructuredText

 각주 

 외부 링크 

 Read the Docs 스핑크스를 기반으로 하는 대규모 협업 문서 호스트

분류:자유 문서 생성기
분류:파이썬으로 작성된 자유 소프트웨어
분류:BSD 라이선스 소프트웨어