GitHub - Cloudxtreme/tiddlywebplugins.imrss: Import rss feeds to tiddlyweb

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commits
test		test
tiddlywebplugins		tiddlywebplugins
MANIFEST.in		MANIFEST.in
Makefile		Makefile
README		README
mangler.py		mangler.py
setup.py		setup.py

Repository files navigation

A TiddlyWeb plugin that allows you to import rss feeds to bags through a twanager command
To use just add "tiddlywebplugins.imrss" to your twanager_plugins

Each item in an rss feed is mapped to a tiddler by the following rules

title: 
  guid / id attribute (preferred)
  OR url with ":","/" and "." replaced with "_" character
text:
  The text by default is saved as a link <html><p><b><a href='{{rss link}}'>{{rss title}}</a><br>{{rss description}} </p></html>
geo.long and geo.lat:
  if geo data is present, the longitude and latitude will be matched to these feeds (works with <georss:point> and <georss:where>)
modifier:
  the author of the rss item
modified:
  the date field is used if present if not then the current date on time of command is taken

You can also create customisations by providing a handler. For example:

1) add to tiddlywebconfig
"imrss":{"module": "my_module"}
2) create a module my_module.py, inside which paste
def generic_handler(url,tiddler,feed_entry,feed=False,host=""):
  tiddler.text = "foo"
  return tiddler
3) run twanager imrss http://rssurl foo

The result will be tiddlers in foo from the rss feed, all with "foo" as the text. Obviously this example is rubbish but hopefully it gives you a starting point to explore further customisations.

This package is licensed under the same terms as TiddlyWeb itself.