Using your own fork of Cells and Apotomo in your Rails project

Fork us!

There are lots of good reasons to want your own fork of Cells and Apotomo — to have a version to call your own that you can use in your projects, that you can control updates to by pulling patches from other forks, and to have a place that you can contribute your own bug fixes and improvements that can be pulled into the canonical versions, etc. So, here is how.

First, fork the projects from apotonick’s repositories. This will require that you have a Github account, natch. From http://github.com/apotonick/cells and http://github.com/apotonick/apotomo, press the “fork” button next to the repository name.

Wait for it. Wait for it. There! Did you feel the sudden sense of ownership? The realization that this is your fork of these awesome projects? That you are an OSS stud? You know it is true.

Next, assuming you have a Rails project called “better_than_django”, you would step into the vendor/plugins subfolder, and do this, replacing “your_github_username” with the appropriate value, obvi:

git submodule add git://github.com/your_github_username/cells
git submodule add git://github.com/your_github_username/apotomo
git init
git update

For a very good tutorial on submodules, go here (RT @ apotonick: thanks for link, Winston!).