Revision as of 01:30, 19 December 2013

Adding Your Blog

The config for the planet aggregator is kept in a git repo and managed by Gerrit. To add your feed to Planet OpenStack, simply clone git://github.com/openstack/openstack-planet.git and then follow the normal OpenStack GerritWorkflow to submit your change.

Separating Content

You may want to tag or label individual posts or categorize only some posts to be aggregated in Planet OpenStack. Different blogging software have different ways of providing feeds that will only aggregate posts you mark or tag under an "openstack" category, for example.

• In Blogger: the feed URL for a specific label would be http://xxx.blogspot.com/feeds/posts/default/-/labelname
• In WordPress: You can provide feeds to only specific categories on your site by adding the following to the end of the feed URL link: http://example.com/wp-rss2.php?cat=42 or http://example.com/category/categoryname/feed . Also see: http://codex.wordpress.org/WordPress_Feeds
  • WordPress.com users: RSS2 feeds have a small problem, so you need to use your Atom feed (http://username.wordpress.com/feed/atom) or add ?mrss=off to the end of the RSS2 feed. Example http://blog.site.com/category/ubuntu/feed/?mrss=off
  • WordPress 2.7 users: RSS2 feeds for a specific category doesn't work with the example feed link above when Permalink's set to Default. Use http://example.com/?cat=4&feed=rss2 instead. See forum discussion for details. For those who hosted their blogs on the official Wordpress.com site, which means you are not hosting wordpress on your own server, the latest stable release of WordPress is Version 3.8, so it should be safe to assume that this version specific problem does not affect you. (added 19 Dec 2013)
• In Drupal: you can use taxonomies to tag your content and have RSS feeds generated from those taxonomies. See this blog post under "Taxonomy Generated Feeds" for more information.
• In LiveJournal: the feed URL for a specific tag would be http://example.livejournal.com/data/rss?tag=foobar
• In Habari: the feed URL for a specific tag would be http://example.com/tag/foobar/atom
• For Tumblr and others with no filtering support: You can use Yahoo Pipes to filter your feed, but the links to your blog from the right Planet Ubuntu sidebar and from your face image will point to the feed also.

Adding Your Feed

Check out the configuration files from git:

$ git clone git://github.com/openstack/openstack-planet.git
$ cd openstack-planet

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

$ cp ~/hackergotchi.png images/yourusername.png
$ git add images/yourusername.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 planet.ini file:

[http://blog.example.com/~yourusername/feed?category=openstack]
name = Your Name Here
face = yourusername.png
nick = yourusername

/!\ 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:

$ git commit -a -m "Added yourusername to Planet OpenStack"
$ git review