Liens
Auteurs (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.
Note. 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. %% |
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 >>
Comment créer un lien qui s'ouvre dans une nouvelle fenêtre?
Utilisez le style %newwin%...%%
comme:
%newwin% http://www.pmwiki.org/ %% |
Comment placer une adresse de courrier électronique dans la page?
Utilisez le préfixe mailto:
comme :
* mailto:monadresse@exemple.com * [[(mailto:)monadresse@exemple.com]] * [[mailto:monadresse@exemple.com | contactez-moi]] |
Voyez aussi les pages (en anglais) Cookbook:DeObMail, Cookbook:EProtect, Cookbook:ProtectEmail pour information sur la protection des adresses contre les messages publicitaires.
Comment permettre des liens vers d'autres protocoles comme nntp:, ssh:, xmpp:, etc?
Voyez la page (en anglais) Cookbook:Add Url schemes
Comment trouver toutes les pages qui ont un lien vers une page donnée (liens retour, backlinks)?
Dans le champ de recherche, utilisez la commande link=Groupe.Page
.
Pour afficher la liste dans une page, ajoutez-y (:pagelist link=Groupe.Page:)
comme:
(:pagelist link=BacASable:)
-- les pages qui lient vers BacASable.(:pagelist link={$FullName}:)
-- les pages qui ont un lien vers la page en cours d'édition.
Comment afficher un pictogramme après les liens externes?
Voyez la page (en anglais) Cookbook:External links
Comment utiliser une image comme lien?
Utilisez [[Page| Attach:image.jpg ]] ou [[ http://site | http://site/image.jpg ]] . Voyez Images.
Traduction de PmWiki.Links
Page originale sur PmWikiFr.Links - Référencé par
Dernières modifications:
PmWikiFr.Links: 23/08/2010
PmWiki.Links: 18/01/2011