X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/c522fffe09eea30a97213af1ecddfe6833d131e7..dd87d82fbe2bf09abe634caef044474d5b24502e:/doc/plugins/meta.mdwn?ds=sidebyside diff --git a/doc/plugins/meta.mdwn b/doc/plugins/meta.mdwn index fa37a8246..b1e0cb757 100644 --- a/doc/plugins/meta.mdwn +++ b/doc/plugins/meta.mdwn @@ -42,6 +42,11 @@ Supported fields: Specifies an url for the author of a page. +* description + + Specifies a "description" of the page. You could use this to provide + a summary, for example, to be picked up by the [[map]] plugin. + * permalink Specifies a permanent link to the page, if different than the page @@ -123,18 +128,17 @@ 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. +* guid - The uuid can either be a literal uuid (ie, - "ec248d04-f347-4eb8-92b6-671b15d36980"), or it can be an alternative URl - for the page. + 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. - This is mostly useful when a page's feed has moved, to keep the IDs 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