aboutsummaryrefslogtreecommitdiff
path: root/doc/tips/howto_avoid_flooding_aggregators.mdwn
blob: 98cef92496845c76595a6662e99614be7f1013e7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
If you have a [[blog]] that is aggregated, either on a site like Planet
Debian, or just through user subscriptions, one common problem is that
changes to the guids of items in the blog can "flood" the aggregator,
causing all recent blog entries to be posted to the top of it. 

This can happen in a lot of situations:

* Perhaps you've just switched to ikiwiki from some other blog engine and
  imported your data.
* Perhaps you've turned on the `usedirs` setting, which changes all the
  urls in your wiki. Even if you set up
  [[redirections|redirections_for_usedirs]] for the old urls, you still face
  the issue of flooding aggregators.
* Perhaps you've just moved stuff around in your wiki.

To avoid annoying readers in these situations, it's a good idea to remove
any existing items from your blog's news feed. That way only new items will
show up in the aggregator. The best way to do this is to add a `feedpages`
parameter to the `inline` directive for your blog, with a condition such as:

	feedpages=created_after(blog/posts/old_post)

Where "old_post" is the name of the last post you made to the blog before
making the change. This will limit the feed to only newer posts, while stil
displaying the old posts in the blog page.

Alternatively, you can add the [[plugins/meta]] guid directives to pages,
to force the old url to be used.