X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/ca30d95a78ca974c040c152b8c31bdd63f219e6b..8d9ec24232ede981face0c3eafbce71b74c4725a:/doc/plugins/meta.mdwn diff --git a/doc/plugins/meta.mdwn b/doc/plugins/meta.mdwn index 12240422d..506ac84a8 100644 --- a/doc/plugins/meta.mdwn +++ b/doc/plugins/meta.mdwn @@ -125,16 +125,15 @@ 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]]. + [[avoid_flooding_aggregators|tips/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