The tiddlywebplugins.atom package provides serialization modules to do a very simple Atom format syndication of collections of tiddlers (including one tiddler, and filtered tiddlers) hosted by TiddlyWeb.

One serialization provides support for the Atom format, the other extends the existing HTML serialization to provide <link> elements referring to the Atom feeds.

Atom formatted output can be had by requesting the application/atom+xml format, or by appending a .atom to the end of a URL (before the query portion) that returns one or more tiddlers.

To use this code install the package and then add tiddlywebplugins.atom to [system_plugins](http://tiddlyweb.tiddyspace.com/system_plugins] in the [tiddlywebconfig.py](http://tiddlyweb.tiddlyspace.com/tiddlywebconfig.py] of your instance:

config = {
    'system_plugins': ['tiddlywebplugins.atom'],
}

If tiddlywebplugins.differ is on sys.path and a depth=<some number> argument is supplied to the feed URL, then the resulting feed will be the tiddlers requested presented as diffs between tiddler revisions. The number of revisions shown is controlled by <some number>.

By default the feed given is all the tiddlers in the collection represented by the given URI, in no particular order. This is not always the best default. If you want a different default you can set atom.default_filter in tiddlywebconfig.py to a string that represents a TiddlyWeb filter. For example:

'atom.default_filter': 'select=tag:!excludeLists;sort=-modified;limit=20',

would give the 20 most recently modified tiddlers which are not tagged excludeLists.

The Atom code was original adapted from Django's django/utils/feedgenerator.py which itself was then extracted to its own package.

License

tiddlywebplugins.atom is released under the BSD License and is copyright 2009-2013 UnaMesa Association.