CIT 591 Git, githug, and GitHub
Fall 2012, David Matuszek

Names

Installation

Githug is installed on the computers in Moore 207, and you can use it there. You don't have to install it on your own computer if you don't want to.

Step 1: Install git

I got my copy of git from http://git-scm.com/downloads. During installation, I selected the option "Run Git and included Unix tools from the Windows Command Prompt." This allows me to use the git help command, which uses the Unix man tool.

There are other ways to install git, and you may prefer to do it differently. That's okay, too.

After installation, enter git in a newly opened terminal window. If the installation succeeded, this will show you a list of git commands.

Step 2: Install Ruby

To install githug on your own computer, first install Ruby. Ruby is a very nice programming language, similar to Python. If you are using Mac OS X, you already have Ruby. There are various ways to install Ruby on a Windows computer; I used http://rubyinstaller.org/; when you run the installer, choose the option to add the Ruby executables to your PATH.

Step 3: Install githug

Open a terminal window (on Windows, click the Start menu and type cmd), then enter the command
     gem install githug

Step 4: Read some documentation

It is possible to use git without really understanding it. If you think that's a bad idea, you're right! That's why you should start by reading Understanding Git Conceptually.

You can type git help to get a list of commands, or git help command to get information on individual commands. The latter only works if you can use the Unix man tool; if you can't, you can get the same information online at http://git-scm.com/docs. As a beginner, you can usually skip the Options section, but you should read the Description section and look at the Examples section.

At some point you should read a tutorial on how to use git. I like Git for the Lazy because I'm...well, just because. I also like A Visual Git Reference, which is probably more than you need. Another good tutorial is Git with GitHub on SEAS (.pdf), written by MCIT's own Chris Imbriano and Saray Gray. If you don't like any of these, try something from Top 10 Git Tutorials for Beginners, or just google for something.

Step 5: Run githug

From the command line, type githug, and start playing. Try to get through all the levels. Good luck!