document uuid

diff --git a/debian/changelog b/debian/changelog
index 8c28e723813ad9f1162f8fe1f380048a2f59a084..f2ead8bad3cc97e3680a40122968f6642ae3b06f 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -15,6 +15,8 @@ ikiwiki (2.54) UNRELEASED; urgency=low
   * Change deb dependencies to list Text::Markdown before markdown, since
     the former, while slower, has a much better html parser that avoids
     numerous bugs.
+  * meta: Support a uuid option, to allow forcing a particular uuid
+    in feeds.
 
  -- Josh Triplett <josh@freedesktop.org>  Wed, 09 Jul 2008 21:30:33 -0700
 

diff --git a/doc/plugins/meta.mdwn b/doc/plugins/meta.mdwn
index c3f971d06bd6a24144e16a27cfe1768d87b354a4..fa37a82464e64dbc9a8dbbe25b859aae2da7dd05 100644 (file)
--- a/doc/plugins/meta.mdwn
+++ b/doc/plugins/meta.mdwn
@@ -123,6 +123,19 @@ Supported fields:
   contents. In particular, it does not check the values against the set of
   valid values but serves whatever you pass it.
 
+* uuid
+
+  Specifies a globally unique ID for a page. This ID will be used,
+  rather than the page url, in RSS and Atom feeds.
+
+  The uuid can either be a literal uuid (ie,
+  "ec248d04-f347-4eb8-92b6-671b15d36980"), or it can be an alternative URl
+  for the page.
+
+  This is mostly useful when a page's feed has moved, to keep the IDs for
+  pages unchanged and
+  [[avoid_flooding_aggregators|howto_avoid_flooding_aggregators]].
+
 If the field is not one of the above predefined fields, the metadata will be
 written to the generated html page as a <meta> header. However, this
 won't be allowed if the [[htmlscrubber]] is enabled, since it can be used to

diff --git a/doc/tips/howto_avoid_flooding_aggregators.mdwn b/doc/tips/howto_avoid_flooding_aggregators.mdwn
index 570baa5cc8118d6b68940ab32a1cc8379c1deeb0..0f7906b1ee115e6bd12950b5b6a36cd0828e4830 100644 (file)
--- a/doc/tips/howto_avoid_flooding_aggregators.mdwn
+++ b/doc/tips/howto_avoid_flooding_aggregators.mdwn
@@ -23,3 +23,6 @@ parameter to the `inline` directive for your blog, with a condition such as:
 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]] uuid directives to pages,
+to force the old url to be used.

diff --git a/doc/todo/ability_to_force_particular_UUIDs_on_blog_posts.mdwn b/doc/todo/ability_to_force_particular_UUIDs_on_blog_posts.mdwn
index 0f8f9bb73894fd0bc0b271867bbaea94d6f539e0..d8f7c99abe40a9b777ae74915b8a39e2072abfff 100644 (file)
--- a/doc/todo/ability_to_force_particular_UUIDs_on_blog_posts.mdwn
+++ b/doc/todo/ability_to_force_particular_UUIDs_on_blog_posts.mdwn
@@ -13,3 +13,8 @@ Perhaps ikiwiki's blogging functionality could be hooked up to the [meta plugin]
 > While I was there, I noticed that the quality of the generated Atom/RSS feeds could be improved by making more use of the meta plugin if it's also enabled - would anyone object to me hacking on this some more?
 >
 > -[smcv](http://smcv.pseudorandom.co.uk/)
+
+> [[merged|done]], thank you!
+> 
+> Of course I'm happy if you can improve the feeds. They do already
+> use some meta information (author, copyright). --[[Joey]]