Processing.js

Previously, I posted a tutorial on setting up GitHub and Git Bash. Now I would like to show you how to get new code into ur repository.

Steps:

1. Create a local Branch
2. Create a remote Branch
3. Add files to your local Branch
4. Commit changes to your local Branch
5. Push the new branch to GitHub

Those are the steps, now before we get started bookmark this Git cheat sheet its a good reference.

Note: all commands are entered in Git Bash command prompt. How do u open it? On Vista, Start -> Search for Quick->Right click ‘Quick Launch’ result->Select ‘Git Bash Here’

Create a Local Branch

A local branch is a version of your code package saved on your home machine. I believe you can have as many branches as you want.

1. git branch<branch name>

Create a Remote Branch

A remote branch is one that sits on the GitHub social coding site, users can select this branch and download code that belongs to this branch alone.

1. git push origin origin:refs/heads/<branch name>

The command window will give you a confirmation:

——————————————————————

Total 0 (delta 0), reused 0 (delta 0)

To git@github.com:annasob/processing-js.git

* [new branch] origin/HEAD -> withCursor2

——————————————————————

If you get an error saying repository not found make sure your config file is correct. Here is a snippet:

——————————————————————-

[remote "origin"]

fetch = +refs/heads/*:refs/remotes/origin/*

url = git@github.com:annasob/processing-js.git

[branch "master"]

remote = origin

merge = refs/heads/master
——————————————————————

Just in case you created a branch and want to delete it use this:

1. git push git@github.com:annasob/processing-js.git : origin/<branch name>

The command window will give you a confirmation:

——————————————————————————-

Total 0 (delta 0), reused 0 (delta 0)

To git@github.com:annasob/processing-js.git

* [new branch] origin/withCursor2 -> origin/withCursor2

———————————————————————————

Add files to your local branch
I am not sure if this makes a difference, but i just opened the processing-js directory I was working in and dragged any new files/folders I needed to have. Alternatively, you can use these commands, well first you have to tell Git which branch you are going to be working with:

Commit changes to your local Branch

Before you can submit the changes to GitHub, you have to commit them on your local machine.

1. git commit -a

This command will commit all of your changes and allow you to write a message in vim. Vim guide.

The message should be significant, as everyone will read it to see whats new from the previous versions.

Push the new branch to GitHub

Now you are ready to update the remote branch.

1. git push git@github.com:annasob/processing-js.git <remote branch name>

Note: you will need to put your own repository path in. Here is the message you will see:

——————————————————————–

Counting objects: 7, done.

Delta compression using up to 2 threads.

Compressing objects: 100% (3/3), done.

Writing objects: 100% (5/5), 617 bytes, done.

Total 5 (delta 1), reused 0 (delta 0)

To git@github.com:annasob/processing-js.git

8e069aa..dd33dfd withCursor -> withCursor

———————————————————————-

After you do all of this, log in to ur GitHub account and go to your repository. If you roll over ‘all branches’ you will see your new branch. Select it and try downloading the contents to ensure that nothing is missing.

Note, I have reported a bug, somehow the download functionality in GitHub doesn’t always work.

Hope this tutorial helps Feel free to post comments.

View all of my blogs

I have a Vista machine and i needed to set up Git and GitHub.

What is Git and GitHub? Basically it is an online code sharing community that uses repositories to maintain code versions.

What will u need to do?

1. Set up a free account on the GitHub social network and a repository
2. Download and install Source Code Management tool
3. Link the two together

Set up a free account

• Go to http://github.com and select “Pricing and Signup”

Sign UP

• Click “Sign Up” in the Open Source table

Free Option

• Fill in the registration form (leave SSH Public Key blank)

Setting up a repository

So there should only be one code repository per project. If a repository DOESN’T exist u can create one. However, if it DOES exist then you have to fork it.

FORK: By forking a project instead of cloning, creating a new GitHub repo, and pushing to it, you allow us to create a link between your fork and the original. This link helps us keep you informed of changes to the original codebase and make it trivial for you to notify the originator of changes that you have made and would like have reviewed.

For the purpose of my setup, I will be forking an existing processing.js repository

• If u are not logged in (to GitHub), log in. This will bring u to the home page, if not click on the GitHub Social Coding logo on the upper left corner of the page.

GitHub Home

• Click on “Find a Repository”
• Type “processing.js” in the search textbox (don’t change any defaults) and press enter

Search For Repository

• Select the “jeresig/processing-js” Repository
• Select the “fork” button (found beside the repository name)

Fork

Download and install Source Code Management tool

For windows, you can use cygwin or msysgit. I am using msysgit.

• Download the latest version from Google Code. Run the executable
• Press “Next” for most of the configuration except for the following screens:

Git Configuration

Git Configuration

Git Configuration

• Once Setup is complete, you can generate your SSH key. Open up the msysgit cmd: Start=> Search for “Quick Launch” folder => right click => Select “Git Bash Here”

Quick Launch

• The command window should open up. Type ssh-keygen -C “youremailinquotes@com” -t rsa to create a key. Here is another tutorial on SSH Keygen.

SSH Key Gen

Note: You do not need to put in any input after the ssh-keygen command, just press enter after every prompt.

• Identify yourself on Git using these two commands:

1. git config –global user.name “yournameinquotes”
2. git config –global user.email youremail@com

• Tell GitHub apps about u. Log into GitHub, select “Account” (top right corner), select “Global Git Config”. Copy and paste the commands in the pop-up into the Git Bash command prompt.

Git Blobal Configuration

Link the two together

• Add SSH key you just created into GitHub. Open SSH key in a text editor. Looking back at the ssh-keygen command, you identified “C:\Users\YourNameHere\.ssh\” as the path. Open this folder (it might be hidden). Open id_rsa.pub in a text editor and copy its entire contents.
• Go back to your GitHub Account and just under the “Global Git Config” we used 2 steps above u will find the “SSH Public Key” Section. Click “Add a Key” and paste the SSH key into the “Key” textarea. DO NOT include any extra spaces. You can leave the “Title” blank if u wish. Don’t forget to press “Add Key”

Add the SSH Key

• Test to make sure that everything works. On the Git Bash command prompt type the following command: ssh git@github.com I got a connection confirmation prompt and I had to type yes.

Verification

• Get the actual code in the Repository using this Git Command: git clone git://github.com/annasob/processing-js.git processing
• To get the path of ur repository: Log into GitHub. On the homepage click on the Repository you want to clone. Once the repository information comes up look for “Public Clone URL” or “Your Clone Url”