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

InterMap

(ré-aiguillé depuis PmWikiFr.CustomInterMap)

L'InterMap (également appelé InterWiki sur certains autres wikis) est un système permettant de définir des liens entre des sites WikiWikiWeb ; il a été initialement développé par UseMod et Meatball (voir UseMod:InterWiki et Meatball:InterWiki). La méthode consiste à utiliser un mot-clé (raccourci) représentant un chemin défini. Les liens InterMap prennent la forme MapPrefix:PagePath, où le préfixe hôte est converti en une partie d'URL en fonction des entrées figurant dans les fichiers intermap.txt et localmap.txt du site.

Le fichier intermap.txt par défaut

Le fichier intermap.txt par défaut, distribué avec PmWiki (dans le répertoire scripts/), contient les entrées InterMap suivantes :

 PmWiki:     https://www.pmwiki.org/wiki/PmWiki/
 Cookbook:   https://www.pmwiki.org/wiki/Cookbook/
 Skins:      https://www.pmwiki.org/wiki/Skins/
 Wiki:       https://wiki.c2.com/?
 UseMod:     https://www.usemod.org/cgi-bin/wiki.pl?
 Meatball:   http://meatballwiki.org/wiki/
 Wikipedia:  https://en.wikipedia.org/wiki/
 PITS:       https://www.pmwiki.org/wiki/PITS/
 PmL10n:     https://www.pmwiki.org/wiki/Localization/
 Path:       

La page Site.InterMap

Site.InterMap contient les entrées suivantes :

 PmWikiHome:  https://www.pmwiki.org/wiki/
 Category:    https://www.pmwiki.org/wiki/Category/
 MoinMoin:    https://moinmo.in/
 PmWikiUsers: https://pmichaud.com/pipermail/pmwiki-users/
 RFC:         https://tools.ietf.org/html/rfc

 Wiktionary:  https://en.wiktionary.org/wiki/
 Wikimedia:   https://meta.wikimedia.org/wiki/
 Wikitravel:  https://wikitravel.org/en/
 Wikivoyage:  https://en.wikivoyage.org/wiki/
 Wikiquote:   https://en.wikiquote.org/wiki/
 Wikinews:    https://en.wikinews.org/wiki/
 Wikibooks:   https://en.wikibooks.org/wiki/
 Wikisource:  https://en.wikisource.org/wiki/
 Wikispecies: https://species.wikimedia.org/wiki/
 Wikiversity: https://en.wikiversity.org/wiki/

 DOI:         https://dx.doi.org/$1

Ainsi, "PmWiki:Variables" devient "https://www.pmwiki.org/wiki/PmWiki/" + "Variables", un lien vers la page PmWiki.Variables du site officiel de PmWiki ; Wiki:FrontPage est un lien vers la page d'accueil du premier WikiWikiWeb, et Wikipedia:Stonehenge vous renvoie à l'article de Wikipédia consacré aux célèbres mégalithes anglais.

Utilisation dans une page wiki

Comme pour les autres liens, vous pouvez utiliser la syntaxe à doubles crochets pour définir un texte de lien personnalisé :

* [[Meatball:StartingPoints | points de départ]] sur Meatball
* [[points de départ -> Meatball:StartingPoints]] sur Meatball

Si vous souhaitez créer un lien vers la cible définie par l'intermap (par ex. https://en.wikipedia.com/wiki/ pour Wikipédia), utilisez [[Wikipedia:. | page d'accueil de Wikipédia]], ce qui produit page d'accueil de Wikipédia. Notez la présence du point (.) après la référence Map:.

L'entrée spéciale Path: d'InterMap peut être utilisée pour créer des "URL relatives" dans des liens.

Préfixes InterMap personnalisés

L'ensemble des liens InterMap d'un site est défini par l'administrateur du site via la page Site.InterMap et le fichier local/localmap.txt.

Une entrée InterMap suit le format suivant :

MapPrefix:      https://example.com/partial/url/

L'entrée InterMap peut correspondre à l'un des schémas de liens pris en charge par PmWiki.
Vous pouvez créer vos propres liens InterMap en effectuant une ou plusieurs des actions suivantes :

• Modifiez la page nommée Site.InterMap et y insérez des entrées semblables à celles indiquées ci-dessus.
• Créez un fichier nommé local/localmap.txt et y insérez des entrées semblables à celles indiquées ci-dessus.
• Dans une installation de type WikiFarm, vous pouvez créer un fichier nommé local/farmmap.txt et y placer des entrées semblables à celles indiquées ci-dessus. Ces préfixes seront communs à tous les wikis de la ferme.
• Assurez-vous qu'il y a un espace après le deux-points.

Ne modifiez pas directement le fichier scripts/intermap.txt ! Si vous le faites, vous perdrez vos modifications lors de la upgrade mise à jour de PmWiki.

Variables et liens InterMap

Il est possible d'utiliser des variables dans vos entrées InterMap. Les entrées suivantes créent les raccourcis ThisWiki: et ThisPage: :

ThisWiki:        $ScriptUrl
ThisPage:        {$PageUrl}

Vous pouvez également définir des entrées InterMap où le texte de l'entrée est inséré au milieu de l'URL. Il suffit d'inclure « $1 » dans l'URL à l'endroit où doit s'effectuer la substitution. Par exemple :

transformerait Jargon:F/feature-creep en http://catb.org/~esr/jargon/html/F/feature-creep.html.

Trucs et astuces

Il est possible de documenter vos préfixes InterMap directement dans la page Site.InterMap. Le texte supplémentaire n'entraînera aucune baisse de performance et ne compromettra pas la définition des préfixes. Toutefois, sachez que toute ligne commençant par un mot suivi d'un deux-points (:) sera considérée comme définissant un préfixe.

L'ordre dans lequel les différentes sources sont examinées pour les définitions de préfixes est déterminé par la variable $InterMapFiles. Actuellement, la priorité (de la plus élevée à la plus faible) est la suivante :

• local/localmap.txt
• $SiteGroup.InterMap
• $FarmD/local/farmmap.txt
• $FarmD/scripts/intermap.txt

      $LinkFunctions['PmWikiHome:'] = 'LinkIMap';
      $IMap['PmWikiHome:'] = 'https://pmwiki.org/wiki/$1';

Traduction de PmWiki.InterMap Page originale sur PmWikiFr.InterMap - Référencé par
Dernières modifications:
PmWikiFr.InterMap: 24 September 2026 à 07h48
PmWiki.InterMap: 13 September 2025 à 01h46