Jump to: navigation, search

Difference between revisions of "AddingYourBlog"

m (Change github link to cgit)
 
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__
+
= Adding Your Blog To Planet OpenStack =
= Adding Your Blog =
 
  
To add your feed to [http://planet.openstack.org Planet OpenStack], you must be an member of the [http://launchpad.net/~openstack-planet OpenStack Planet] team. You can either be a member directly, or through memberships in [http://launchpad.net/~swift-core Swfit Core], [http://launchpad.net/~nova-core Nova Core] or the [http://launchpad.net/~openstack OpenStack Core] teams.
+
The config for the planet aggregator is kept in a git repo and managed by Gerrit. To add your feed to [http://planet.openstack.org Planet OpenStack], simply clone git://git.openstack.org/openstack/openstack-planet and then follow the normal [[OpenStack]] [http://docs.openstack.org/infra/manual/developers.html#development-workflow development workflow] to submit your change.
  
 
== Separating Content ==
 
== Separating Content ==
Line 10: Line 9:
 
* 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
 
* 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.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 [http://wordpress.org/support/topic/225303  forum discussion] for details.
+
** '''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 [http://wordpress.org/support/topic/225303  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 [http://learnbythedrop.com/drop/45 this blog post] under "Taxonomy Generated Feeds" for more information.
 
* In '''Drupal''': you can use taxonomies to tag your content and have RSS feeds generated from those taxonomies. See [http://learnbythedrop.com/drop/45 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 '''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'''
 
* 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 [http://pipes.yahoo.com/pipes/  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.  
+
* In '''Tumblr''': the feed URL for a specific tag would be '''http://example.tumblr.com/tagged/foobar/rss'''
 +
* For others with no filtering support: You can use [http://pipes.yahoo.com/pipes/  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 ==
 
== Adding Your Feed ==
  
You first need to add an SSH public key to your launchpad account, if you haven't done so already. You can do this from here:
+
Check out the configuration files from git:
  
<code><nowiki>https://launchpad.net/+me/+editsshkeys</nowiki></code>
+
<!-- ##$ git clone git://git.openstack.org/openstack/openstack-planet -->
 
 
Then to add your feed, first install the "bzr" package if you haven't done so already:
 
  
 
<pre><nowiki>
 
<pre><nowiki>
$sudo apt-get install bzr
+
$ git clone git://git.openstack.org/openstack/openstack-planet
 +
$ cd openstack-planet
 
</nowiki></pre>
 
</nowiki></pre>
  
 
Next, check out the configuration files from the launchpad bzr tree.
 
 
<!-- ##$ bzr checkout bzr+ssh://yourusername@bazaar.launchpad.net/~openstack-planet/config/main planet-openstack -->
 
 
<pre><nowiki>
 
$ bzr launchpad-login yourusername
 
$ bzr checkout lp:~openstack-planet/config/main planet-openstack
 
$ cd planet-openstack/
 
</nowiki></pre>
 
 
 
/!\ If you don't have the host key for bazaar.launchpad.net, initial checkout will ask you to authenticate. The RSA key fingerprint for this host is: 9d:38:3a:63:b1:d5:6f:c4:44:67:53:49:2e:ee:fc:89
 
 
/!\ If this checkout fails with a "No branch found" message,  it is likely that you are not listed as an [https://launchpad.net/~openstack-planet OpenStack Planet Member.] If the checkout fails with a Permission denied error, it is likely that your SSH key isn't in Launchpad, or that you have your username wrong.
 
  
 
Next, place your hackergotchi<<[[FootNote]](Your hackergotchi should be scaled to roughly 100x100 pixels, give or take.)>> into the <code><nowiki>images/</nowiki></code> subdirectory:
 
Next, place your hackergotchi<<[[FootNote]](Your hackergotchi should be scaled to roughly 100x100 pixels, give or take.)>> into the <code><nowiki>images/</nowiki></code> subdirectory:
Line 49: Line 33:
 
<pre><nowiki>
 
<pre><nowiki>
 
$ cp ~/hackergotchi.png images/yourusername.png
 
$ cp ~/hackergotchi.png images/yourusername.png
$ bzr add images/yourusername.png
+
$ git add images/yourusername.png
 
</nowiki></pre>
 
</nowiki></pre>
  
Line 71: Line 55:
  
 
<pre><nowiki>
 
<pre><nowiki>
$ bzr diff
+
$ git commit -a -m "Added <yourusername> to Planet OpenStack"
$ bzr commit -m "Added yourusername to Planet OpenStack"
+
$ git review
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
= Something's wrong? =
  
/!\ If this commit fails with a "bzr: ERROR: Cannot lock [[LockDir]](lp-70455952:///~openstack-planet/config/main/.bzr/branchlock): Transport operation not possible: readonly transport" message,  it means that you are not listed as an [https://launchpad.net/~openstack-planet OpenStack Planet Member.]
+
Contact OpenStack Infra team on IRC #openstack-infra or mailing list openstack-infra@lists.openstack.org.
  
/!\ 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.
+
[[category: contribute]]

Latest revision as of 18:40, 14 December 2016

Adding Your Blog To Planet OpenStack

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://git.openstack.org/openstack/openstack-planet and then follow the normal OpenStack development workflow 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.

Adding Your Feed

Check out the configuration files from git:


$ git clone git://git.openstack.org/openstack/openstack-planet
$ 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

Something's wrong?

Contact OpenStack Infra team on IRC #openstack-infra or mailing list openstack-infra@lists.openstack.org.