Pro Git 2nd Edition
= Pro Git, Second Edition
Welcome to the second edition of the Pro Git book.
You can find this book online at: https://git-scm.com/book
Like the first edition, the second edition of Pro Git is open source under a Creative Commons license.
A couple of things have changed since open sourcing the first edition. For one, we've moved from Markdown to the amazing AsciiDoc format for the text of the book; here's an https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[AsciiDoc quick reference].
We've also moved to keeping the translations in separate repositories rather than subdirectories of the English repository. See link:TRANSLATING.md[the translating document] for more information.
== How To Generate the Book
You can generate the e-book files manually with Asciidoctor. We used to be able to build .mobi files (Kindle), but cannot do so now, see #1496 for more information. If you run the following you may actually get HTML, Epub and PDF output files:
$ 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 PDF...
You can generate just one of the supported formats (HTML, EPUB, or PDF). Use one of the following commands:
To generate the HTML book:
To generate the EPUB book:
To generate the PDF book:
== Signaling an Issue
Before signaling an issue, please check that there isn't already a similar one in the bug tracking system.
Also, if this issue has been spotted on the git-scm.com site, please cross-check that it is still present in this repo. The issue may have already been corrected, but the changes have not been deployed yet.
If you'd like to help out by making a change, take a look at the link:CONTRIBUTING.md[contributor's guide].