Réviser cette page - la page anglaise à été complétée

Un des éléments clés d'un Wiki est la facilité à créer des liens vers d'autres endroits d'un document. PmWiki fournit de multiples mécanismes pour créer de tels liens.

Liens vers les autres pages

D'abord, pour créer un lien vers une autre page, insérez le nom de la page entre double crochets, comme dans [[bac a sable]] ou [[installation]]. Ceci crée des liens vers les pages bac a sable et installation.

Entre double crochets, PmWiki mettra en majuscule la première lettre de tout mot qui suit un espace ou tout autre type de ponctuation, donc [[Bac a sable]], [[bac à sable]], et [[BacASable]] s'affichent différemment mais créent un lien vers la même page.

Un suffixe peut aussi être ajouté à la fin d'un lien, qui sera affiché dans le texte mais pas dans le lien cible. Donc [[bac à sable]]use est toujours un lien vers BacASable mais s'affiche comme bac a sableuse. et vous pouvez mettre des parenthèses autour de tout texte que vous ne souhaitez pas afficher, aussi [[(bac a) sable]] est toujours un lien vers BacASable mais s'affiche sable.

Enfin, vous pouvez spécifier un texte à l'aide d'une barre verticale, donc [[Bac a sable | une aire de jeu]], qui établit un lien vers BacASable mais s'affiche comme une aire de jeu. En variante, vous pouvez utiliser une flèche (->) pour inverser le texte et le lien, comme dans [[une aire de jeu -> BacASable]] (une aire de jeu).

Quelques sites reconnaissent aussi les liens de type MotWiki, dans lesquels un MotWiki aparaissant dans le texte est automatiquement traité comme un lien vers la page du même nom.

Liens vers les sites externes (URLs)

Les liens vers les sites externes sont préfixés par 'http:', 'ftp:', etc. Donc http://www.google.com/ et [[http://www.google.com/]] créent un lien vers Google. Comme ci-dessus, un auteur peut spécifier le texte du lien en utilisant une barre verticale ou une flèche, comme dans [[http://www.google.com/ | Google]] et [[Google -> http://www.google.com]].

Les liens InterMap sont aussi possibles (voir Liens InterMap).

Liens vers des positions spécifiques d'une page

Pour définir une position dans une page à laquelle vous pourrez aller directement, utilisez la balise [[#nom]]. Ceci créera une "ancre" qui définira de manière unique la position dans la page. Ensuite pour avoir un lien vers cette ancre, on peut utiliser l'une des solutions

  • [[#nom|texte du lien]] dans la même page, ou
  • NomPage#nom ou [[NomPage#nom|texte du lien]] pour une position dans une autre page

Vous pouvez trouver la forme [[NomPage(#nom)]] plus pratique que [[NomPage#nom]] parce la première syntaxe cache le texte de l'ancre alors que la deuxième l'affiche.

Liens qui ouvrent une nouvelle fenêtre dans le navigateur

Ceci est particulièrement utile pour les liens vers des sites externes quand vous voulez laisser la fenêtre de votre wiki ouverte, permettant aux utilisateurs de revenir aisément sur votre site.

Vous pouvez aussi préciser que les liens doivent s'ouvrir dans une nouvelle fenêtre avec l'attribut target: 

    %target=_blank% Tout lien de cette ligne similaire
    à http://www.pmichaud.com
    va s'ouvrir dans une nouvelle fenêtre.

ce qui donne

Tout lien de cette ligne similaire à http://www.pmichaud.com va s'ouvrir dans une nouvelle fenêtre.

(Cette méthode est décrites dans les StylesWiki).

<< MotsWiki | Index documentation | Syntaxe des liens >>

Traduction de PmWiki:Links - page originale sur PmWiki:PmWikiFr.Liens