skip to navigation
skip to content

Not Logged In

tiddlywebplugins.atom 1.4.4

A TiddlyWeb plugin that provides an Atom feed of tiddler collections.

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]http:/tiddlyweb.com).

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]http://pypi.python.org/pypi/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.  
File Type Py Version Uploaded on Size
tiddlywebplugins.atom-1.4.4.tar.gz (md5) Source 2015-01-06 10KB
  • Downloads (All Versions):
  • 39 downloads in the last day
  • 608 downloads in the last week
  • 2270 downloads in the last month