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.
Se você quiser contribuir para a tradução do livro Pro Git para o português brasileiro, é só seguir os seguintes passos:
-
Crie uma issue dizendo qual parte do livro deseja traduzir (isso evita que mais de uma pessoa comece a traduzir a mesma parte.)
-
Antes de começar a traduzir, é recomendado que você leia as partes do livro já traduzidas. Isso lhe dará uma ideia das convenções e escolhas de traduções sendo usadas.
-
Envie um pull request com a sua contribuição. Possivelmente solicitaremos algumas alterações, visando corrigir problemas ou adequar suas escolhas de tradução ao estilo vigente no restante do livro. Você pode então fazer as alterações e enviar mais commits para seu branch.
-
Caso você seja iniciante em colaborar com projetos open-source no GitHub, leia o guia que preparamos para você se familiarizar com o processo.
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 principal 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](https://github.com/progit/progit2/issues) do repositário original em inglês.
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, dê uma olhada no guia do contribuidor e dirija-se ao repositório do livro original em inglês.