From 778d9e50d41d7ed2c1b2a2bf5cad52f089c94122 Mon Sep 17 00:00:00 2001 From: smcv Date: Fri, 19 May 2017 09:50:52 -0400 Subject: [PATCH] Document the special case for [[!meta name=foo content=bar]] --- doc/ikiwiki/directive/meta.mdwn | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/doc/ikiwiki/directive/meta.mdwn b/doc/ikiwiki/directive/meta.mdwn index 955648cac..0d4d9d6cc 100644 --- a/doc/ikiwiki/directive/meta.mdwn +++ b/doc/ikiwiki/directive/meta.mdwn @@ -13,7 +13,7 @@ per `meta` directive, use more directives if you want to specify more fields. The field values are treated as HTML entity-escaped text, so you can include a quote in the text by writing `"` and so on. -Supported fields: +## Supported fields * title @@ -204,9 +204,20 @@ Supported fields: \[[!meta foaf=foaf.rdf]] +* name + + Adds a HTML `` header with this `name` attribute. Its other attributes are + taken from the other parameters, so for example + `\[[!meta name="foo" content="bar" x-non-standard-attribute="baz"]]` + becomes ``. This + won't be allowed if the [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled, + since it can be used to insert unsafe content. + +## Other fields + 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 [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled, -since it can be used to insert unsafe content. +written to the generated html page as a <meta> header. For example, +`\[[!meta foo="bar"]]` becomes ``. As with `name`, this +won't be allowed if the [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled. [[!meta robots="noindex, follow"]] -- 2.39.2