Skip to content

Latest commit

 

History

History
66 lines (46 loc) · 1.79 KB

building_progit.md

File metadata and controls

66 lines (46 loc) · 1.79 KB
Raw

Git - the online book

('Pro Git 2' by Scott Chacon and Ben Straub)

Website and the complete book online

https://git-scm.com/book/en/v2

Building the e-book for local reading

First make sure you have installed git itself:

sudo apt-get install git

For the following work, you may be cd'd anywhere you like; a good choice might be a subdirectory of your $HOME folder called github.

mkdir -p ~/github ; cd ~/github

Before doing the work of downloading and "building" the e-book in its various formats (PDF, HTML, asc, etc.), we need to:

  • Grab a recent Ruby tarball from the internet and install it locally, e.g.:
    wget https://cache.ruby-lang.org/pub/ruby/2.4/ruby-2.4.3.tar.gz

  • Explode the tarball and build: tar zxf ruby-2.4.3.tar.gz
    INSTALLDIR=$(pwd)/rubylocal_2.4.3 ; mkdir "$INSTALLDIR"
    cd ruby-2.4.3
    ./configure --prefix="$INSTALLDIR"
    make
    make install
    export PATH="$INSTALLDIR/bin:$PATH"

  • Import the bundler software into the local Ruby installation:
    gem install bundler
    hash -r
    Note the last command assumes bash; for csh dialects use 'rehash' to force your shell to find the 'bundle' binary

  • cd .. to exit the ruby build directory

Now we are equipped to compile all formats of the book from the repository:

  • First, locally clone the repository (aka 'repo'):
git clone http://github.com/progit/progit2

  • Then descend into the local repo and check out the master branch:
    cd progit2
    git checkout

  • Issue these commands to build. PDF should be among the formats built
    bundle install
    bundle exec rake book:build

  • To view the book in PDF, use the evince binary under {14,16} flavors of Ubuntu:
    evince ./progit.pdf