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 7dd0c15d3d
Merge pull request #1482 from HonkingGoose/bugfix/issue-506
1 day ago
.github [Fix] use 'an' article before vowel sounds 1 month ago
book Merge pull request #1482 from HonkingGoose/bugfix/issue-506 1 day ago
callouts Run pngquant + optipng 4 years ago
diagram-source Add a slice to the symbols page and export it 1 year ago
images Change reference of 'pu' to 'seen' in the SVG image 1 month ago
script I’m bad at json 2 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 5 months ago
A-git-in-other-environments.asc Add basic information about Git in JetBrains IDEs 7 months ago
B-embedding-git-in-your-applications.asc Add dulwich to Appendinx B: embedding 2 years ago
C-git-commands.asc Merge branch 'master' into patch-3 4 months ago
CONTRIBUTING.md Improve the text with the following changes: 1 day ago
Gemfile asciidoctor version downgrade 7 months 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 Other Quick Reference as requested by Ben 5 months ago
Rakefile Include images into HTML file 5 months ago
TRANSLATING.md Change link to GitHub docs 2 weeks ago
TRANSLATION_NOTES.asc new lines 5 years ago
atlas.json Updated atlas.json 5 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 change name of chapters to adapt to git-scm scripts 2 years ago
ch04-git-on-the-server.asc chapter 4: numerous tweaks, rewordings and font changes 1 year ago
ch05-distributed-git.asc change name of chapters to adapt to git-scm scripts 2 years ago
ch06-github.asc change name of chapters to adapt to git-scm scripts 2 years ago
ch07-git-tools.asc single-quote normalization 1 year ago
ch08-customizing-git.asc change name of chapters to adapt to git-scm scripts 2 years ago
ch09-git-and-other-systems.asc change name of chapters to adapt to git-scm scripts 2 years ago
ch10-git-internals.asc change name of chapters to adapt to git-scm scripts 2 years ago
index.asc Add index to pdf ebook 2 years ago
progit.asc Remove the empty version line 1 year ago
status.json Remove dead notes content 5 years 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.
If you run the following you _may_ actually get HTML, Epub, Mobi 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 Mobi (kf8)...
-- Mobi output at progit.mobi
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].