Difference between revisions of "PlanetOSGeo"

From OSGeo
Jump to navigation Jump to search
m (→‎Feed Submission: removed english requirement. you agree? :))
 
(35 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
= Planet OSGeo =
 
= Planet OSGeo =
  
This page discusses the idea of Planet OSGeo based on the initial [http://lists.osgeo.org/pipermail/discuss/2008-February/003123.html discussion] on the mailing list.
+
[http://planet.osgeo.org/ Planet OSGeo] is a window into the world, work and lives of OSGeo members, hackers and contributors. If you are a friend of the OSGeo Foundation and would like your blog aggregated here, please read on.
 
 
Currently, there are two geospatial planets on the Web:
 
  
 +
== Credits ==
 +
Planet OSGeo was implemented after the initial [http://lists.osgeo.org/pipermail/discuss/2008-February/003123.html discussion] was discussed on the mailing list.
 +
OSGeo thanks Christopher Schmidt and James Fee - pioneers of building geospatial planetariums. Planet OSGeo is based on Christopher's planet, James' is here:
 
* [http://planetgs.com/ Planet Geospatial] maintained by James Fee aggregates wide variety of geospatial blogs
 
* [http://planetgs.com/ Planet Geospatial] maintained by James Fee aggregates wide variety of geospatial blogs
  
* [http://planetosgeo.crschmidt.net/ Planet OSGEO] maintained by Chris Schmidt - syndicates OSGeo-oriented blogs
+
== Contact ==
  
This submission proposes to base on these concepts and move Christopher's planet under the umbrella of OSGeo.
+
You can contact the planet admins by e-mail on <tt>planet (at) osgeo (dot) org</tt> and it is administered by:
  
I'd like to thank Christopher Schmidt and James Fee - pioneers of building geospatial planetariums.
+
* [[Jorge Sanz]]
  
== Planet OSGeo Proposal ==
+
== Planet OSGeo Guidelines ==
 
+
Please, read the following sections where basic guidelines are explained.
The Planet OSGeo - a website that aggregates blogs of active ''Friends of OSGeo'' and provide a window into the community itself.
 
 
 
[http://trac.osgeo.org/osgeo/ticket/206 Ticket #206 - Planet OSGeo RFC]
 
 
 
Status: '''approved'''
 
 
 
=== Planet Configuration ===
 
 
 
* Maintainers: Mateusz Loskot
 
 
 
* Domain: planet.osgeo.org
 
 
* Software: [http://intertwingly.net/code/venus/ Planet Venus] as recommended by [http://crschmidt.net/blog/archives/204/fed-up-with-planetgs/ Chris] and [http://lists.osgeo.org/pipermail/discuss/2008-February/003146.html James]
 
 
 
* Hardware: osgeo2
 
  
 
=== Planet Citizens ===  
 
=== Planet Citizens ===  
 +
* Planet is for any active and involved participant in the OSGeo Community.
 +
* There are many ways of participating in the OSGeo, so all of types of involvement are considered for the purposes of inclusion in Planet OSGeo: our  projects users and developers, speakers and advocates, translators, managers and presidents of OSGeo friendship companies and sponsors, etc.
 +
* In order to help building the OSGeo brand and credibility, it's recommended the Planet is not formed by anonymous individuals but its members use real names. Also, [http://planet.osgeo.org/heads/ heads] are highly recommended.
 +
* Some guidelines for acceptance or temporal/permanent ban are being discussed at [[Talk:PlanetOSGeo]]
  
* Planet is for any active and involved participant in the OSGeo Community..
+
=== Planet Content ===
 +
* Planet OSGeo aims to aggregate the blogs of people who are active on OSGeo and not only to aggregate the blog posts about OSGeo.
 +
* The Planet shall not do any content filter, however subscribed feeds ought to be at least occasionally relevant to OSGeo.
 +
* All opinions expressed in syndicated blogs are of the original authors and should not be considered as official opinion of the OSGeo Foundation body.
 +
* Planet users are free to submit "on-topic" posts by pointing specific categories/tags in their feeds. But other posts are also welcome.
 +
* It's a good idea to stay away from advertising content (or content that might be confused as such) and from excessively personal information
 +
* Please, don't annoy people
  
* There are many ways of participating in the OSGeo, so all of types of involvement are considered for the purposes of inclusion in Planet OSGeo: our  projects users and developers, speakers and advocates, translators, managers and presidents of OSGeo friendship companies and sponsors, etc.
+
=== Feed Submission ===
 +
* Feeds should provide stable permanent URL
 +
* Broken feeds will be excluded from the Planet
 +
* '''IMPORTANT''': Please, check your blog with http://validator.w3.org otherwise your feed may seriously break the Planet OSGeo look & feel.
  
* In order to help building the OSGeo brand and credibility, it's recommended the Planet is not formed by anonymous individuals but its members use real names. Also, [http://planet.gnome.org/heads/ heads] are highly recommended.
+
== How can I add my blog ==
 +
If you want to add your blog to the [http://planet.osgeo.org/ OSGeo Planet], send your request on ''planet at osgeo dot org''
 +
specifying:
  
=== Planet Content ===
+
* your contact name
 +
* your contact email
 +
* blog URL
 +
* blog feed URL (with the items you want to be displayed on Planet OSGeo)
 +
* blog name
 +
* primary language of your blog content
 +
* (not mandatory but recommended) include your [http://planet.osgeo.org/heads/ head] picture of max size of '''80x80 pixels'''
  
* Planet OSGeo aims to aggregate the blogs of people who are active on OSGeo and not only to aggregate the blog posts about OSGeo.
+
If you would like to syndicate only posts that belong to a particular category of your blog, you can do it by sending URL pointing to feed of that category, something that looks like:
  
* The Planet shall not do any content filter, however subscribed feeds ought to be at least occasionally relevant to OSGeo.
+
http://blog.myside.org/category/osgeo/feed
  
* All opinions expressed in syndicated blogs are of the original authors and should not be considered as official opinion of the OSGeo Foundation body.
+
= Planet OSGeo Implementation =
 +
The Planet OSGeo - a website that aggregates blogs of active ''Friends of OSGeo'' and provide a window into the community itself.
  
* Planet users are free to submit "on-topic" posts by pointing specific categories/tags in their feeds. But other posts are also welcome.
+
[http://trac.osgeo.org/osgeo/ticket/206 Ticket #206 - Planet OSGeo RFC]
  
* It's a good idea to stay away from advertising content (or content that might be confused as such) and from excessively personal information
+
Status: '''approved'''
  
* Please, don't annoy people
+
== Planet Configuration ==
 +
* Maintainers: [[Jorge Sanz]]
 +
* Domain: http://planet.osgeo.org
 +
* Software: [http://intertwingly.net/code/venus/ Planet Venus] as recommended by [http://crschmidt.net/blog/archives/204/fed-up-with-planetgs/ Chris] and [http://lists.osgeo.org/pipermail/discuss/2008-February/003146.html James]
 +
* Hardware:
 +
** <strike>osgeo2</strike> 
 +
** <strike>[[SAC_Service_Status#osgeo_7|osgeo7]]</strike>
 +
** [[SAC_Service_Status#geo-docs|osgeo3 (geo-docs container)]]
 +
=== Update Steps  ===
  
=== Feed Submission ===
+
* Edit master configuration file from a SVN clean checkout
  
* <s>Feeds should include content in English only</s>
+
https://svn.osgeo.org/osgeo/planet/venus/planet_osgeo.config
  
* Feeds should provide stable permanent URL
+
* Each entry should look like this:
  
* Broken feeds will be excluded from the Planet
+
# contact: contact@blogname.com
 +
# added: 2011-07-14
 +
[blog feed url]
 +
name = blog name
 +
link = blog url
 +
face = head-blogname.png
 +
facewidth = 80
 +
faceheight = 80
  
== Planet OSGeo Guidelines ==
+
* Save head image to
  
Please, red the [#Planet_Citizens Planet Citizens] and [#Planet_ Content Planet Content] sections where major guidelines are explained.
+
themes/osgeo_v2/heads/
  
=== How can I add my blog ===
+
* Commit, the planet will be updated over the next half an hour or so.
  
If you want to add your blog to the [http://planet.osgeo.org/ OSGeo Planet], send your request on ''planet at osgeo dot org''
+
=== Troubleshooting ===
specifying:
+
==== Stray Comments ====
 +
The planet.py scripts are picky about formatting, a stray comment hash is enough to kill it.  Confronted by this error:
 +
<code>
 +
...
 +
  File "/usr/local/venus/planet/config.py", line 90, in <lambda>
 +
    setattr(config, name, lambda section, default=default:
 +
    ValueError: invalid literal for int(): 40 #25
 +
</code>
 +
Led me to check the /usr/local/etc/planet_osgeo.config file and change the '''"items_per_page = 40 #25"''' to '''"items_per_page = 40"'''.  I guess the config parser doesn't ignore comments after all :)
  
* your blog URL
+
==== Test Scripts ====
  * your name
+
There are two scripts that are run during planet updates, one '''spider.py''' and one '''splice.py'''. If wondering where the update process is breaking try running '''spider.py''' with the config file as a variable. Then followed by '''splice.py''' - it might help you understand where it's dying or at least if dying is related to grabbing the feed updates or not.
  * URL of feed you want to syndicate
 
  
 
= References =
 
= References =
Line 83: Line 113:
  
 
[[Category: Infrastructure]]
 
[[Category: Infrastructure]]
 +
[[Category: Services]]
 
[[Category: Software Stack]]
 
[[Category: Software Stack]]
 
[[Category: WebCom]]
 
[[Category: WebCom]]

Latest revision as of 06:21, 16 January 2023

Planet OSGeo

Planet OSGeo is a window into the world, work and lives of OSGeo members, hackers and contributors. If you are a friend of the OSGeo Foundation and would like your blog aggregated here, please read on.

Credits

Planet OSGeo was implemented after the initial discussion was discussed on the mailing list. OSGeo thanks Christopher Schmidt and James Fee - pioneers of building geospatial planetariums. Planet OSGeo is based on Christopher's planet, James' is here:

  • Planet Geospatial maintained by James Fee aggregates wide variety of geospatial blogs

Contact

You can contact the planet admins by e-mail on planet (at) osgeo (dot) org and it is administered by:

Planet OSGeo Guidelines

Please, read the following sections where basic guidelines are explained.

Planet Citizens

  • Planet is for any active and involved participant in the OSGeo Community.
  • There are many ways of participating in the OSGeo, so all of types of involvement are considered for the purposes of inclusion in Planet OSGeo: our projects users and developers, speakers and advocates, translators, managers and presidents of OSGeo friendship companies and sponsors, etc.
  • In order to help building the OSGeo brand and credibility, it's recommended the Planet is not formed by anonymous individuals but its members use real names. Also, heads are highly recommended.
  • Some guidelines for acceptance or temporal/permanent ban are being discussed at Talk:PlanetOSGeo

Planet Content

  • Planet OSGeo aims to aggregate the blogs of people who are active on OSGeo and not only to aggregate the blog posts about OSGeo.
  • The Planet shall not do any content filter, however subscribed feeds ought to be at least occasionally relevant to OSGeo.
  • All opinions expressed in syndicated blogs are of the original authors and should not be considered as official opinion of the OSGeo Foundation body.
  • Planet users are free to submit "on-topic" posts by pointing specific categories/tags in their feeds. But other posts are also welcome.
  • It's a good idea to stay away from advertising content (or content that might be confused as such) and from excessively personal information
  • Please, don't annoy people

Feed Submission

  • Feeds should provide stable permanent URL
  • Broken feeds will be excluded from the Planet
  • IMPORTANT: Please, check your blog with http://validator.w3.org otherwise your feed may seriously break the Planet OSGeo look & feel.

How can I add my blog

If you want to add your blog to the OSGeo Planet, send your request on planet at osgeo dot org specifying:

  • your contact name
  • your contact email
  • blog URL
  • blog feed URL (with the items you want to be displayed on Planet OSGeo)
  • blog name
  • primary language of your blog content
  • (not mandatory but recommended) include your head picture of max size of 80x80 pixels

If you would like to syndicate only posts that belong to a particular category of your blog, you can do it by sending URL pointing to feed of that category, something that looks like:

http://blog.myside.org/category/osgeo/feed

Planet OSGeo Implementation

The Planet OSGeo - a website that aggregates blogs of active Friends of OSGeo and provide a window into the community itself.

Ticket #206 - Planet OSGeo RFC

Status: approved

Planet Configuration

Update Steps

  • Edit master configuration file from a SVN clean checkout
https://svn.osgeo.org/osgeo/planet/venus/planet_osgeo.config
  • Each entry should look like this:
# contact: contact@blogname.com
# added: 2011-07-14
[blog feed url]
name = blog name
link = blog url
face = head-blogname.png
facewidth = 80
faceheight = 80
  • Save head image to
themes/osgeo_v2/heads/
  • Commit, the planet will be updated over the next half an hour or so.

Troubleshooting

Stray Comments

The planet.py scripts are picky about formatting, a stray comment hash is enough to kill it. Confronted by this error: ...

 File "/usr/local/venus/planet/config.py", line 90, in <lambda>
   setattr(config, name, lambda section, default=default:
   ValueError: invalid literal for int(): 40 #25

Led me to check the /usr/local/etc/planet_osgeo.config file and change the "items_per_page = 40 #25" to "items_per_page = 40". I guess the config parser doesn't ignore comments after all :)

Test Scripts

There are two scripts that are run during planet updates, one spider.py and one splice.py. If wondering where the update process is breaking try running spider.py with the config file as a variable. Then followed by splice.py - it might help you understand where it's dying or at least if dying is related to grabbing the feed updates or not.

References

The Planet OSGeo proposal is based on definitions and rules described at following pages: