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 and 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 currently to modify
  19 the [[PageSpec]] for your [[blog]] and add a condition such as:
  20
  21         and 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 (the older
  25 posts will still be available in the archives).