ikiwiki/ plugins/ aggregate

Plugin: aggregate
Author: Joey
Included in ikiwiki: yes
Enabled by default: no
Included in goodstuff: no
Currently enabled: no

This plugin allows content from other feeds to be aggregated into the wiki. Aggregate a feed as follows

[[aggregate name="example blog"
feedurl="http://example.com/index.rss"
url="http://example.com/" updateinterval="15"]]

That example aggregates posts from the specified RSS feed, updating no more frequently than once every 15 minutes, and puts a page per post under the example/ directory in the wiki.

You can then use ikiwiki's blog support to create a blog of one or more aggregated feeds.

setup

Make sure that you have the html plugin enabled, as the created pages are in html format. The meta and tag plugins are also recommended. The htmltidy plugin is suggested, since feeds can easily contain html problems, some of which tidy can fix.

You will need to run ikiwiki periodically from a cron job, passing it the --aggregate parameter, to make it check for new posts. Here's an example crontab entry:

*/15 * * * * ikiwiki --setup my.wiki --aggregate --refresh

usage

Here are descriptions of all the supported parameters to the aggregate directive:

Note that even if you are using subversion or another revision control system, pages created by aggregation will not be checked into revision control.