PmWiki en français

Autheurs (basique) Un des éléments clés d'un Wiki est la facilité à créer des liens dans le texte de la page. 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 à sable]] ou [[installation]]. Ceci crée des liens respectivement vers les pages BacÀSable? et Installation.

PmWiki ignore les espaces entre les mots lors de la création d'un lien à partir du texte entre double crochets, et il mettra automatiquement une majuscule à la première lettre de tout mot qui suit un espace ou tout autre type de ponctuation (comme ~). Ainsi, [[Bac à sable]], [[bac à sable]] et [[BacÀSable]] s'affichent différemment mais créent un lien vers la même page intitulée BacÀSable.

En d'autres termes, lorsqu'une page est créée PmWiki nomme la page avec une majuscule à chaque mot (issue d'une convention typographique de titrage en anglais), mais affiche le lien tel qu'il est écrit.

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 BacÀSable mais s'affiche comme bac à sableuse?.

Vous pouvez mettre des parenthèses autour de tout texte que vous ne souhaitez pas afficher, aussi [[(bac à) sable]] est toujours un lien vers BacÀSable mais s'affiche sable?.

Enfin, vous pouvez spécifier un texte à l'aide d'une barre verticale, donc [[Bac à sable | une aire de jeu]], qui établit un lien vers BacÀSable 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 -> BacÀSable]] (une aire de jeu?).

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

Raccourcis avec les liens

Le "nom" d'une page wiki (nom du fichier) peut être différent du "titre" de la page (le titre affiché en haut de la page). Par exemple, le nom de cette page est "Links", son titre, défini par la balise (:title Liens:) est donc "Liens".

[[Nom de page|+]] crée un lien vers la page NomDePage, mais affiche le "titre" de cette page.

[[Nom de page|#]] crée un lien vers la page NomDePage, mais affiche un numéro (référence)^[1].

[[!Nom de page]] crée un lien vers la page NomDePage dans un groupe spécial nommé Category. Pour plus d'information cf. Catégories.

[[~Auteur]] crée un lien vers la page Auteur dans le groupe nommé Profiles contenant les pages personnelles des éditeurs. De cette façon on peut "signer" son commentaire dans les pages de discussion. On peut également utiliser les raccourcis ~~~ ou ~~~~ (trois ou quatre tildes) que le système remplacera avec notre nom d'utilisateur et la date.

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|texte du lien]] vers une ancre 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.

Notes. Le nom de l'ancre ([[#nom_de_l_ancre]]) doit :

• commencer par une lettre,
• ne contenir que des lettres non accentuées, des chiffres, "_" et "-",
• ne pas contenir d'espaces ou autre ponctuation,
• avoir la même capitalisation (majuscules/minuscules) que les liens.

Liens vers des pages d'autres WikiGroupes

Le syntaxe est simple, [[Groupe.Page]] ou [[Groupe/Page]] avec un point ou barre oblique comme séparateur. Toutes les autres fonctionnalités existent aussi, par exemple [[Groupe.Page | texte du lien]].

Voir WikiGroupe pour plus d'information.

Liens vers les sites externes (URLs)

Les liens vers les sites externes sont simplement 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). En particulier, l'utilisation InterMap Chemin: peut être utilisé pour créer des chemins relatifs ou absolus sur le site même ( par ex., Chemin:../../un repertoire/foo.html ou Path:/repertoire/quelquechose.gif).

Les liens externes peuvent aussi s'afficher comme des références numériques : [[http://fr.wikipedia.org|#]] affichera [2].

Liens qui ouvrent une nouvelle fenêtre du navigateur

Pour créer un lien qui ouvre une autre fenêtre, entourez-le de %newwin%...%%:

• %newwin% http://www.pmichaud.com %% produit ce lien: http://www.pmichaud.com .
• %newwin% [[http://fr.wikipedia.org|Wikipédia]]%% donne ce lien: Wikipédia
• %newwin% [[PmWikiFr.BacÀSable]]%% produit: PmWikiFr.BacÀSable?

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. %%

Cette méthode est décrite dans les WikiStyles.

<< Créer de nouvelles pages | Index de la documentation | Images >>

%newwin% http://www.pmwiki.org/ %%

* mailto:monadresse@exemple.com
* [[(mailto:)monadresse@exemple.com]]
* [[mailto:monadresse@exemple.com | contactez-moi]]