Die `meta`-Anweisung wird durch die [[!iki plugins/meta
desc=meta]]-Erweiterung bereitgestellt.

Diese Anweisung erlaubt es, beliebige Metadaten in den Quelltext einer Seite
einzufügen. Dies geschieht wie folgt:

	\[[!meta field="value"]]
	\[[!meta field="value" param="value" param="value"]]

The first form sets a given field to a given value, while the second form
also specifies some additional sub-parameters. You can have only one field
per `meta` directive, use more directives if you want to specify more
fields.

Die Feldwerte können HTML-Entities enthalten, zum Beispiel kann durch
`&quot;` ein Anführungszeichen eingefügt werden.

## Supported fields

* `title` 

  Überschreibt den Titel der Seite, der normalerweise dem Namen
  der Seite entspricht.

  Wenn der Titel so überschrieben wird, wird die Template-Variable
  `title_overridden` auf wahr gesetzt. Eine Vorlage kann in diesem
  Fall eine andere Darstellung wählen.

  Mit dem optionalen Parameter `sortas` kann die Sortierreihenfolge verändert
  werden, wenn nach `meta(title)` [[sortiert|ikiwiki/pagespec/sorting]] wird:

	\[[!meta title="The Beatles" sortas="Beatles, The"]]

	\[[!meta title="David Bowie" sortas="Bowie, David"]]

* `license`

  Gibt eine Lizenz für die Seite an, etwa `GPL`. Kann WikiLinks und
  beliebige Formatierungsanweisungen enhalten.

* `copyright`

  Gibt die Urheberrechte der Seite an, zum Beispiel `Copyright 2007
  by Joey Hess`. Kann WikiLinks und beliebige
  Formatierungsanweisungen enhalten.

* `author`

  Gibt den Autor der Seite an.

  Mit dem optionalen Parameter `sortas` kann die Sortierreihenfolge verändert
  werden, wenn nach `meta(author)` [[sortiert|ikiwiki/pagespec/sorting]] wird:

	\[[!meta author="Joey Hess" sortas="Hess, Joey"]]

* `authorurl`

  Gibt eine URL für den Autor der Seite an.

* `description`

  Gibt eine kurze Beschreibung der Seite an. Diese wird im
  HTML-Header angegeben und kann zum Beispiel auch durch die
  [[map]]-Anweisung ausgegeben werden.

* keywords

  Specifies keywords summarizing the contents of the page. This
  information will be put in the html header.  Only letters,
  numbers, spaces and commas are allowed in this string; other
  characters are stripped.  Note that the majority of search
  engines, including Google, do not use information from the
  keywords header.

* `permalink`

  Gibt einen dauerhaften Link zu der Seite an, wenn dieser anders ist
  als die von ikiwiki generierte Seite.

* `date`

  Specifies the creation date of the page. This creates a 
  `<meta name="date" content="...">` header in the HTML output, but also
  modifies the internal `ctime` in the
  [[!iki tips/inside_dot_ikiwiki desc="internal index"]].
  The date can be entered in nearly any format, since it's parsed by
  [[!cpan TimeDate]] but invalid dates yield an error in 3.20180321
  or later.

* `stylesheet`

  Fügt ein Stylesheet zu der Seite hinzu. Der angegebene Name wird als
  WikiLink zu einer `.css`-Datei im Wiki behandelt, es können also keine
  externen Stylesheets eingebunden werden. Beispiel:

	\[[!meta stylesheet=somestyle rel="alternate stylesheet"
	title="somestyle"]]
  
  However, this will be scrubbed away if the 
  [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled,
  since it can be used to insert unsafe content.

* script

  Adds a script to a page. The script is treated as a wiki link to
  a `.js` file in the wiki, so it cannot be used to add links to external
  scripts. The optional `defer` and `async` keywords can be used to set
  the corresponding HTML4 and HTML5 script options. Example:

	\[[!meta script=somescript defer async]]

  The tag is subject to scrubbing as with the stylesheet and link fields.

* `openid`

  Fügt die nötigen &lt;link&gt;-Tags für die Weiterleitung an einen externen
  OpenID-Server ein. Dadurch kann eine ikiwiki-Seite als OpenID
  verwendet werden.

  Standardmäßig werden sowohl `openid` als auch `openid2`
  weitergeleitet. Um nur eines davon weiterzuleiten, kann ein
  Parameter wie `delegate=openid` verwendet werden.

  Der optionale Parameter `xrds-location` erlaubt es, den Ort eines
  [eXtensible Resource
  DescriptorS](http://www.windley.com/archives/2007/05/using_xrds.shtml)
  anzugeben.

  Beispiel:

	\[[!meta openid="http://joeyh.myopenid.com/"
	server="http://www.myopenid.com/server"
	xrds-location="http://www.myopenid.com/xrds?username=joeyh.myopenid.com"]]

* `link`

  Gibt einen Link zu einer anderen Seite an. Auf diese Weise kann das Wiki
  dazu gebracht werden, eine Seite so zu behandeln, als ob sie einen Link
  auf eine andere enthält, ohne dass die Benutzer einen [[ikiwiki/WikiLink]]
  zu Gesicht bekommen:

       \[[!meta link=andereseite]]

  Es kann auch ein HTML &lt;link&gt;-Tag eingefügt werden, zum
  Beispiel:

       \[[!meta link="http://joeyh.myopenid.com/" rel="openid.delegate"]]

  Allerdings ist diese zweite Syntax nicht erlaubt, wenn die
  [[!iki plugins/htmlscrubber desc=htmlscrubber]]-Erweiterung aktiviert ist,
  weil auf diese Weise unsichere Inhalte eingefügt werden können.

* enclosure

  Specifies a link to a file to be rendered as an "enclosure" in
  RSS/Atom feeds (and a plain old link in HTML). Useful for
  [[!iki podcast desc=podcasting]].

* `redir`

  Lässt die Seite auf eine andere Seite im Wiki weiterleiten.

  	\[[!meta redir=andereseite]]

  The default is to redirect without delay.
  Optionally, a delay (in seconds) can be specified: "delay=10"

  Es kann auch auf eine externe URL weitergeleitet werden. Zum
  Beispiel:

  	\[[!meta redir="http://beispiel.de/"]]

  Allerdings ist diese zweite Syntax nicht erlaubt, wenn die
  [[!iki plugins/htmlscrubber desc=htmlscrubber]]-Erweiterung aktiviert ist,
  weil auf diese Weise unsichere Inhalte eingefügt werden können.

  In beiden Fällen kann ein anzuspringender Anker auf der Zielseite
  angegeben werden, indem die übliche `#ANKER`-Syntax verwendet wird.

* `robots`

  Schreibt den robots-Meta-Tag:

        \[[!meta robots="index, nofollow"]]

  Zulässige Werte sind `index`, `noindex`, `follow` und `nofollow`. Es
  können mehrere Werte durch Kommas getrennt angegeben werden, aber
  offensichtlich ergeben nur einige Kombinationen Sinn. Wenn der
  robots-Meta-Tag nicht explizit angegeben wird, wird als Voreinstellung
  "index,follow" angenommen.

  Der Wert wird nicht auf Zulässigkeit geprüft.

* `guid`

  Specifies a globally unique ID for a page. This guid should be a URI,
  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 has moved, to keep the guids for
  pages unchanged and avoid flooding aggregators
  (see [[!iki tips/howto_avoid_flooding_aggregators]]).

* `updated`

  Specifies a fake modification time for a page, to be output into RSS and
  Atom feeds. This is useful to avoid flooding aggregators that sort by
  modification time, like Planet: for instance, when editing an old blog post
  to add tags, you could set `updated` to be one second later than the original
  value. The date/time can be given in any format that
  [[!cpan TimeDate]] can understand, just like the `date` field and maps to the
  `<meta name="updated" content="...">` HTML header and internal `mtime` field.

* foaf

  Adds a Friend of a Friend ([FOAF](http://wiki.foaf-project.org/w/Autodiscovery))
  reference to a page.

  Beispiel:

  	\[[!meta foaf=foaf.rdf]]

* name

  Adds a HTML `<meta>` 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 `<meta name="foo" content="bar" x-non-standard-attribute="baz">`. 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 &lt;meta&gt; header. For example,
`\[[!meta foo="bar"]]` becomes `<meta name="foo" content="bar">`. As
with `name`, this won't be allowed if the [[!iki plugins/htmlscrubber
desc=htmlscrubber]] plugin is enabled.

This syntax cannot be used for meta headers with unusual names, in
particular names containing `:` such as `flattr:id` and `twitter:card`.
Please use `\[[!meta name="..." content="..."]]` for those headers.

[[!meta robots="noindex, follow"]]
