Django ORM Cookbook 번역 후기

8퍼센트의 스터디는 Django를 더 깊게 익히고 업무에 바로 적용하기 위한 방향으로 이어졌다. 멤버들은 Django ORM Cookbook을 함께 공부하기로 하고, 오픈소스 문서를 한글로 번역해 공유하는 방식으로 기여를 시도했다.

원저자에게 번역 참여 의사를 메일로 보냈고, 곧바로 긍정적인 답장을 받았다. 저자는 Sphinx와 Read the Docs를 사용해보라고 안내했고, 필요하면 언제든 연락하라고 했다.

문서 제작은 다음 순서로 진행됐다.

• 저장소를 fork한 뒤 readthedocs.org에 프로젝트를 생성
• GitHub 연결 후 fork한 저장소를 선택
• 프로젝트 이름을 원본과 겹치지 않게 수정
• webhook을 확인해 push와 PR 변경사항이 자동 반영되도록 설정
• 번역 PR을 올리고 master에 병합한 뒤 사이트 반영을 확인

로컬에서는 fork한 저장소를 클론해 가상환경을 만든 뒤 Sphinx를 설치해 빌드를 시도했다. sphinx_rtd_theme이 필요하다는 에러를 해결하기 위해 테마를 추가로 설치했고, 이후 sphinx-build . ./_build/html/로 HTML 빌드를 확인했다.

PDF 변환도 진행했다. LaTeX를 거쳐 PDF를 만들었고, 한글 문서라서 DjangoORMCookbook.tex에 대해 kotex와 babel 관련 수정도 적용했다. 이후 make all-pdf로 최종 PDF를 생성했다.

번역은 장마다 발표자와 번역자를 따로 두는 방식으로 진행됐고, 과정에서 오타와 문법 오류도 함께 발견해 고쳤다. 번역 어투가 제각각이어서 퇴고가 필요했지만, 연오님의 도움으로 문서 전체를 빠르게 정리해 완성도를 높였다.

번역을 마친 뒤 원저자에게 다시 알렸고, 저자는 번역 링크를 영문서에 첨부하겠다고 답했다. 팀은 스터디 결과물이 실제 번역문서와 인쇄본으로 남은 경험을 특히 의미 있게 받아들였다.