Skip to main content

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

Project description

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).

One serialization provides support for the Atom format, another
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 in the 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>.

You can get tiddlywebplugins.differ from PyPI:
http://pypi.python.org/pypi/tiddlywebplugins.differ

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 is borrowed from Django's django/utils/feedgenerator.py

* http://www.djangoproject.com/documentation/syndication_feeds/
* http://code.djangoproject.com/browser/django/trunk/django/utils/feedgenerator.py

Copyright 2011, Chris Dent <cdent@peermore.com>.

BSD Licensed as TiddlyWeb itself.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tiddlywebplugins.atom-1.3.3.tar.gz (5.3 kB view details)

Uploaded Source

File details

Details for the file tiddlywebplugins.atom-1.3.3.tar.gz.

File metadata

File hashes

Hashes for tiddlywebplugins.atom-1.3.3.tar.gz
Algorithm Hash digest
SHA256 f373ea8088af5d448208d4ce23479775687be8a8aa20539014d6caae66d8b6c6
MD5 e49b0e825ed4427c5389c504b0e20491
BLAKE2b-256 220ea66a8b78c230f67d47c46881a5913dadfb04c13ae3ebe0720b7afb6fb480

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page