Pro Git 2nd Edition
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ben Straub 1cf691ef7a
Merge pull request #1589 from progit/dependabot/bundler/pygments.rb-2.0.0
1 week ago
.github Fix an article 4 months ago
book Fix irregular capitalization 1 week ago
callouts Run pngquant + optipng 5 years ago
diagram-source Add a slice to the symbols page and export it 1 year ago
images Remove bitnami GitLab stuff 4 months ago
script I’m bad at json 3 years ago
theme Delete pdf.xsl~ 5 years ago
.gitignore Add the prefaces to the generation of the ebooks 2 years ago
.mailmap Add the prefaces to the generation of the ebooks 2 years ago
.tgitconfig TortoiseGit config: For security, make the parenthesis non-capturing. 1 year ago
.travis.yml Include html file to release 11 months ago
A-git-in-other-environments.asc Retire Eclipse and Egit content 4 months ago
B-embedding-git-in-your-applications.asc Add dulwich to Appendinx B: embedding 2 years ago
C-git-commands.asc Merge pull request #1539 from Sophismata/issue-1358 2 months ago
CONTRIBUTING.md Improve the text with the following changes: 5 months ago
Gemfile Update pygments.rb requirement from 1.2.1 to 2.0.0 1 week ago
LICENSE.asc one sentence per line 1 year ago
Pro.ico Fix issue #541: Add TortoiseGit config for bugtraq and icon 4 years ago
README.asc Explain missing .mobi builds in readme 4 months ago
Rakefile Introduce test of html and epub 1 month ago
TRANSLATING.md Migrate to Asciidoctor 2.0.11 2 months ago
TRANSLATION_NOTES.asc new lines 5 years ago
atlas.json Updated atlas.json 6 years ago
ch01-getting-started.asc Rename 'Git Basics' from chapter 1 to 'What is Git?' 1 year ago
ch02-git-basics-chapter.asc "Git Basics" chapter: tweak a couple things for aesthetics/clarity 2 years ago
ch03-git-branching.asc Migrate to Asciidoctor 2.0.11 2 months ago
ch04-git-on-the-server.asc chapter 4: numerous tweaks, rewordings and font changes 2 years ago
ch05-distributed-git.asc change name of chapters to adapt to git-scm scripts 3 years ago
ch06-github.asc change name of chapters to adapt to git-scm scripts 3 years ago
ch07-git-tools.asc single-quote normalization 2 years ago
ch08-customizing-git.asc change name of chapters to adapt to git-scm scripts 3 years ago
ch09-git-and-other-systems.asc Migrate to Asciidoctor 2.0.11 2 months ago
ch10-git-internals.asc change name of chapters to adapt to git-scm scripts 3 years ago
index.asc Add index to pdf ebook 2 years ago
progit.asc Stop adding negative leveloffset for EPUB 2 months ago
status.json Retire Eclipse and Egit content 4 months ago

README.asc

= 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...
-- PDF output at progit.pdf
----

== 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.

== Contributing

If you'd like to help out by making a change, take a look at the link:CONTRIBUTING.md[contributor's guide].