summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/meta.mdwn
blob: 32997d8b529e2e4515b68182e698c898509a1c03 (plain)

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.

    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"]]