You are hereUsing Github

Using Github


Using Github is easy if you use the Github clients for either Windows or Mac. This page leads you through the process of setting up Github using the client in Windows and Linux. Linux users must use the terminal.

Before continuing, register at github.com and send us your username so that we can add you to the project.

Windows

Download and install the Gitub client from http://windows.github.com/.

Login using your Github username and password.

Login_screenshot

Clone the repository you want to work on by clicking the CLONE button.

Clone_screenshot

That repository is now on your hard drive (under local):

Local_screenshot

Right-click on the repository to go to the folder. Edit the files and save them.

Note that Github will keep track of whether there are changes or not. In this case there are no changes:

Nochanges_screenshot

If there are changes, you must "commit" them. Enter a commit message in the yellow box on the upper right of the screen describing what you have done and commit the changes.

Commit_screenshot

Next sync with the Github server so that others can receive your changes by clicking on the sync button in the center top of the window:

Sync_screenshot

The next time you open Github:Windows, sync with the server again to get any changes made by others. Make sure that the sync button shows "in sync" before editing further.

Mac

Download and install the Gitub client from http://mac.github.com/.

From the Preferences menu, login using your Github username and password.

Mac_Login_screenshot

Clone the repository you want to work on by clicking the Clone to Computer button.

Clone_screenshot

That repository is now on your hard drive (under Your Computer, My Repositories):

Local_screenshot

Control-click on the repository and click Show in Finder to go to the folder where the files are stored. Edit the files and save them.

Note that Github will keep track of whether there are changes or not. If there are changes, you must "commit" them from the Changes tab (on the left column). Enter a commit message in the box that has Commit Summary in grey, adding detail to the box below if desired. Then click Commit to commit the changes.

Commit_screenshot

Next sync with the Github server so that others can receive your changes by clicking on the Sync button:

Sync_screenshot

The next time you open Github, sync with the server again to get any changes made by others. Make sure that you do this before editing further.

Powered by Drupal, an open source content management system