From: Simon McVittie Date: Sat, 12 Jul 2008 16:33:40 +0000 (+0100) Subject: Re-work [[meta guid=""]] documentation, and stop claiming that urn:uuid: is automatic... X-Git-Tag: 2.54~106 X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=b269835a7fa07c2bf5d469399324b7d2a8a8fbb1;p=ikiwiki.git Re-work [[meta guid=""]] documentation, and stop claiming that urn:uuid: is automatically prepended --- diff --git a/doc/plugins/meta.mdwn b/doc/plugins/meta.mdwn index 12240422d..032802d7a 100644 --- a/doc/plugins/meta.mdwn +++ b/doc/plugins/meta.mdwn @@ -125,14 +125,13 @@ Supported fields: * guid - Specifies a globally unique ID for a page. This guid will be used, - rather than the page url, to identify the page in RSS and Atom feeds. + Specifies a globally unique ID for a page. This guid should be a URI + (in particular, it can be `urn:uuid:` followed by a UUID, as per + [[!rfc 4122]]), and it will be used to identify the page's entry in RSS + and Atom feeds. If not given, the default is to use the page's URL as its + guid. - The guid can either be a 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 guids for + This is mostly useful when a page has moved, to keep the guids for pages unchanged and [[avoid_flooding_aggregators|howto_avoid_flooding_aggregators]].