• Vue
• Éditer
• Historique
• Imprimer
• Référencé par

Liens

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 d'autres pages du wiki

Pour créer un lien interne vers une autre page, il suffit d'encadrer le nom de la page entre doubles crochets, comme dans [[wiki sandbox]] ou [[installation]]. Cela crée des liens vers wiki sandbox et installation, respectivement.

PmWiki crée un lien en utilisant le texte entre doubles crochets. Il supprime les espaces entre les mots et met automatiquement en majuscule la première lettre de chaque mot suivant un espace ou un autre signe de ponctuation (comme ~). Ainsi, [[Wiki Sandbox]], [[wiki sandbox]] et [[WikiSandbox]] s'affichent différemment, mais créent le même lien vers la page intitulée WikiSandbox. Autrement dit, PmWiki crée automatiquement le "chemin du lien" en utilisant le nom de la page en notation CamelCase, mais le "texte du lien" s'affiche tel que vous l'avez saisi.

Some PmWiki sites (default not) will recognize words written in CamelCase, called a WikiWord, automatically as a link to a page of the same name.

Certains sites PmWiki (non par défaut) reconnaîtront automatiquement les mots écrits en CamelCase, appelés WikiWord, comme un lien vers une page du même nom.

Liens avec un texte de lien différent

Il existe trois façons d'obtenir un texte de lien différent :

Masquer le texte du lien

Le texte du lien entre parenthèses ne sera pas affiché. Ainsi, [[(wiki) sandbox]] pointe vers WikiSandbox mais s'affiche comme sandbox. Pour les adresses contenant réellement des parenthèses, utilisez %28 et %29 https://www.example.com/linkwith%28parenthese%29.

Modifier le texte du lien

Vous pouvez ajouter un autre texte de lien après une accolade verticale, comme dans [[WikiSandbox | une zone de jeu]], ou utiliser une flèche (->) pour inverser l'ordre du texte du lien et de sa cible, comme dans [[une zone de jeu -> WikiSandbox]]. Les deux liens s'affichent sous la forme une zone de jeu.

Afficher le titre de la page au lieu du nom de la page

L'utilisation de caractères spéciaux dans le nom de la page ne pose pas de problème pour PmWiki, mais sur certains serveurs, il peut être préférable d'utiliser uniquement des lettres de A à Z pour le "nom" de la page (qui est aussi un nom de fichier), et de définir le "titre" de la page avec des caractères étendus ou internationaux grâce à la directive (:title PageTitle:) dans la page. Le titre de la page peut être affiché à la place de son nom grâce au balisage de lien [[PageName|+]], par exemple, la page BasicEditing contient la directive (:title Syntaxe d'édition de base:), ce qui a pour effet qu'un lien écrit comme [[BasicEditing|+]] s'affichera comme Syntaxe d'édition de base. Voir aussi $EnableLinkPlusTitlespaced.
Depuis la version 2.2.14 de PmWiki, cela fonctionne également pour les pages techniques qui possèdent une entrée dans XLPage, sans qu'il soit nécessaire d'ajouter la directive (:title PageTitleName:) dans cette page (pour plus de détails, voir Localization).

En plus des méthodes ci-dessus, un suffixe peut être ajouté à la fin d'un lien ; il fait alors partie du texte du lien, mais pas du nom de la page cible. Remarque : Cette fonctionnalité est compatible avec le balisage [[PageName|+]] uniquement depuis la version 2.2.90.

* [[(wiki) sandbox]]
* [[(wiki) sandbox]]es
* [[WikiSandbox | wiki sandbox]]
* [[WikiSandbox | wiki sandbox]]es
* [[BasicEditing | +]]

Liens avec infobulle

À partir de la version 2.2.14, PmWiki peut afficher les titres des infobulles au format suivant :

lien externe

[[https://pmwiki.org"titre de l'info-bulle externe" | lien externe ]], eg external link or https://pmwiki.org

lien interne

[[Links"titre de l'info-bulle interne" | internal link ]], eg lien interne or Links

Liens d'ancrage

[[#name"titre de l'info-bulle d'ancrage"|texte du lien d'ancrage]] (since Version 2.2.48), eg texte du lien d'ancrage or #name

InterMap link

[[Wikipedia:Wiki"titre de l'info-bulle"| Lien InterMap ]], eg Lien InterMap or Wikipedia:Wiki

Liens vers des pages inexistantes

Les liens vers des pages inexistantes sont affichés de manière spéciale afin d'inviter d'autres personnes à créer la page. Consultez la section Création de nouvelles pages pour en savoir plus.

Liens vers des pages d'autres groupes wiki

Les liens tels qu'ils apparaissent ci-dessus sont des liens entre pages d'un même groupe. Pour créer un lien vers une page d'un autre groupe, ajoutez le nom de ce groupe suivi d'un point ou d'une barre oblique au nom de la page. Par exemple, un lien vers Main/WikiSandbox pourrait s'écrire ainsi :

* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | texte du lien]]
* [[Main.WikiSandbox | +]]

Pour créer un lien vers la "page d'accueil par défaut" d'un groupe, le nom de la page peut être omis :

* [[Main.]]
* [[Main/]]

Consultez la section Wiki Group pour en savoir plus sur les groupes PmWiki.

Liens de catégorie

Les catégories permettent d'organiser et de retrouver facilement les pages associées. Chaque page traitant d'un sujet particulier doit comporter un lien vers une page partagée contenant des liens vers d'autres pages de ce même sujet. Ces pages partagées sont créées dans le groupe spécial Category, d'où le nom de "catégories" donné à ces sujets.

Ajouter une page à la catégorie Subject est simple : il suffit d'insérer le balisage [[!Subject]] sur cette page. Cela créera un lien vers la page Category.Subject. Ainsi, [[!Subject]] est un raccourci vers la page Category.Subject. Consultez la section Categories pour en savoir plus.

Liens vers les pages utilisateur -- "signatures"

Similaire à [[~Author]], un raccourci vers la page Author du groupe spécial Profiles. PmWiki crée automatiquement ce type de lien pour l'auteur actuel lorsqu'il rencontre trois tildes (~) consécutifs (~~~) dans le texte de la page. L'auteur actuel est le nom figurant dans le champ "Auteur" lors de la création ou de la modification d'une page. La date et l'heure actuelles sont ajoutées lorsqu'il rencontre quatre tildes consécutifs (~~~~).

Ainsi, lorsque le champ Auteur contient "Author" :
~~~ sera remplacé par : Author
~~~~ sera remplacé par : Author 10 octobre 2010 à 16h50

Le format de l'heure peut être modifié dans la configuration locale avec $CurrentTime.

Raccourcis de liens

[[PageName|#]] crée un lien référence comme indiqué ci-dessous^[1].

Liens vers des emplacements spécifiques dans une page -- "ancres"

Pour définir un emplacement, ou signet, appelé ancre, dans une page, vers lequel vous pouvez accéder directement, utilisez le balisage suivant :

• [[#name]]
• !#name Texte du titre

Ces balises créent une "ancre" qui identifie de manière unique cet emplacement dans la page.

Pour qu'un lien permette d'accéder directement à cette ancre, utilisez le balisage suivant :

• [[#name | [texte du lien]] Lien vers une ancre au sein de la page
• [[PageName#name]] ou [[PageName#name | texte du lien]] Lien vers une ancre sur une autre page
• [[PageName(#name)]] Masquer le texte de l'ancre dans un lien.

Par exemple, voici un lien vers la section Intermaps ci-dessous.

Remarques :

• Le nom de l'ancre doit commencer par une lettre, et non par un chiffre.
• Les caractères valides pour les noms d'ancre sont les lettres, les chiffres, le tiret (-), le trait de soulignement (_) et le point (.).
• Un lien vers une ancre doit respecter la même casse que l'ancre elle-même.
• * Les espaces ne sont pas autorisés dans une ancre : "[[#mon ancre]]" ne fonctionnera pas, « [[#monancre]] » fonctionnera.
• Tous les noms d'ancre d'une page doivent être uniques.

Fragments de texte

Les navigateurs récents permettent d'insérer des liens vers des fragments de texte sur la page. Ouvrir un tel lien permet de faire défiler la page jusqu'au texte et de le sélectionner.

Pour indiquer un fragment de texte dans un lien, ajoutez #~ suivi de la chaîne de recherche :

* [[PmWiki#~collaborative creation|Trouvez "collaborative creation" sur la page d'accueil]]

Cette fonction est opérationnelle pour les liens internes, externes et InterMap. La recherche ne tient pas compte de la casse ni des signes diacritiques.

La syntaxe des fragments de texte définit les éléments suivants, séparés par une virgule et un tiret :

  préfixe optionnel-,texte à marquer ou début de la marque,fin de la marque optionnelle,-suffixe optionnel.

Si un élément "fin de la marque" est présent, le texte sélectionné se trouve entre le début et la fin, par exemple :

* [[DocumentationIndex#~Tables,headings|Marque entre "Tables" et "headings"]]

Les préfixes optionnels prefix- et -suffix permettent d'éviter toute ambiguïté en cas d'occurrences multiples. Ils précèdent ou suivent le texte mis en évidence, mais ne sont pas surlignés. Les tirets sont des séparateurs et ne font pas partie du texte de la page.

Pour mettre en évidence un texte contenant des virgules, utilisez les caractères d'échappement PmWiki :

* [[PmWikiPhilosophy#~[=Au cœur de PmWiki=],authored.|Marque entre "Au cœur de PmWiki" et "authored."]]

Sections

Alors qu'en HTML, les ancres servent principalement à naviguer dans le texte, dans PmWiki, elles ont également une fonction interne : chaque ancre crée une section, car les sections sont définies comme la partie de la page comprise entre leur ancre de départ et l'ancre suivante. Pour plus de détails, consultez Sections de Page.

Liens vers des actions

Pour créer un lien vers une action spécifique de la page actuelle, utilisez [[{$FullName}?action=nom_de_l'action|texte du lien]].

Exemples :

• [[{$FullName}?action=edit|Modifier]] pour modifier
• [[{$FullName}?action=diff|Historique]] pour consulter l'historique.

Liens externes au wiki

Liens vers des sites externes (URL)

Les liens vers des sites externes commencent simplement par un préfixe tel que 'https:', 'ftp:', etc. Ainsi, https://google.com/ et [[https://google.com/]] pointent tous deux vers Google. Comme ci-dessus, un auteur peut spécifier le texte du lien en utilisant la syntaxe des accolades verticales ou des flèches, comme dans [[https://google.com/ | Google]] et [[Google -> https://google.com]].

Si le lien externe contient des parenthèses, échappez-les en utilisant %28 pour "(" et %29 pour ")" :

[[https://en.wikipedia.org/wiki/Wiki_%28disambiguation%29 | lien vers "Wiki (disambiguation)" ]]

La recette Cookbook:FixURL facilite l'encodage des parenthèses et autres caractères spéciaux dans les adresses de liens.

Liens avec des caractères spéciaux

Pour inclure des caractères spéciaux, tels que des guillemets, des espaces, des parenthèses et des barres verticales, dans les adresses de liens, utilisez [=adresse du lien=].

Liens du wiki vers des ressources du même site web

Vous pouvez utiliser le préfixe Path: pour ajouter des liens externes au wiki, mais situés sur le même site web.

Utilisez Path:/path/to/resource avec une barre oblique initiale pour les liens relatifs à la racine du site web, comme dans www.example.com/path/to/resource.

Vous pouvez également définir un préfixe InterMap personnalisé pour un chemin spécifique de votre site web et l'utiliser comme raccourci, par exemple :

Ensuite, sur une page wiki, utilisez Pictures:photo.jpg au lieu de Path:/assets/pictures/photo.jpg ou https://www.example.com/assets/pictures/photo.jpg.

Consultez InterMap pour plus d'informations.

Liens vers des fichiers intranet (locaux)

La plupart des navigateurs modernes n'acceptent pas ces liens pour des raisons de sécurité.

Vous pouvez créer un lien vers un système de fichiers en incluant le préfixe 'file:///'. Ainsi, file:///S:\ProjPlan.mpp et [[Lecteur S partagé->file:///S:\]] sont tous deux des liens valides. Sous Windows, il est préférable d'utiliser des emplacements réseau (par exemple file:///\\serveur1\répertoire_racine\sous-répertoire) plutôt que des lettres de lecteur, qui peuvent varier d'un utilisateur à l'autre.

Voir aussi : Cookbook:DirList.

Caractéristiques des liens

Liens de référence

Les liens peuvent également être spécifiés comme des "références", de sorte que la cible apparaisse comme une référence numérique anonyme plutôt que textuelle. Le balisage suivant permet de générer une numérotation séquentielle des références au sein d'une page PmWiki :

Le formatage du lien suivant : [[https://google.com |#]] produit : [2] comme lien.

Les occurrences suivantes de ce format de lien de référence sur la même page seront incrémentées automatiquement, comme dans l'exemple suivant : Saisir [[https://pmwiki.com |#]] produit [3], [[#intermaps |#]] produit [4], et ainsi de suite pour les liens de référence suivants.

Mais il convient de noter que cette fonctionnalité est volontairement simplifiée et ne fonctionne pas comme des références bibliographiques : ce lien supplémentaire [[https://pmwiki.com |#]] produirait [5] et ne réutiliserait pas la première définition de lien.

Intermaps

Les liens Inter Map sont également pris en charge (voir Inter Map). En particulier, l'entrée InterMap Path: permet de créer des liens à l'aide de chemins relatifs ou absolus sur le site actuel (par exemple, Path:../../somedir/foo.html ou Path:/dir/something.gif).

Liens ouvrant une nouvelle fenêtre

Pour ouvrir un lien dans une nouvelle fenêtre, utilisez %newwin%...%% :

• %newwin% https://pmichaud.com %% affiche https://pmichaud.com
• %newwin% [[https://google.com/ | Google]] %% affiche Google
• %newwin% [[Main.WikiSandbox]] %% produit Main.WikiSandbox

Vous pouvez également spécifier que les liens doivent s'ouvrir dans une nouvelle fenêtre via l'attribut %target=_blank%...%% :

Le lien suivant %target=_blank% https://pmichaud.com %%
s'ouvrira dans une nouvelle fenêtre.

Liens non suivis par robots

Ajoutez le préfixe %rel=nofollow% à un lien pour indiquer à robots et aux vérificateurs de liens de ne pas le suivre.

Liens et classes CSS

PmWiki attribue automatiquement des classes à différents types de liens. Cela vous permet notamment de formater chaque type différemment.

Remarque : Cette liste peut être incomplète.

.selflink

Lien vers la page actuelle. Utile dans les barres latérales pour indiquer "Vous êtes ici".

.wikilink

Lien vers une autre page du wiki.

.urllink

Lien vers une page externe au wiki.

Remarques

Remarque : Le comportement par défaut du symbole "+" ci-dessus peut être modifié pour afficher le titre avec espace, et non le titre seul, en ajoutant la ligne suivante au fichier config.php : $EnableLinkPlusTitlespaced = 1;

FAQ

%newwin% https://example.com/ %%

* mailto:[email protected]
* [[mailto:[email protected]]]
* [[mailto:[email protected] | m'envoyer un e-mail]]
* [[mailto:[email protected]?subject=Sujet | m'envoyer un e-mail]]

[[https://example.com/ | WikiWord]]
[[WikiWord -> https://example.com/]]

(:pagelist link=SomePage list=all:) -- afficher tous les liens vers SomePage
(:pagelist link={$FullName} list=all:) -- afficher tous les liens vers la page actuelle

(:if exists Group1.Page:)
[[Group1.Page|Page]]
(:elseif exists Group2.Page:)
[[Group2.Page|Page]]
(:ifend:)

$WikiStyle['download']['download'] = '';
$WikiStyleAttr['download'] = 'a';

Traduction de PmWiki.Links Page originale sur PmWikiFr.Links - Référencé par
Dernières modifications:
PmWikiFr.Links: 26 mai 2026 à 15h04
PmWiki.Links: 07 avril 2026 à 20h21