From def01959f8b76178d393a39ecd2c5af9be20b31f Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:35 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive/meta.mdwn | 171 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 171 insertions(+) create mode 100644 ikiwiki/directive/meta.mdwn (limited to 'ikiwiki/directive/meta.mdwn') 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"]] -- cgit v1.2.3