Ubuntu Wiki

To add your feed to [http://planet.ubuntu.com Planet Ubuntu], you must be an Ubuntu MemberFootNote(You must either be one of the UbuntuMembers on Launchpad, or be in one of its member teams.), and your ssh key must be included in your Launchpad account information.

Subscribed feeds ought to be at least occasionally relevant to Ubuntu, although the only hard and fast rule is "don't annoy people." We reserve the right to remove any feed that is inaccessible, flooding the page, or otherwise interfering with the operation of the Planet.

Adding Your Feed

You first need to add an SSH public key to your launchpad account, if you haven't done so already. If your launchpad username is jrhakr, then you would go to:

https://launchpad.net/people/jrhakr/+editsshkeys

Then to add your feed, first install the "bzr" and "paramiko" packages if you haven't done so already:

$sudo apt-get install bzr python-paramiko

Next, check out the configuration files from the launchpad bzr tree.

$ bzr checkout sftp://jrhakr@bazaar.launchpad.net/~planet-ubuntu/config/main planet-ubuntu
$ cd planet-ubuntu/

Next, place your hackergotchiFootNote(Your hackergotchi should be scaled to roughly 100x100 pixels, give or take.) into the heads/ subdirectory:

$ cp ~/hackergotchi.png heads/jrhakr.png
$ bzr add heads/jrhakr.png

If you don't have a hackergotchi to add right away, comment out the line (using # at the beginning) or leave the entire line out.

Once you've done that, add a stanza like the following to the end of the config.ini file:

[http://blog.example.com/~jrhakr/feed?category=ubuntu-only]
name = J. Random Hacker
face = jrhakr.png
nick = jrhakr

Please use your real name at least somewhere in the 'name' field.

When you are satisfied that your entry is correct, it's time to check in your changes:

$ bzr commit -m "Added jrhakr to Planet Ubuntu"

Please note that Planet runs from cron, and it relies on the work of some periodic events on the Launchpad server. Your changes could take up to two hours to take effect.