Difference between revisions of "PlanetOSGeo"

From OSGeo
Jump to navigation Jump to search
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
= Planet OSGeo =
 
= Planet OSGeo =
 +
 
[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.
 
[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.
  
Line 6: Line 7:
 
OSGeo thanks Christopher Schmidt and James Fee - pioneers of building geospatial planetariums. Planet OSGeo is based on Christopher's planet, James' is here:
 
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
 +
 +
== Contact ==
 +
 +
You can contact the planet admins by e-mail on <tt>planet (at) osgeo (dot) org</tt> and it is administered by:
 +
 +
* [[Jorge Sanz]]
  
 
== Planet OSGeo Guidelines ==
 
== Planet OSGeo Guidelines ==
Line 14: Line 21:
 
* 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.
 
* 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.
 
* 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 Content ===
 
=== Planet Content ===
Line 26: Line 34:
 
* Feeds should provide stable permanent URL
 
* Feeds should provide stable permanent URL
 
* Broken feeds will be excluded from the Planet
 
* 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 ==
 
== How can I add my blog ==
Line 31: Line 40:
 
specifying:
 
specifying:
  
−
* your blog URL
+
* your contact name
−
* your name
+
* your contact email
−
* declare what's primary language of your blog content
+
* blog URL
−
* URL of feed you want to syndicate
+
* 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'''
  
 
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:
 
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
 
  http://blog.myside.org/category/osgeo/feed
−
 
−
You are also encouraged to include your [http://planet.osgeo.org/heads/ head] picture of max size of '''80x80 pixels'''.
 
  
 
= Planet OSGeo Implementation =
 
= Planet OSGeo Implementation =
Line 50: Line 60:
  
 
== Planet Configuration ==
 
== Planet Configuration ==
−
* Maintainers: Mateusz Loskot
+
* Maintainers: [[Jorge Sanz]]
 
* Domain: http://planet.osgeo.org
 
* 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]
 
* 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
+
* Hardware:  
−
 
+
** <strike>osgeo2</strike> 
 +
** <strike>[[SAC_Service_Status#osgeo_7|osgeo7]]</strike>
 +
** [[SAC_Service_Status#geo-docs|osgeo3 (geo-docs container)]]
 
=== Update Steps  ===
 
=== Update Steps  ===
  
−
*Edit master configuration file
+
* Edit master configuration file from a SVN clean checkout
  
−
  /osgeo/venus/planet_osgeo.config
+
  https://svn.osgeo.org/osgeo/planet/venus/planet_osgeo.config
  
−
*each entry should look like this:
+
* Each entry should look like this:
  
 
  # contact: contact@blogname.com
 
  # contact: contact@blogname.com
Line 72: Line 84:
 
  faceheight = 80
 
  faceheight = 80
  
−
*Save head image to
+
* Save head image to
−
 
 
−
/osgeo/venus/themes/osgeo/heads
 
  
−
*Run update script as root user:
+
themes/osgeo_v2/heads/
  
−
[root@planet]# python /osgeo/venus/planet.py /osgeo/venus/planet_osgeo.config
+
* Commit, the planet will be updated over the next half an hour or so.
−
.......some errors/warnings will show here if feeds fail to download
 
−
[root@osgeo2]#
 
  
 
=== Troubleshooting ===
 
=== Troubleshooting ===
Line 105: Line 113:
  
 
[[Category: Infrastructure]]
 
[[Category: Infrastructure]]
 +
[[Category: Services]]
 
[[Category: Software Stack]]
 
[[Category: Software Stack]]
 
[[Category: WebCom]]
 
[[Category: WebCom]]

Latest revision as of 05: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:

Retrieved from "http://wiki.osgeo.org/w/index.php?title=PlanetOSGeo&oldid=129758"