X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/1d650e78108e16052c5e1737421bbe4b13c78b0e..ac5fe2c33bd24af866661062e77e404e4fdfb01f:/doc/ikiwiki/directive/aggregate.mdwn diff --git a/doc/ikiwiki/directive/aggregate.mdwn b/doc/ikiwiki/directive/aggregate.mdwn index 58c580b8f..ddfcd40b7 100644 --- a/doc/ikiwiki/directive/aggregate.mdwn +++ b/doc/ikiwiki/directive/aggregate.mdwn @@ -1,4 +1,4 @@ -The `aggregate` directive is supplied by the [[!iki plugins/aggregate]] plugin. +The `aggregate` directive is supplied by the [[!iki plugins/aggregate desc=aggregate]] plugin. This plugin requires extra setup, specifically, a cron job. See the plugin's documentation for details. @@ -14,11 +14,16 @@ 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 [[ikiwiki/blog]] support to create a blog of one or +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 [[ikiwiki/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. + ## usage Here are descriptions of all the supported parameters to the `aggregate`