Nukastle - UK Indymedia aggregator project

This is the wiki for the Nukastle project, which aims to build a new aggregated front page for the UK Indymedia website using Drupal. Here you can check out a copy of the code onto your local machine so you can get coding and help contribute to the project. To get commit access, send an email to where all development email should be bandied about. here's how to get your hands on the code:

Installation notes on Drupal 6

drupal 6 and feedapi installation

Feeds to add

feeds to add to uk aggregator

Grab the code

git clone git://git.escapegoat.org/nukastle.git

OR if you can only check out via http due to firewall restrictions:

git clone http://git.escapegoat.org/git/nukastle.git

If you know that you have commit access to the code, you can get it here:

git clone git@git.escapegoat.org:nukastle.git

Basic Git commands

Git becomes easier the more you use it, the main priniciples to remember are as follows, but there's loads of good tutorials out there to find.

OK, so say you have a file in your folder called info.txt which you open in an editor, change a few words in and save. To add the file to be tracked by git, you use the following command:

git add info.txt

Then go ahead and change more files, say info2.txt and info3.txt, ten add these to be tracked as well:

git add info2.txt info3.txt

When you have finished editing files, or have just made a major change, you commit locally (unlike svn/cvs where you committo a central server at this point) with:

git commit -m "Leave a message for other users about the changes you made here" 

To remove a file fom bing tracked from git, and from the working directory, use the following command before committing:

git rm info.txt

Then if you want to, keep changing, adding and committing in this way, then when you are ready to push it to the hosting server, do so with the following command:

git push git@git.escapegoat.org:nukastle.git

In the same way, to pull down the latest changes from the server:

git pull git@git.escapegoat.org:nukastle.git

Branches and logs

If you want to create a branch and move to it on your local machine to work on without altering the master branch of the project, you can do so by:

git checkout -b MyNewBranchCalledSomething

To see what branches are available already on your machine:

git branch

and to change branches (eg to go back to the master branch)

git checkout master

This will moan at you if you have uncommitted changes on th branch you are switching from as you need to commit all changes before switching branches.

To look at the log of all changes made by all users so far, including the unique hash ID of each commit, it's as easy as.

git log

and to rollback to a previous change eg if you have made a mistake, you know where and want to revert to a previous version to do things differently, use git log to identify which it is, copy the hash at the top of each commit and do the following:

git checkout g3a556d66e5w47aaa57ada8

(or just enough of the hash so that it is unique)

Have Fun!

Also available in: HTML TXT