Timtom's notes | PmWikiFr / InterMap

(redirected from PmWikiFr.CustomInterMap)

< Inclure d'autres pages | Index de la documentation | Affichage conditionnel >

auteur (niveau intermédiaire)

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 ?

Vous pouvez définir vos propres préfixes dans votre page locale Site.InterMap ?.

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

points de départ sur Meatball
points de départ 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 :

Jargon: http://catb.org/~esr/jargon/html/$1.html

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

Les noms InterMap sont-ils sensibles à la casse ?

Oui ; ainsi, eAdmin: est un lien InterMap différent de EAdmin:.

Comment puis-je réaliser un mappage dans localmap.txt produisant le même effet que Pics: Path:/somepathto/pics/ ?

Utilisez ceci :

Pics: /somepathto/pics/

Comment puis-je définir un InterMap en PHP ?

Utilisez ceci :

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

Comment puis-je définir un lien InterMap me permettant de faire référence à des fichiers situés à la "racine" du serveur ?

Depuis la page https://example.org/index.php/Main/HomePage, je souhaite créer un lien relatif vers un répertoire situé à la racine du site. L'URL complète est https://example.org/commoninfo/infoaboutu.php. Je souhaite procéder ainsi car le nom de domaine va changer, ce qui rendrait un lien absolu invalide.

Utilisez le préfixe "Path:" existant, comme dans Path:/commoninfo/infoaboutu.php.

<< Inclure d'autres pages | Index de la documentation | Affichage conditionnel >>