Skip to content

longxuegang/progit2

 
 

Repository files navigation

Pro Git, Second Edition

Welcome to the second edition of the Pro Git book.

You can find this book online at: http://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.

We’ve also moved to keeping the translations in separate repositories rather than subdirectories of the English repository. See the Contributing 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

An alternative to calling the bundle command is to call directly the asciidoctor command. If it is the first time you’re building the book, it is necessary to create the images folder and fill it. Do the following only once:

$ mkdir images/
$ cp book/*/images/* images/

Then you can build the book. Use the following commands:

$ asciidoctor-pdf progit.asc
$ asciidoctor-epub3 progit.asc
$ asciidoctor-epub3 -a ebook-format=kf8 progit.asc

Both use the asciidoctor, asciidoctor-pdf and asciidoctor-epub projects.

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 or contributing a translation, take a look at the contributor’s guide.

About

Pro Git 2nd Edition

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CSS 66.0%
  • XSLT 24.9%
  • Ruby 7.1%
  • HTML 2.0%