Planet Venus - Revision history

Mike Linksvayer at 23:08, 1 March 2008

2008-03-01T23:08:19Z

← Older revision		Revision as of 23:08, 1 March 2008
Line 5:		Line 5:
	The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].		The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].

	CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet]. We have also created a small input filter that will filter out blog posts based on category/tag.		CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will [[Syndication\|pull license information from the feeds]] and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet]. We have also created a small input filter that will filter out blog posts based on category/tag.

	== get_license_name.plugin ==		== get_license_name.plugin ==
Line 99:		Line 99:

	'''filter_categories''' is a comma separated list of categories that '''MUST''' exist in the feed entry in order for the entry to be included. It uses OR logic, so at least one of the categories must appear, though all or any will suffice.		'''filter_categories''' is a comma separated list of categories that '''MUST''' exist in the feed entry in order for the entry to be included. It uses OR logic, so at least one of the categories must appear, though all or any will suffice.

			[[Category:Syndication]]

Nkinkade at 00:42, 1 March 2008

2008-03-01T00:42:20Z

← Older revision		Revision as of 00:42, 1 March 2008
Line 14:		Line 14:
	</div>		</div>

	The plugin requires a couple of ~~semi-non-standard (though~~ very useful) Python modules: [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not very big or complicated.		The plugin requires a couple of very useful Python modules that do not come with the default Python distribution, so I mention them here: [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not very big or complicated.

	'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.		'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.

Nkinkade at 00:32, 1 March 2008

2008-03-01T00:32:57Z

← Older revision		Revision as of 00:32, 1 March 2008
Line 1:		Line 1:
	__TOC__		__TOC__

	Creative Commmons uses feed aggregation software to ~~collect~~ in one place CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.		Creative Commmons uses feed aggregation software to bring together in one place posts to CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.

	The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].		The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].

	CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet].		CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet]. We have also created a small input filter that will filter out blog posts based on category/tag.

	== get_license_name.plugin ==		== get_license_name.plugin ==
Line 14:		Line 14:
	</div>		</div>

	The ~~get_license_name.~~plugin requires a couple of semi-non-standard Python modules: [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not so big.		The plugin requires a couple of semi-non-standard (though very useful) Python modules: [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not very big or complicated.

	'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.		'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.
Line 71:		Line 71:
	</pre>		</pre>

	The patch also tries to make use of a custom configuration parameter called '''default_license'''. Since very few blogs will actually embed license data into a syndication feed in a machine readable way, it ~~was~~ necessary to provide a mechanism for this information to be supplied manually on a feed-by-feed basis. The plugin will first look for license information in the feed itself. If it doesn't find any then it looks to see if '''default_license''' is defined for the feed. If no license information is found either in the feed or in the config variable '''default_license''' then the plugin does nothing.		The patch also tries to make use of a custom configuration parameter called '''default_license'''. Since very few blogs will actually embed license data into a syndication feed in a machine readable way, it is necessary to provide a mechanism for this information to be supplied manually on a feed-by-feed basis. The plugin will first look for license information in the feed itself. If it doesn't find any then it looks to see if '''default_license''' is defined for the feed. If no license information is found either in the feed or in the config variable '''default_license''' then the plugin does nothing.

	Here is an example configuration:		Here is an example configuration:
Line 82:		Line 82:

	== filter_categories.py ==		== filter_categories.py ==
	This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on		This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.
	~~__TOC__~~
	Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.

	<div style="border: 1px dashed blue; padding: 1ex;">		<div style="border: 1px dashed blue; padding: 1ex;">

Nkinkade at 00:26, 1 March 2008

2008-03-01T00:26:05Z

← Older revision		Revision as of 00:26, 1 March 2008
Line 1:		Line 1:
			__TOC__

	Creative Commmons uses feed aggregation software to collect in one place CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.		Creative Commmons uses feed aggregation software to collect in one place CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.

Nkinkade at 00:25, 1 March 2008

2008-03-01T00:25:23Z

← Older revision		Revision as of 00:25, 1 March 2008
Line 80:		Line 80:

	== filter_categories.py ==		== filter_categories.py ==
	This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.		This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on
			__TOC__
			Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.

	<div style="border: 1px dashed blue; padding: 1ex;">		<div style="border: 1px dashed blue; padding: 1ex;">

Nkinkade at 00:13, 1 March 2008

2008-03-01T00:13:22Z

← Older revision		Revision as of 00:13, 1 March 2008
Line 81:		Line 81:
	== filter_categories.py ==		== filter_categories.py ==
	This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.		This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.

			<div style="border: 1px dashed blue; padding: 1ex;">
			'''NOTE''': unlike the xpath_sifter.py filter, this filter only implements an include-type policy. That is, you can't explicitly exclude anything, though you can implicitly exclude all you like. :) If you need to have implicit include and exclude filters then xpath_sifter.py may be better for you, as long as you don't need to include/exclude using different lists on a blog-by-blog basis.
			</div>

	The filter makes use of a new blog-level configuration parameter named '''filter_categories'''. Here is an example configuration:		The filter makes use of a new blog-level configuration parameter named '''filter_categories'''. Here is an example configuration:

Nkinkade: /* filter_categories.py */

2008-02-29T23:56:21Z

filter_categories.py

← Older revision		Revision as of 23:56, 29 February 2008
Line 80:		Line 80:

	== filter_categories.py ==		== filter_categories.py ==
	This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that ~~allow~~ you to filter blog entries based on ~~<entry>~~ categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this functionality, but with category specifications at the blog level.		This Panet Venus input filter can can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/filter_categories.py?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net. It is a very small Python script that allows you to filter blog entries based on categories. This is not totally dissimilar to one of the filters that comes with Planet Venus called [http://intertwingly.net/code/venus/filters/xpath_sifter.py xpath_sifter.py]. However, as best I could tell, the xpath_sifter.py filter allows you to filter (or not) feed entries based on Planet-wide include/exclude lists. We needed this basic functionality, but with category specifications at the blog level.

	The filter makes use of a new blog-level configuration parameter named '''filter_categories'''. Here is an example configuration:		The filter makes use of a new blog-level configuration parameter named '''filter_categories'''. Here is an example configuration:
Line 92:		Line 92:
	</pre>		</pre>

	'''filter_categories''' is a comma separated list of categories that '''MUST''' exist in the feed entry in order to be included. It uses OR logic, at least one of ~~them~~ must appear, though all or any will suffice.		'''filter_categories''' is a comma separated list of categories that '''MUST''' exist in the feed entry in order for the entry to be included. It uses OR logic, so at least one of the categories must appear, though all or any will suffice.

Nkinkade at 23:52, 29 February 2008

2008-02-29T23:52:24Z

@@ Line 3: / Line 3: @@
 The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby].  For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].
-CC has slightly extended Planet Venus via a few plugins.  First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates.  For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet].  The plugin is a python script named get_license_name.plugin and can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/get_license_name.plugin?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net.
+CC has slightly extended Planet Venus via a few plugins.  First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates.  For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet].
 <div style="border: 1px dashed blue; padding: 1ex;">
@@ Line 75: / Line 78: @@
 default_license = http://creativecommons.org/licenses/by/3.0
 </pre>

Mike Linksvayer at 23:02, 29 February 2008

2008-02-29T23:02:51Z

← Older revision		Revision as of 23:02, 29 February 2008
Line 9:		Line 9:
	</div>		</div>

	The get_license_name.plugin requires a couple of semi-non-standard Python modules: [ http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not so big.		The get_license_name.plugin requires a couple of semi-non-standard Python modules: [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] and [http://wiki.creativecommons.org/RdfaDict rdfadict]. The plugin self documents to some extent via comments and in any case is not so big.

	'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.		'''In order for the plugin to work''', a small patch much also be applied to the Planet Venus code iteslf -- to a single file: planet/shell/tmpl.py. Most of the patch below is context and comments.

Mike Linksvayer at 23:02, 29 February 2008

2008-02-29T23:02:10Z

← Older revision		Revision as of 23:02, 29 February 2008
Line 1:		Line 1:
	Creative Commmons uses feed aggregation software to collect in one place CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.		Creative Commmons uses feed aggregation software to collect in one place CC blogs, jurisdictions blogs, and also blogs of people and organizations that are closely associated with or actively involved in the CC community.

	The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby ~~San~~ Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].		The software we are using to do this is called [http://www.intertwingly.net/blog/2006/08/16/Venus-Rising Planet Venus], which is a major rewrite of [http://www.planetplanet.org Planet] done by [http://en.wikipedia.org/wiki/Sam_Ruby Sam Ruby]. For more information and documentation on Planet Venus, please see the [http://intertwingly.net/code/venus/ project's page].

	CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet]. The plugin is a ~~pythong~~ script named get_license_name.plugin and can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/get_license_name.plugin?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net.		CC has slightly extended Planet Venus via a few plugins. First of all, as licensing information is eminently important to CC, we have created a plugin that will pull license information from the feeds and make it available to the HTML templates. For an example of the output, take a look at the [http://planet.creativecommons.org CC Planet]. The plugin is a python script named get_license_name.plugin and can be [http://cctools.svn.sourceforge.net/viewvc/cctools/planet/branches/production/software/filters/get_license_name.plugin?revision=9156&view=markup viewed/downloaded] at the [http://cctools.svn.sourceforge.net/viewvc/cctools/ cctools] subversion repository at sourceforge.net.

	<div style="border: 1px dashed blue; padding: 1ex;">		<div style="border: 1px dashed blue; padding: 1ex;">