ContextQMD
Back to Progit

Pro Git Book Contents

README.original.md

latest3.0 KB
Original Source

Pro Git Book Contents

This is the source code for the Pro Git book contents. It is licensed under the Creative Commons Attribution-Non Commercial-Share Alike 3.0 license. I hope you enjoy it, I hope it helps you learn Git, and I hope you'll support Apress and me by purchasing a print copy of the book at Amazon:

http://tinyurl.com/amazonprogit

It is also available online at:

http://git-scm.com/book/

and fully translated in 10 languages.

Making Ebooks

On Fedora (16 and later) you can run something like this::

$ yum install ruby calibre rubygems ruby-devel rubygem-ruby-debug rubygem-rdiscount
$ makeebooks en  # will produce a mobi

On MacOS you can do like this:

  1. INSTALL ruby and rubygems
  2. $ gem install rdiscount
  3. DOWNLOAD Calibre for MacOS and install command line tools. You'll need some dependencies to generate a PDF:
  4. $ makeebooks zh #will produce a mobi

On Windows you can do like this:

  1. Install ruby and related tool from http://rubyinstaller.org/downloads/
    • RubyInstaller (ruby & gem)
    • Development Kit (to build rdiscount gem)
  2. Open cmd and $ gem install rdiscount
  3. Install Calibre for Windows from http://calibre-ebook.com/download
  4. $ SET ebook_convert_path=c:\Program Files\Calibre2\ebook-convert.exe. Modify to suit with your Calibre installed path.
  5. Make ebooks:
    • $ ruby makeebooks vi #will produce a mobi
    • $ SET FORMAT=epub then $ ruby makeebooks vi #will produce an epub

Notes on pandoc

Please use Pandoc version 1.11.1 or later as older versions (confirmed on 1.9.1.1) has a bug which hides a word after tilde ~. You can do pandoc -v to see which version you have installed.

Errata

If you see anything that is technically wrong or otherwise in need of correction, please open an issue and one of the maintainers will take a look.

Translation

If you wish to translate the book, your work will be put up on the git-scm.com site. Please put your translation into the appropriate subdirectory of this project, using the ISO 639 code and send a pull request.

Sending a pull request

  • Be careful to use UTF-8 encoding in your files.
  • Do not mix changes to the original English with translations in a single pull request.
  • If your pull request changes a translation, prefix your pull request and commits' messages with the ISO 639 code, e.g. [de] Update chapter 2. Please only push files where there is already some translation done.
  • Make sure the translation changes can be automatically merged. The maintainers can not make the merge manually if there are some conflicts.
  • Make as sure as possible that the changes work correctly for publishing to PDF, ebooks and the git-scm.com website.