L'idée originale d'InterWiki était d'avoir un grand Wiki réparti sur tout internet. Aujourd'hui c'est plutôt une façon de lier facilement un wiki à un autre avec une syntaxe simple et facile à mettre en oeuvre.

Dans DokuWiki ceci est réalisé en préfixant un nom de page avec un raccourci séparé par le caractère “>”

Exemples :

Voici un exemple de la façon d'accéder arbitrairement à un fichier dans le répertoire data/media de dokuwiki en cliquant sur une image. C'est utile pour les vidéos et les fichiers pdf.

[[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]

Depuis la version 2017-02-19b "Frusterick Manners" de DokuWiki, la substitution interwiki pour les images externes est disponible.

{{ phpfn>images/php.gif?96}}

Les raccourcis InterWikis sont définis dans deux fichiers :

• le fichier <dokuwiki_conf>/interwiki.conf.
  Voici le fichier par défaut, il contient quelques raccourcis utiles prédéfinis (d'autres peuvent être trouvés dans https://www.usemod.org/cgi-bin/wiki.pl?InterMap). Il est possible de modifier ce fichier, mais cela pourrait entraîner l'écrasement de vos modifications lors de la mise à jour de DokuWiki.
• le fichier <dokuwiki_conf>/interwiki.local.conf.
  C'est le fichier pour ajouter vos propres liens interwiki en évitant ainsi que les liens ne soient écrasés lors d'une mise à jour.

Les raccourcis interwiki doivent être en minuscules et suivre les conventions des noms de page.

Le format du fichier de configuration des liens interwiki est :

<raccourci>      <url du wiki>

Le raccourci est celui que vous pourrez utiliser dans le lien plus tard. Dans l'URL, vous pouvez utiliser certains espaces réservés pour être plus flexible dans les liens. Si aucun caractère de remplacement n'est donné, le URL-encoded] nom du wiki sera ajouté à l'URL. Les espaces réservés suivants sont disponibles :

Les 5 derniers paramètres sont utiles pour créer des liens interwiki entre les systèmes de cache.

Par exemple, les liens mis en cache avec l'ancien système, qui ne fonctionne plus, Coral Content Distribution Network pourraient être utilisés par un raccourci coral, défini à l'aide de quelques caractères de substitution :

coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY}

Par exemple, la documentation du wiki Ubuntu utilise des noms de pages et des catégories comme LaptopTestingTeam/ToshibaPortegeM700 et sans utiliser {NAME} comme espace réservé de substitution dans votre fichier de configuration interwiki.local.conf, vous allez obtenir une erreur “Not Found” dans votre wiki, parce qu'il interprétera la barre oblique comme un %2F ; ce que vous pouvez faire est d'ajouter au fichier interwiki.local.conf:

ubuntu https://wiki.ubuntu.com/{NAME}

et maintenant créer votre lien de cette manière:

[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu on Toshiba Portege M700 Tablet]]

Si le nom wiki contient déjà des caractères encodés (ex: %26 for &), utiliser {PATH} dans votre définition de lien interwiki.local.conf.

Les icônes de raccourci InterWiki doivent avoir un taille de 16×16 pixels, être au format PNG ou GIF et être nommées après le raccourci.

• <dokuwiki_root>/lib/images/interwiki
  Le répertoire où placer les fichiers image.

Vous devrez aussi purger le cache des images PNG et GIF ainsi que les fichiers CSS si vous avez l'image par défaut au lieu de celles que vous avez téléversées.

rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}

En fait, réenregistrer dans le gestionnaire de configuration peut suffire à invalider la mise en cache CSS. «Réenregistrer» signifie appuyer sur le bouton Enregistrer du gestionnaire de configuration sans modifier les options de configuration).

Si vous souhaitez désactiver tout ou partie des icônes de lien, reportez-vous à disabling link icons.

Si vous utilisez le nom de votre interwiki dans la partie fragment de votre URL, vous devez l'échapper.

Exemple:

• Configuration

conf/interwiki.local.conf

postconf  http://www.postfix.org/postconf.5.html\#{NAME}

• Usage

[[postconf>smtpd_tls_received_header]]

• Configuration de DokuWiki
• Additional InterWiki Shortcuts

— Philippe LAPEYRIE
Mise à jour — digitalin 2020-05-23 19:54