Planet Debian is currently run by Benjamin Mako Hill, Joerg Jaspert, and Jordi Mallach, reachable at firstname.lastname@example.org.
Can I Be On Planet?
Planet Debian is for any active and directly involved participant in the Debian development community. Inclusion in Planet should reflect a relationship that already exists -- it is not meant to create one. Inclusion is not restricted to people who are currently Debian developers nor are ex-developers necessarily barred from inclusion.
Defining activity and direct involvement is tough and there are many ways of participating in Debian (e.g., packaging, translations, administration, etc). We are happy to consider all of these types of involvement for the purposes of inclusion in Planet. In terms of deciding what is enough activity, we are daunted by the fact that there has been academic research on the difficulties of deciding what an active member in Debian is. As a result we will continue to rely primarily on what blog owners themselves feel unless the evidence available to us points to the contrary.
Planet participants should include feeds that provide stable permanent URLs so that they do not flood planet repeatedly and should include content in English only. An inability to do either of these will be grounds for exclusion from Planet until this can be fixed. (There are planets of other languages available if you do want to write in one of those languages.)
What Can I Post On Planet
What Can I Post On Planet?
Planet Debian aims to aggregate the blog posts of people who are active in Debian and not only to aggregate the blog posts about Debian. The point is to provide a window into the community itself. Posts that are about Debian are a great idea and some people will choose to only syndicate "on topic" posts. But other posts are also welcome! We want to learn about the people, their life, opinions (even political) and doings.
There are three simple rules about content on Planet Debian:
Provide individual feeds for each language you post in. The main language for Planet is English.1
- Try not to annoy people. While there is absolutely no requirement that posts need to be about Debian, if there are a subset of posts that are annoying a large number of people and generating many complaints, you may be asked to consider providing a feed without the posts in question. If you stay away from advertising content (or content that might be confused as such) and from excessively personal information, you should be fine.
Be very careful including material from external sites (ie, not your own blog/domain). The occasional picture from elsewhere is fine, but anything that can be (or is) used to track reader's behavior (commonly called webbugs2) is considered bad and grounds for exclusion from Planet. If you regularly need external content, consider providing that from your own site.
1 There are Planets in other languages. Should yours not yet have one, mail email@example.com and ask for one. Have 5 people with you to join the new Planet and it will get created.
2 Feedburner, Google adwhatever/analytics, etc.
How do I add myself to Planet?
Any developer may add, amend or remove their own blog entry from Planet Debian. To do so, they must have an account at alioth.debian.org. Any Debian developer can use their Alioth account to modify planet entries. Other Debian contributors can be added to the Alioth group and then also make changes to the configuration.
If you already have an Alioth account and are already a member of the project or are a Debian developer, simply do the following:
svn checkout svn+ssh://anonscm.debian.org/svn/planet-debian/trunk/config cd config vi config.ini Entries should be in alphabetical order at the bottom of the file and look like this: [http://url.to/your/feed] name = Your Name svn commit -m "add/edit/remove Your Name"
If you're advocating, sponsoring, helping or managing someone in the NM queue, or a regular non-Developer contributor, you may add them as well.
Do not modify anything besides the direct feed entries.
Hackergotchi are the little face pictures that can appear next to your entry. They should be a transparent PNG of just your head, preferably with a drop shadow behind it. Aim for around 65x85; it's not a strict size, but please don't make them much bigger than this. Please do stick to your head, not a whole square of whatever environment the head happened to be in at the time the picture was taken. It is not hard to get one done right.
Here's a good HOWTO on how to make them:
Then on here do:
svn checkout svn+ssh://anonscm.debian.org/svn/planet-debian/trunk/heads cd heads # place your PNG file here, $USER.png is a good filename svn add $USER.png svn commit -m "add/change Your Name" svn checkout svn+ssh://anonscm.debian.org/svn/planet-debian/trunk/config cd config vi config.ini Find your feed entry and add "face", "facewidth" and "faceheight" entries, like this: [http://url.to/your/feed] name = Your Name face = $USER.png facewidth = 65 faceheight = 85 svn commit -m "add/edit/remove Your Name hackergotchi"
The following template is sent to people who email firstname.lastname@example.org about adding their RSS Feed to Planet:
Any Debian developer or any other active contributor to the project is welcome to be added to planet. If you're a developer, you can simply add your own blog to the config file which is kept in a world-writable Subversion repository on alioth. The easiest thing to do is read the instructions here: http://wiki.debian.org/PlanetDebian If you're not a developer, you'll need to have one of us add you. In terms of content, there are two rules. The first rule is to provide an English language only feed. The second rule is the rather vague guideline of "don't annoy people." There is absolutely no requirement that posts need to be about Debian. However, if there are a subset of posts that you are annoying a large number of people, one of us will ask you you to consider providing a feed without the posts in question. This has only happened a few times in the past. If you stay away from advertising content (or content that might be confused as such) and from excessively personal information, you should be fine. I'll be happy to welcome you to planet! Please let us at email@example.com know if you have any questions.
Testing changes to the config/templates
If you are making changes to the config/templates and want to test them, you can use this series of commands to setup a copy of planet on your computer.
sudo apt-get install planet-venus svn co svn://anonscm.debian.org/svn/planet-debian/trunk planet mkdir -p log languages ln -sf ../heads www sed -i -e s_/srv/planet.debian.org_`pwd`_g cron/* sed -i -e s_./code/venus/planet.py_planet_g cron/* sed -i -e s_code/templates_templates_g config/* cron/* sed -i -e s_code/filters_filters_g config/* cron/* sed -i -e s_config/alioth_config_g config/* cron/* sed -i -e s_config/languages_languages_g config/* cron/* sed -i -e s_www/heads_heads_g config/* cron/* sed -i -e 's_/usr/local/bin/static-update-component_echo push static site_g' config/* cron/* for f in cron/* ; do $f done
Planet via Mailing list
People willing to receive DebianPlanet by mail can subscribe the mailing list.
send a mail containing simply subscribe ticker-planetdebian to firstname.lastname@example.org
(for more information, read the announcement on http://lists.debian.org/debian-devel-announce/2008/04/msg00013.html )
Planet in other Languages
Planet is now available in various Languages. Follow the Links below "Planetarium" on http://planet.debian.org/ to find them.
If you want to have another language set up, follow the instructions behind http://blog.ganneff.de/blog/2008/12/21/planet-i18n.html
Planet of Debian users
The traditional planets have no restrictions on topic but they are limited to Debian contributors. The planet of Debian users have a different purpose, they are open to all Debian users who blog about their favorite distribution.
To be added to a "user planet", the submitted RSS feed must contain only articles which are related to Debian (such as Debian usage stories, HOWTO taking Debian as reference distribution, opinions on Debian, etc.) and you must find a Debian contributor who will add your feed in the planet. Some "user planets" have dedicated administrators that you can contact.
There's no "right" to be syndicated on such a planet, so please be civil, respectful, otherwise your feed might get removed from the planet.
Other Debian related Planets
Planet Debian JP: for Debian developers who write Japanese
Planeta Debian Brasil: for Debian developers who are from Brasil
Planet Debian PT: for Debian developers who write Portugese
Planet DebianHK: for Debian related people from Hong Kong
Planète des utilisateurs Debian: for Debian users who write French
Planet Debian Administration: for sysadmins who use Debian
Planet Debian upstream: for upstream developers of software distributed by Debian
FAQ (some sort of)
Can I add a team blog?
Planet wants to provide a window into the community. Teams are an important part of Debian and the community, so yes, you can. Simply make sure that it is clearly visible which team member posted the entry. This is usually done by adjusting your teams blog so it shows "BLOG TITLE (by Human Name)". For good examples see the DebConf and Debian System Administrator feeds.
My blog updates take a long time to appear on Planet
If you find that Planet takes hours before it notices a new blog post from you, check your webserver settings. It might happen that your webserver provides Expire headers that are something like "access + 24 hours" (or more). You want to change that to a much smaller number for the filetype of your feed.