PlanetUbuntu

Differences between revisions 2 and 54 (spanning 52 versions)
Revision 2 as of 2006-08-04 10:11:11
Size: 1583
Editor: host-87-74-55-236
Comment: for multi-participant branches, checkout is better than get/push
Revision 54 as of 2011-04-15 18:26:27
Size: 8734
Editor: nigelbabu
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
To add your feed to [http://planet.ubuntu.com Planet Ubuntu], you must be an Ubuntu Member[[FootNote(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. <<Include(Community/ToolKit/MenuBar)>>
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(2)>>||
Line 3: Line 4:
Planet Ubuntu is a window into the world, work and lives of Ubuntu developers and contributors. This page describes the guidelines for posts on the planet, and how to add your blog if you are an Ubuntu Member.
Line 4: Line 6:
Subscribed feeds must be at least ''occasionally'' relevant to Ubuntu, and we ask that you make use of your software's category or tag features to control which posts will appear on [http://planet.ubuntu.com Planet Ubuntu]. We reserve the right to remove any feed that is inaccessible, flooding the page with off-topic entries, or otherwise interfering with the operation of the Planet. = Guidelines =

== Confidential Information ==

Ubuntu members who publish blogs on Planet Ubuntu should endeavour to ensure that company confidential information is not posted there. The planet administrators will make a reasonable judgement about the sensitivity of information in blogs re-published there, and will consider requests for the removal of content on those grounds. However, we cannot guarantee that we will be able to establish the confidentiality of any given piece of information, and will not automatically remove posts on request.

You can contact the planet sysadmins by emailing rt@ubuntu.com.

It is imperative that where a post is removed, the relevant user is contacted and respectfully explained the reason why - miscommunication is the main problem in such situations.

== Inappropriate Posts ==

The Code of Conduct applies to all actions by Ubuntu members, including posting to their blogs.

Where a community member is offended by content on another member's blog, the best approach will generally be to attempt to resolve the issue peacefully through respectful discussion. In extremely serious cases and in the event that it is not possible to resolve the issue, the CommunityCouncil can mediate the problem.

By and large, we take a "liberal Western" view of matters moral. That means we don't blush too much when sex is discussed, though we prefer to keep it practical, to keep personal preferences private, and never to criticize or belittle others on gender or sexuality grounds.

If you are contacted by a community member in regard to blog posts, we would ask you to respond to their comments politely and in good faith. Don't let a difference of style or opinion spiral into a conflict which will make it impossible for you to collaborate with that person on matters of mutual interest. No single "set of rules" would let us all get along - but we expect everyone in the Ubuntu community to make a real effort to treat one another respectfully, across great cultural divides.

 * possibly break apart the legal and confidential sections
 * add specific examples
 * consider http://blogging.wikia.com/wiki/BCC

== Language ==

As a rule of thumb, English should be considered the "lingua franca" of Planet Ubuntu. There are a number of language and locale specific Planets run by Ubuntu LoCo Teams, which are a great way for teams to get news out in their local language. However, the official Ubuntu Planet should attempt to use English where possible to reach the widest possible audience.

== Corporate Blogs ==

Planet Ubuntu is not only a window to the world of individuals who contribute to Ubuntu, it is also a place for companies. Given the unique nature of corporations, a few additional guidelines are in place:

 * posts to be of a non-advertising nature
 * Planet should only be subscribed to a subset of blog entries where a conscious decision is made to put the blog post on Ubuntu Planet. For example, tagging entries with an "ubuntuplanet" tag, and subscribing planet to a feed of blog posts with that tag, would be acceptable. This is to allow a corporation to have a single blog with more advertising style posts that don't get syndicated.
 * the CommunityCouncil must give permission
 * there is a 3 month trial period at which point the CC review
 * the company must have at least one Ubuntu member who can take responsibility for the blog
 * the company must demonstrate sustained and active interest in the Ubuntu community

Current approved Corporate Blogs are:
 * Canonical Blog
 * Oxford Archaeology blog

= Adding Your Blog =

To add your feed to [[http://planet.ubuntu.com|Planet Ubuntu]], you must be an [[Membership|Ubuntu Member]] and have been added to the [[https://launchpad.net/~ubuntumembers|~ubuntumembers Launchpad team]] or one of its subteams, and your ssh key must be included in your Launchpad account information.

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

 * In '''Blogger''': the feed URL for a specific label would be '''http://xxx.blogspot.com/feeds/posts/default/-/labelname'''
 * In '''Word``Press''': 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
  * '''Word``Press.com users:''' RSS2 feeds have a small problem and atom feeds seem to change time stamp on update, so you need to add '''?mrss=off''' to the end of the RSS2 feed. Example '''http://blog.site.com/category/ubuntu/feed/?mrss=off'''
  * '''Word``Press 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.
 * 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 '''Live``Journal''': 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 '''Tumblr''': the feed URL for a specific tag would be '''http://youruser.tumblr.com/tagged/foobar/rss'''
 * For other blogging systems 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.
Line 8: Line 68:
To add your feed, first check out the configuration files from the launchpad bzr tree: 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:

{{{https://launchpad.net/+me/+editsshkeys}}}

Then to add your feed, first install the "bzr" package if you haven't done so already:
{{{
$sudo apt-get install bzr
}}}

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

##$ bzr checkout bzr+ssh://yourusername@bazaar.launchpad.net/~planet-ubuntu/config/main planet-ubuntu
{{{
$ bzr launchpad-login yourusername
$ bzr checkout lp:~planet-ubuntu/config/main planet-ubuntu
$ cd planet-ubuntu/
}}}

/!\ 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/~ubuntumembers|Ubuntu Member.]] Read more about how the [[http://www.ubuntu.com/community/processes/newmember|new member process]] works. 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 {{{heads/}}} subdirectory:
Line 11: Line 93:
$ bzr checkout sftp://bazaar.launchpad.net/~planet-ubuntu/config/main $ cp ~/hackergotchi.png heads/yourusername.png
$ bzr add heads/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 {{{config.ini}}} file:

{{{
[http://blog.example.com/~yourusername/feed?category=ubuntu-only]
name = Your Name Here
face = yourusername.png
nick = yourusername
Line 14: Line 107:
Next, place your hackergotchi into the {{{heads/}}} subdirectory:

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

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

{{{
[http://blog.example.com/~jrhakr/feed?category=ubuntu-only]
name = J. Random Hacker
fake = jrhakr.png
nick = jrhakr
}}}
/!\ Please use your real name at least somewhere in the 'name' field.
Line 33: Line 112:
$ bzr commit -m "Added jrhakr to Planet Ubuntu" $ bzr diff
$ bzr commit -m "Added yourusername to Planet Ubuntu"

Planet Ubuntu is a window into the world, work and lives of Ubuntu developers and contributors. This page describes the guidelines for posts on the planet, and how to add your blog if you are an Ubuntu Member.

Guidelines

Confidential Information

Ubuntu members who publish blogs on Planet Ubuntu should endeavour to ensure that company confidential information is not posted there. The planet administrators will make a reasonable judgement about the sensitivity of information in blogs re-published there, and will consider requests for the removal of content on those grounds. However, we cannot guarantee that we will be able to establish the confidentiality of any given piece of information, and will not automatically remove posts on request.

You can contact the planet sysadmins by emailing rt@ubuntu.com.

It is imperative that where a post is removed, the relevant user is contacted and respectfully explained the reason why - miscommunication is the main problem in such situations.

Inappropriate Posts

The Code of Conduct applies to all actions by Ubuntu members, including posting to their blogs.

Where a community member is offended by content on another member's blog, the best approach will generally be to attempt to resolve the issue peacefully through respectful discussion. In extremely serious cases and in the event that it is not possible to resolve the issue, the CommunityCouncil can mediate the problem.

By and large, we take a "liberal Western" view of matters moral. That means we don't blush too much when sex is discussed, though we prefer to keep it practical, to keep personal preferences private, and never to criticize or belittle others on gender or sexuality grounds.

If you are contacted by a community member in regard to blog posts, we would ask you to respond to their comments politely and in good faith. Don't let a difference of style or opinion spiral into a conflict which will make it impossible for you to collaborate with that person on matters of mutual interest. No single "set of rules" would let us all get along - but we expect everyone in the Ubuntu community to make a real effort to treat one another respectfully, across great cultural divides.

Language

As a rule of thumb, English should be considered the "lingua franca" of Planet Ubuntu. There are a number of language and locale specific Planets run by Ubuntu LoCo Teams, which are a great way for teams to get news out in their local language. However, the official Ubuntu Planet should attempt to use English where possible to reach the widest possible audience.

Corporate Blogs

Planet Ubuntu is not only a window to the world of individuals who contribute to Ubuntu, it is also a place for companies. Given the unique nature of corporations, a few additional guidelines are in place:

  • posts to be of a non-advertising nature
  • Planet should only be subscribed to a subset of blog entries where a conscious decision is made to put the blog post on Ubuntu Planet. For example, tagging entries with an "ubuntuplanet" tag, and subscribing planet to a feed of blog posts with that tag, would be acceptable. This is to allow a corporation to have a single blog with more advertising style posts that don't get syndicated.
  • the CommunityCouncil must give permission

  • there is a 3 month trial period at which point the CC review
  • the company must have at least one Ubuntu member who can take responsibility for the blog
  • the company must demonstrate sustained and active interest in the Ubuntu community

Current approved Corporate Blogs are:

  • Canonical Blog
  • Oxford Archaeology blog

Adding Your Blog

To add your feed to Planet Ubuntu, you must be an Ubuntu Member and have been added to the ~ubuntumembers Launchpad team or one of its subteams, and your ssh key must be included in your Launchpad account information.

Separating Content

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

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:

https://launchpad.net/+me/+editsshkeys

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

$sudo apt-get install bzr

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

$ bzr launchpad-login yourusername
$ bzr checkout lp:~planet-ubuntu/config/main planet-ubuntu
$ cd planet-ubuntu/

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

Warning /!\ If this checkout fails with a "No branch found" message, it is likely that you are not listed as an Ubuntu Member. Read more about how the new member process works. 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 hackergotchi1 into the heads/ subdirectory:

$ cp ~/hackergotchi.png heads/yourusername.png
$ bzr add heads/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 config.ini file:

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

Warning /!\ 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 diff
$ bzr commit -m "Added yourusername to Planet Ubuntu"

Warning /!\ 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.

  1. Your hackergotchi should be scaled to roughly 100x100 pixels, give or take. (1)

PlanetUbuntu (last edited 2021-05-27 06:32:12 by fitojb)