The official Insoshi Git repository is hosted on GitHub.

You'll need to create two clones:

1. A local repository for your development
   
2. A forked repository hosted on GitHub to make your updates publicly available
   

Local Insoshi Repository

To create a local clone of the Insoshi repository, go to the directory where you want to place the clone and run

  git clone git://github.com/insoshi/insoshi.git

This will create the directory insoshi (notice the missing .git), initial the repository and download the contents of the remote repository.  The download may take a moment or two as it includes required plug-ins and frozen Rails gems in addition to the Insoshi code.

You should be able to change into the directory and see a file listing similar to this one:

  insoshi $ ls
  INSTALL         app             init.rb         rsa_key         stories
  LICENSE         config          lib             rsa_key.pub     vendor
  README          db              log             script
  Rakefile        doc             public          spec

This is your local master branch which has automatically been configured to track the official master branch.

Before you go any further, you should create a local tracking branch for the official edge branch:

 git branch --track edge origin/edge

Forked Repository on GitHub

In order to share your updates with the Insoshi developer community, you'll need to have a publicly accessible Git repository.  The easiest way to do this is to create a fork of the Insoshi repository on GitHub.

If you don't already have a GitHub account, you can sign up for one at


Next, go to the Insoshi repository at


and click on the fork button:


You'll have a short wait while the fork takes place and will then be redirected to your forked repository.