Bem-vindo à segunda edição do livro Pro Git
If you’re looking for official version, in English, see https://github.com/progit/progit2.
Você pode achar esse livro online em: http://git-scm.com/book
Como a primeira, a segunda edição do livro Pro Git é open source sob uma licença Creative Commons.
Algumas coisas mudaram desde quando a primeira edição foi disponibilizada de forma livre. Umas delas foi que mudamos o texto do livro de Markdown para o maravilhoso formato Asciidoc. Nós também passamos a usar a Plataforma Atlas da O’Reilly para a geração contínua dos livros, assim os formatos mais conhecidos estão sempre disponíves em todas os idiomas.
Nós também passamos a manter as traduções em repositórios separados em vez usar de subdiretórios do repositório original em inglês. Veja o documento para contribuições para mais informações.
Existem algumas formas para gerar o e-book a partir deste código fonte.
O mais fácil é simplesmente deixar que a gente faça isso. Um robô fica esperando por mudanças no branch pricipal e automaticamente gera o livro para todos.
Você acha as versões atuais em http://git-scm.com/book e mais informações sobre a geração dos livros estão disponíveis em https://progit.org.
Outra forma de gerar os arquivos do ebooks é de forma manual, usando o Asciidoctor. Se você executar os comandos a seguir você deve obter os arquivos em HTML, Epub, Mobi e 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
Usamos os projetos asciidoctor, asciidoctor-pdf e asciidoctor-epub.
Sugerido que utilize o http://brew.sh/ para gerenciar as dependências de sistema (no caso, instalar o ruby e o rubygems mais recentes, para então instalar o asciidoctor).
$ ruby -v $ brew install ruby $ source ~/.bashrc # or source ~/.zshrc $ ruby -v
$ gem update --system
$ bundle config build.nokogiri --use-system-libraries ---
Depois disso tudo, é só gerar os livros
$ bundle exec rake book:build ---
Você não precisa instalar todas as dependências do Asciidoctor em seu sistema: usando Docker, com apenas um comando o livro é gerado por meio de um container efêmero. Esse só vai existir durante a geração do livro e depois some do sistema. O comando é esse aqui:
$ docker run -it --rm \
-v `pwd`:/documents/ \
rogeriopradoj/progit2
Copie todas as linhas e cole de uma vez no seu terminal. Pronto!
Antes de abrir uma issue indicando um problema, por favor verifique se já não existe alguma parecida aberta no sistema de rastreio de bugs.
Além disso, se esse problema foi apontado no site git-scm.com, verifique também se ele não está presente aqui neste reposítorio. O problema pode ser sido resolvido, mas as mudanças ainda não terem sido implantadas e publicadas (deploy).
Se você gostaria de nos ajudar fazendo alguma mudança ou com traduções, dê uma olhada no guia do contribuidor.