ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / tips / howto_avoid_flooding_aggregators.mdwn
1 If you have a [[blog]] that is aggregated, either on a site like Planet
2 Debian, or just through user subscriptions, one common problem is that
3 changes to the guids of items in the blog can “flood” the aggregator,
4 causing all recent blog entries to be posted to the top of it. 
5
6 This can happen in a lot of situations:
7
8 * Perhaps you’ve just switched to ikiwiki from some other blog engine and
9   imported your data.
10 * Perhaps you’ve turned on the `usedirs` setting, which changes all the
11   urls in your wiki. Even if you set up
12   [[redirections|redirections_for_usedirs]] for the old urls, you still face
13   the issue of flooding aggregators.
14 * Perhaps you’ve just moved stuff around in your wiki.
15
16 To avoid annoying readers in these situations, it’s a good idea to remove
17 any existing items from your blog’s news feed. That way only new items will
18 show up in the aggregator. The best way to do this is to add a `feedpages`
19 parameter to the `inline` directive for your blog, with a condition such as:
20
21         feedpages=created_after(blog/posts/old_post)
22
23 Where “old_post” is the name of the last post you made to the blog before
24 making the change. This will limit the feed to only newer posts, while still
25 displaying the old posts in the blog page.
26
27 Alternatively, you can add the [[plugins/meta]] guid directives to pages,
28 to force the old url to be used.