Cette directive permet l'insertion de métadonnées quelconques dans la source
d'une page. Voici comment procéder :
La première expression donne une valeur à un champ, tandis que la seconde
définit également des sous-paramètres.
La valeur d'un champ est traitée comme du texte codé en HTML. Vous pouvez
inclure un guillemet en écrivant "
par exemple.
-
title
La valeur de ce champ remplace le titre d'une page, qui est en général
le nom de la page.
Si le titre est remplacé, une variable « title_overridden » est définie avec une valeur true
dans le modèle de page. On peut se servir de cette variable pour formater le texte différemment.
An optional sortas
parameter will be used preferentially when
[[ikiwiki/pagespec/sorting]] by meta(title)
:
[[!meta title="The Beatles" sortas="Beatles, The"]]
[[!meta title="David Bowie" sortas="Bowie, David"]]
-
license
Indique la license de la page, par exemple « GPL ». Peut contenir des WikiLinks
et des balises quelconques.
-
copyright
Indique le copyright de la page, par exemple « Copyright 2007 by Joey Hess ».
Peut contenir des WikiLinks et des balises quelconques.
-
author
L'auteur de la page.
An optional sortas
parameter will be used preferentially when
[[ikiwiki/pagespec/sorting]] by meta(author)
:
[[!meta author="Joey Hess" sortas="Hess, Joey"]]
-
authorurl
Indique une URL pour l'auteur de la page.
-
description
Donne une courte description de la page qui sera placée dans l'en-tête html
et qui peut être affichée par la directive [[map]].
-
permalink
Indique un lien permanent vers la page, si différent de la page créée par ikiwiki.
-
date
Indique la date de création de la page. Tous les formats de date sont reconnus, puisque la valeur
de ce champ est analysée par [[!cpan TimeDate]].
-
stylesheet
Ajoute une feuille de style à la page. La feuille de style est traitée
comme un lien wiki vers un fichier .css
dans le wiki. On ne peut donc pas
ajouter de liens vers des feuilles de style externes. Par exemple :
[[!meta stylesheet=somestyle rel="alternate stylesheet"
title="somestyle"]]
-
openid
Ajoute des balises HTML <link> pour réaliser une délégation OpenID
à un serveur OpenID externe. Cela permet d'utiliser une page de wiki comme
votre identifiant OpenID.
Par défaut la délégation se fera pour openid
et openid2
. Pour n'en choisir qu'un,
ajoutez par exemple ce paramètre : delegate=openid
.
Un paramètre facultatif xrds-location
permet d'indiquer l'adresse de tout
eXtensible Resource DescriptorS.
Exemple :
[[!meta openid="http://joeyh.myopenid.com/"
server="http://www.myopenid.com/server"
xrds-location="http://www.myopenid.com/xrds?username=joeyh.myopenid.com""]]
-
link
Indique un lien vers une autre page. C'est une façon de lier deux pages
sans afficher un [[ikiwiki/WikiLink]] qui serait visible par l'utilisateur :
\[[!meta link=otherpage]]
On peut aussi s'en servir pour insérer une balise HTML <link>. Par exemple :
\[[!meta link="http://joeyh.myopenid.com/" rel="openid.delegate"]]
Cependant cette expression ne sera pas permise si le greffon
[[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé,
car il permet d'insérer des contenus non sécurisés.
-
redir
Rend possible la redirection d'une page vers une autre dans le wiki.
[[!meta redir=otherpage]]
Un délai (en seconde) peut être indiqué. Par défaut, il n'y a pas de délai.
Une redirection vers une URL externe est aussi possible. Par exemple :
[[!meta redir="http://example.com/"]]
Cependant cette expression ne sera pas permise si le greffon
[[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé,
car il permet d'insérer des contenus non sécurisés.
Dans les deux cas, on peut indiquer une ancre à l'intérieur de la page visée,
avec la syntaxe habituelle #ANCHOR
.
-
robots
Permet l'écriture de l'étiquette robots :
\[[!meta robots="index, nofollow"]]
L'attribut peut prendre les valeurs suivantes : "index", "noindex", "follow"
et "nofollow". On peut indiquer plusieurs valeurs, séparées par une virgule.
Seules quelques combinaisons cependant ont du sens. Si l'étiquette robots
n'existe pas, "index, follow" est utilisée par défaut.
La valeur est protégée mais son contenu n'est pas vérifié.
-
guid
Indique l'identificateur unique (GUID) d'une page. Cet identificateur
doit être un URI, en particulier, il peut être de la forme urn:uuid:
suivi
d'un UUID, comme indiqué dans le [[!rfc 4122]]). Il permet l'identification d'une
page pour un flux RSS ou Atom. S'il n'est pas donné, l'URL de la page
est utilisée comme GUID.
Sa principale utilisation est de garder inchangés les identificateurs des pages
qui ont été déplacées, évitant ainsi l'engorgement des agrégateurs.
Consultez [[!iki tips/howto_avoid_flooding_aggregators]]).
-
updated
Indique une date de modification fausse pour une page qui doit être affichée
dans les flux RSS ou Atom. Cela permet d'éviter l'engorgement des agrégateurs
qui classent les pages par date de modification, comme Planet par exemple.
Pour ajouter des étiquettes à un ancien message, vous pouvez mettre une valeur
supérieure d'une seconde à l'ancienne valeur. Tous les formats de date reconnus par
[[!cpan TimeDate]] sont acceptés, tout comme pour le paramètre date
.
Si le paramètre n'est pas l'un de ceux définis précédemment, les métadonnées
seront écrites sur la page HTML créée sous forme d'en-tête
<meta>. Cependant cette expression ne sera pas permise si le greffon
[[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé, car il permet
d'insérer des contenus non sécurisés.