README.asc

Pro Git, 2판

짜잔, Pro Git 책의 2판입니다.

이 책은 온라인으로도 볼 수 있습니다: http://git-scm.com/book

초판과 마찬가지로 2판도 Creative Commons 라이센스를 따르는 오픈소스입니다.

오픈소스로 공개한 초판에서 달라진 게 몇 가지 있습니다. 먼저 문서의 형식을 Markdown에서 Asciidoc으로 바꾸었습니다.

초판에서는 번역본을 모두 한 저장소에서 관리했습니다. 이제는 각각 분리된 저장소로 관리합니다. 자세한 내용은 번역(TRANSLATING) 페이지을 참고하시기 바랍니다.

책 생성 방법

아래의 방법이 아니라도 직접 Asciidoctor 도구를 사용하여 e-book을 만들 수도 있습니다. 예전에 Kindle 형식의 e-book인 .mobi 파일을 만들 수 있었지만 현재는 Kindle 형식의 e-book을 생성하지는 않습니다(관련 1496 이슈). 다음과 같은 명령을 실행하여 HTML, Epub, PDF 버전의 책을 생성할 수 있습니다. asciidoctor-pdf-cjk-kai_gen_gothic-install 명령은 PDF에 포함시킬 한국어 글꼴을 다운로드 하는 명령입니다.

$ bundle install
$ asciidoctor-pdf-cjk-kai_gen_gothic-install
$ bundle exec rake book:build
Converting to HTML...
 -- HTML output at progit.html
Converting to EPub...
 -- Epub output at progit.epub
Converting to PDF...
 -- PDF output at progit.pdf

모든 형식의 e-book을 생성하지 않고 특정 형식(HTML, EPUB, PDF)만을 생성할 수도 있습니다. 다음 명령은 HTML, EPUB, PDF 필요한 내용만을 생성하는 명령입니다:

HTML 형식 e-book을 생성하려면:

$ bundle exec rake book:build_html

EPUB 형식 e-book을 생성하려면:

$ bundle exec rake book:build_epub

PDF 형식 e-book을 생성하려면:

$ bundle exec rake book:build_pdf

현재 한글 PDF 빌드에 대한 문제를 #114 에서 해결하고 있습니다.

새로 이슈 만들기

새로 이슈를 만들기 전에 버그 관리 시스템에 비슷한 이슈가 이미 등록되었는지 먼저 확인해보시기 바랍니다.

git-scm.com 사이트에서 발견한 잘못된 점이 저장소의 해당 파일에도 존재하는지 확인해야 합니다. 보고 계신 그 잘못된 점이 저장소에는 이미 수정하여 반영되었지만 사이트에는 아직 적용되지 않았을 수도 있기 때문입니다.

기여하기

뭔가 더 낫게 하거나 번역에 참여하고 싶다면 참여 가이드 문서를 읽어 보세요.