[카테고리:] Python

  • Sphinx / Read-the-Docs를 통한 Python Project 문서화

    개발과 문서가 따로노니 신경쓸 것이 두 배로 생긴다.이에 소스코드로부터 개발문서를 만들어보기로 했다. Sphinx란 Python을 위한 문서화 라이브러리로 소스코드로부터 문서(html, LaTeX 등)를 정적으로 생성하는 도구이다.이 말고도 다른 라이브러리들이 많이 있지만 대부분 Sphinx를 선호하는 듯 하다. [참고]Sphinx로 만들어진 문서를 서빙할 때 단연코 가장 많이 쓰이는 방식은 Read-the-Docs (이하 RTD)를 통한 호스팅이다.RTD는 Sphinx로 만들어진 html 문서를 호스팅하는 곳으로…