Repolode
Submit
progit

progit/progit2

The second edition of Pro Git, a free, open-source book teaching Git from basics to internals, written in AsciiDoc.

View on GitHub
Stars
6,619
Forks
2,124
Open issues
221
Last commit
6 months ago

What is it?

Pro Git is a free, open-source book that teaches Git, the distributed version control system, from first steps through advanced usage and its internal data model. The book is published online at git-scm.com and is licensed under a Creative Commons license.

This repository holds the source text for the second edition. The content is written in AsciiDoc, and the project includes a Rakefile with Asciidoctor-based tasks that build the book as HTML, EPUB, Mobi and PDF files. Translations are maintained in separate repositories.

It suits developers who want a thorough reference on Git, or who want to read the book offline in their preferred format or contribute corrections to the text.

Key features

  • 01Covers Git from beginner basics to advanced usage and internals.
  • 02Source written in AsciiDoc.
  • 03Build tasks generate HTML, EPUB, Mobi and PDF output with Rake and Asciidoctor.
  • 04Translations are kept in separate repositories.

Use cases

  • Learning Git thoroughly from scratch.
  • Looking up how Git works internally, such as its object model.
  • Reading an offline copy of the book in EPUB, Mobi or PDF format.
  • Proofreading or contributing corrections to the book's text.

Quick start

  1. 1

    Install Ruby gem dependencies

    bundle install
  2. 2

    Build all book formats (HTML, EPUB, Mobi, PDF)

    bundle exec rake book:build

Things to know

  • The README describes generating the book with Asciidoctor and Ruby tooling, so you need a working Ruby environment.
  • The project is the text of a book rather than a software application, and the README says the book is under a Creative Commons license rather than a standard software license.

In collections

Static site generators & documentation tools

Topics

#git#version-control#book#asciidoc#documentation#pro-git

FAQ

What is progit2?
The second edition of Pro Git, a free, open-source book teaching Git from basics to internals, written in AsciiDoc. Pro Git is a free, open-source book that teaches Git, the distributed version control system, from first steps through advanced usage and its internal data model. The book is published online at git-scm.com and is licensed under a Creative Commons license.
Is progit2 free to use? What license does it have?
progit2 is open source under the Other license. Check the license terms before using it in commercial products.
Is progit2 still maintained?
Updated within 6 months. The last commit to progit2 was on May 25, 2026.
What can I use progit2 for?
Learning Git thoroughly from scratch. Looking up how Git works internally, such as its object model. Reading an offline copy of the book in EPUB, Mobi or PDF format. Proofreading or contributing corrections to the book's text.
How do I install progit2?
Install Ruby gem dependencies: bundle install Build all book formats (HTML, EPUB, Mobi, PDF): bundle exec rake book:build
Where can I get progit2?
The source code and installation instructions are on GitHub: https://github.com/progit/progit2

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects