1 files changed, 171 insertions, 0 deletions

diff --git a/ikiwiki/directive/meta.mdwn b/ikiwiki/directive/meta.mdwn
new file mode 100644
index 0000000..32997d8
--- /dev/null
+++ b/ikiwiki/directive/meta.mdwn
@@ -0,0 +1,171 @@
+La directive `meta` est fournie par le module d'extension [[!iki
+plugins/meta desc=meta]].
+
+Cette directive permet l'insertion de métadonnées quelconques dans la source
+d'une page. Voici comment procéder : 
+
+	\[[!meta field="valeur"]]
+	\[[!meta field="valeur" param="valeur" param="valeur"]]
+
+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. 
+
+Champs reconnus :
+
+* 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](http://www.windley.com/archives/2007/05/using_xrds.shtml).
+
+  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.
+
+[[!meta robots="noindex, follow"]]