DragonFly BSD


The aggregate directive is supplied by the aggregate plugin. This plugin requires extra setup, specifically, a cron job. See the plugin's documentation for details.

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

[[!aggregate  name="example blog" dir="example"
url="http://example.com/" updateinterval="15"]]

That example aggregates posts from the specified RSS feed, updating no more frequently than once every 15 minutes (though possibly less frequently, if the cron job runs less frequently than that), and puts a page per post under the example/ directory in the wiki.

You can then use ikiwiki's inline directive to create a blog of one or more aggregated feeds. For example:

[[!inline  pages="internal(example/*)"]]

Note the use of internal() in the PageSpec to match aggregated pages. By default, aggregated pages are internal pages, which prevents them from showing up directly in the wiki, and so this special PageSpec is needed to match them.


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.