lnyarl / progit2-ko

Pro Git, 2판

Home Page:https://github.com/progit-ko/progit2-ko/wiki

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Pro Git, 2판

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

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

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

오픈소스로 공개한 초판에서 달라진 게 몇 가지 있습니다. 먼저 문서의 형식을 Markdown에서 Asciidoc으로 바꾸었습니다. 그리고 O’Reilly의 Atlas 플랫폼을 사용해서 지속적으로 빌드하기로 했습니다. 항상 모든 언어로 다양한 포멧으로 제공할 수 있게 됐습니다.

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

기여하기

책의 오류를 수정하거나 새 내용을 추가하려면 GitHub의 Pull Request를 보내 주세요. 뭔가 하기 전에 받아들여질지 이슈를 만들고 확인해보는 것도 좋은 방법입니다.

우리가 `더 낫다.'라고 생각하는 오류나 개선점은 받아들입니다. 이슈를 만들고 먼저 우리 생각을 묻는 것도 좋습니다.

대대적인 내용의 변경은 하지 않는 것이 좋습니다. 받아들여지지도 않을 테고 시간낭비일 뿐입니다. 이런 수정사항은 매우 주관적인 경향을 보이고 일부 사람들에게만 도움이 될 뿐입니다. 받아들여지지 않을 것입니다. 전문 글쟁이들이 이미 여러 번 확인했기 때문에 보내주신 수정 내용이 저희가 작성한 것보다 훨씬 나을 가능성은 매우 낮기 때문입니다.

책 생성 방법

두 가지 방법으로 e-book을 생성할 수 있습니다.

쉬운 첫 번째 방법은 저희에게 맡겨주는 겁니다. 자동화 로봇이 있어서 메인 브랜치에 새 작업이 추가되면 자동으로 책을 생성하는 일을 합니다.

http://git-scm.com/book 사이트에서 가장 최신 버전의 책을 확인할 수 있습니다. https://progit.org 사이트를 통해 빌드 정보를 확인할 수 있습니다.

직접 e-book을 생성하려면 Asciidoctor를 이용합니다. 다음과 같은 명령을 실행하면 아마도 HTML, Epub, Mobi, PDF 버전의 책을 생성할 수 있을 것입니다.

$ bundle install
$ bundle exec rake book:build
Converting to HTML...
 -- HTML output at progit.html
Converting to EPub...
 -- Epub output at progit.epub
Converting to Mobi (kf8)...
 -- Mobi output at progit.mobi
Converting to PDF...
 -- PDF  output at progit.pdf

위 명령이 잘 실행되려면 asciidoctor, asciidoctor-pdf, asciidoctor-epub 프로젝트가 필요합니다.

번역

Pro Git이 많은 언어로 번역되길 기원합니다. 다만, 번역 작업이 초판과 좀 달라졌음을 알려 드립니다. 번역판마다 다른 저장소에서 관리하며 Atlas를 사용하여 자동으로 빌드합니다. 초판에서는 이 작업이 정말 힘들었습니다.

번역판마다 저장소가 달라서 번역판마다 메인테이너가 다를 수 있습니다. Pro Git 팀은 간단히 Pull로 각 번역판의 소스를 당겨와서 건설합니다. 번역 저장소가 GitHub의 progit 계정에 만들어지면 자동으로 빌드 가능합니다.

번역이 어떻게 진행되고 있는지도 확인할 수 있습니다: http://progit.org/translations

그림

이 책에서 사용하는 그림은 모두 Sketch 3로 제작했으며 Sketch 작업 파일도 프로젝트에 포함돼 있습니다.

그림을 추가하려면:

  1. Sketchbook에 Page를 새로 추가하면 되는데, 되도록 이미 포함된 그림을 활용하길 바랍니다.

  2. ``slice''를 페이지에 추가하고 최종 PNG 파일이름에 사용될 이름을 짓습니다. 소스의 최상위 디렉토리의 상대경로로 지어야 합니다.

  3. slice가 3배 큰 크기로 내보내 지도록 설정해야 합니다.

About

Pro Git, 2판

https://github.com/progit-ko/progit2-ko/wiki

License:Other