소개 자료를 모두 읽고 Django를 사용하기로 하셨군요. 우리는 겉핡기를 했을 뿐입니다(사실, 그걸 다 읽었다고 해도 전체 문서의 십분의 일도 읽지 못한 셈입니다).
자 이제 무엇을 할까요?
지금까지 우리는 항상 직접 예제들을 작성하면서 배워왔습니다. 이제부터는 스스로 프로젝트를 할 수 있을 만큼 지식을 쌓아나가야 합니다. 더 새로운 방법들을 배우기 위해 다른 문서들을 살펴봅시다.
우리는 Django의 문서를 유용하면서도 가능한 읽기 쉽도록 만들기 위해 많은 노력을 기울였습니다. 이 문서의 나머지 부분은 어떻게 문서를 최대한 활용할 수 있는지를 설명합니다.
(네, 이것은 문서에 대한 문서입니다. 읽는 방법에 대한 문서를 쓸 계획은 없으니 안심하세요.)
Django에는 – 거의 이십만 개의 단어로 이루어진 – 많은 문서가 있기 때문에 때로는 필요한 것을 찾기가 힘들 수도 있습니다. Search Page나 Index에서 시작하는 것도 좋은 방법입니다.
그냥 둘러보셔도 좋구요!
Django의 주요 문서는 필요에 따라 몇몇 “덩어리”로 나뉘어져 있습니다.
소개 자료는 Django 또는 일반적인 웹 개발을 처음 접하는 사람들을 위해 만들었습니다. 깊은 내용을 다루지는 않지만, 그 대신에 Django의 “느낌”이 나게끔 개발할 수 있도록 높은 수준에서의 개요를 제공합니다.
한편 주제별 안내서는, Django의 각 부분을 심도있게 탐구합니다. Django의 모델 시스템, 템플릿 엔진, 폼 프레임워크 등 각각의 주제에 대한 완전한 안내서입니다.
여러분들은 아마 대부분의 시간을 이 문서들에서 보내고자 할 것입니다. 만약 여러분이 이 안내서 이용해 프로젝트를 진행한다면 Django 대해 알아야 할 거의 모든 것이 나와 있습니다.
웹 개발은 깊이 있지 않지만 대개 광범위합니다 – 문제는 많은 영역에 놓여있습니다. 우리는 하우투 가이드를 “~을 어떻게 할까?” 하는 일반적인 질문의 응답 형식으로 글을 썼습니다. 여러분은 Django에서 PDF 생성하기와 맞춤 템플릿 태그 작성법 등의 정보를 찾아볼 수 있을 것입니다.
일반적인 질문에 대한 답변도 FAQ에서 찾을 수 있을 것입니다.
이 안내서나 하우투는 Django에서 사용 가능한 모든 클래스, 함수, 메소드를 하나하나 다루지는 않습니다. 그것은 당신이 Django를 배우려고 할때 많은 부분을 차지할 것입니다. 대신, 각 클래스, 함수, 메서드 및 모듈에 대한 자세한 내용은 참조에 있습니다. 그곳에서 특정한 기능에 대한 세부 정보를 찾을 수 있습니다.
마지막으로, 일반적으로 대부분의 개발자와 관련이 없는 “특수한” 문서들이 존재합니다. 릴리즈 노트, 쓸모 없는 기능에 대한 문서, 내부 문서도 있습니다.
Django의 코드 기반이 하루하루 개발되고 개선되는 것처럼, 문서도 지속적으로 개선이 이루어집니다. 우리는 다음과 같은 몇 가지의 이유로 문서를 개선해나갑니다.
Django의 문서는 코드와 동일한 소스 제어 시스템에 보관합니다. 그것은 서브버전 저장소의 django/trunk/docs 디렉토리에 있습니다. 각 온라인 문서는 저장소에 별도로 존재하는 텍스트 파일입니다.
Django 문서는 다음과 같은 다양한 방법을 통해 구해서 읽을 수 있습니다.
Django 문서의 가장 최신 버전은 http://docs.djangoproject.com/en/dev/에 있습니다. 이런 HTML 페이지는 소스 컨트롤 내 텍스트 파일에서 자동으로 생성됩니다. 이는 Django의 “최신 내용과 완벽한 내용”을 반영한다는 의미입니다 – 그것은 가장 최근의 수정이나 추가사항을 포함하며, Django 개발 버전 사용자를 위한 최신 Django 기능에 대해 논의합니다. (아래의 “버전 간의 차이점” 참조.)
우리는 당신이 ‘티켓 시스템’에서 변경, 수정 및 제안을 제출하여 문서를 개선하는 도움되는 것을 권장합니다. Django 개발자들이 적극적으로 티켓 시스템을 모니터링하고 모든 사람에 대한 문서를 개선하기 위해 당신의 피드백을 사용합니다.
그러나 그 티켓은 광범위한 기술 지원 질문보다는 명시적으로 문서와 관련있을 것임에 주의하세요. 당신은 특정 Django 설정에 도움이 필요한 경우 티켓보다는 django-users 메일링 리스트 또는 #django IRC 채널을 활용하시기 바랍니다.
오프라인으로 읽거나 좀 더 편하게 읽기 위해 Django 문서를 일반적인 텍스트 문서로도 제공합니다.
여러분이 Django의 공식 릴리즈를 사용하는 경우, 코드에 포함된 docs/ 디렉토리의 압축된 패키지(tarball)를 참조하세요. 해당 릴리즈의 모든 문서를 포함하고 있습니다.
당신이 Django의 개발 버전을 사용한다면(즉, 서브버전 “trunk”), docs/ 디렉토리에 모든 문서가 있습니다. 당신은 최신의 변경 사항을 얻기 위해 svn update 를 할수 있고 마찬가지로 파이썬 코드에서 svn update 할 수 있습니다.
당신은 이 쉘 명령을 사용하여 서브버전으로 부터 최신의 Django 문서를 확인할 수 있습니다.
$ svn co https://code.djangoproject.com/svn/django/trunk/docs/ django_docs
텍스트 문서를 활용하는 낮은 기술은 모든 문서에서 구문 검색을 위해 유닉스의 grep 유틸리티를 사용하는 것입니다. 예를 들어, 이것은 당신에게 어떤 Django 문서에서 구문 “MAX_LENGTH”의 각 언급을 보여줍니다.
$ grep -r max_length /path/to/django/docs/
당신은 몇가지 간단한 단계를 거쳐 HTML 문서를 로컬에 가져올 수 있습니다.
Django 설명서는 HTML로 일반 텍스트로 변환하는 Sphinx라는 시스템을 사용합니다. 당신은 Sphinx 웹 사이트에서 또는 pip으로 패키지를 다운로드하고 설치하여 Sphinx를 설치해야 합니다.
$ sudo pip install Sphinx
그후, HTML에서 문서를 바꾸기 위한 포함된 Makefile을 사용하면 됩니다.
$ cd path/to/django/docs $ make html이것을 위해 GNU Make를 설치할 필요가 있습니다.
만약 당신이 윈도우즈상에 있다면 포함된 배치(batch) 파일을 사용할 수 있습니다.
cd path\to\django\docs make.bat html
Note
Django 문서의 생성은 Sphinx 버전 0.6 이상에서 작동하기는 하지만, 우리는 Sphinx 1.0.2 이상 버전으로 곧장 가는 것을 권장합니다.
앞서 이야기 했듯이, 우리의 서브버전 저장소의 텍스트 문서는 “최신 그리고 최고” 변경 및 추가를 포함하고 있습니다. 이러한 변경은 가끔 Django 개발 버전에 새로운 기능 추가의 문서를 포함합니다. – Django의 서브버전 (“trunk”) 버전. 그러한 연유로, 다양한 버전의 프레임워크를 위해 올바른 문서를 지키는 일에 대한 우리의 정책을 짚고 넘어가도록 하겠습니다.
우리의 정책은 다음과 같습니다.
Sep 05, 2013