DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


Panneau latéral

Traductions de cette page?:

Découvrir DokuWiki

Options avancées

Pour les entreprises

Notre Communautée


Suivez-nous sur Facebook, Twitter et les autres résaux sociaux.

Notre politique de confidentialité

fr:interwiki

Liens InterWiki

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 :

[[wp>InterWiki]] InterWiki liens vers la version anglaise de Wikipedia
[[wpfr>InterWiki]] InterWiki liens vers la version française de Wikipedia
[[phpfn>random]] random liens vers une fonction du manuel PHP
[[google>Wiki]] Wiki liens vers une recherche Google
[[doku>interwiki]] interwiki liens vers le wiki de DokuWiki
[[skype>echo123]] echo123 liens qui ouvre Skype, prêt à faire un test d'appel (echo123)
[[this>feed.php]] feed.php liens vers l'URL de votre wiki. Cet exemple crée un lien local de flux XML. [[this>]] est un cas particulier et le seul lien interwiki qui ne peut pas être configuré par l'intermédiaire d'un fichier de configuration.

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}}

Configuration des raccourcis InterWiki

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 http://usemod.com/intermap.txt). 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 :


Exspace réservé Remplacé par
{URL} URL-encoded wikiname (the part which is appended to the URL in interwiki.local.conf)
{NAME} wikiname without any encoding
{SCHEME} scheme part if a URL was given as wikiname
{HOST} host part if a URL was given as wikiname
{PORT} port part if a URL was given as wikiname
{PATH} path part if a URL was given as wikiname
{QUERY} query part if a URL was given as wikiname

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.

Configuration de l'icône de raccourci InterWiki

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.

Voir aussi

Crédits

Philippe LAPEYRIE
Mise à jour — digitalindigitalin
Digitalin

2020-05-23 19:54

fr/interwiki.txt · Dernière modification: 2020-05-23 20:28 de Digitalin