DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


Panneau latéral

Cette traduction est plus ancienne que la page originale et est peut-être dépassée. Voir ce qui a changé.
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.

fr:interwiki

:!: mise à jour en cours :!:

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

The last 5 parameters are useful when creating interwikilinks to cachesystems.

For example cached links with the old, not longer working, Coral Content Distribution Network could be used by a coral shortcut, defined using a couple of placeholders:

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

For example, Ubuntu's wiki uses namespaces and pagenames like this LaptopTestingTeam/ToshibaPortegeM700 and without using {NAME} as a placeholder in your interwiki.local.conf file, you'll get a “Not Found” error on their wiki, because it'll interpret the forward slash as a %2F ; so what you can do is add this line to your interwiki.local.conf:

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

and now create your link to it like this:

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

If the wikiname will already include encoded characters (ex: %26 for &) use {PATH} in your interwiki.local.conf definition.

Configuring InterWiki Shortcut Icons

Interwiki icons should have a size of 16×16 pixels, be in PNG or GIF format, and be named after the shortcut.

  • <dokuwiki_root>/lib/images/interwiki
    The directory to place the image files in.

You should also purge cached PNG and GIF images as well as the CSS Files if you have the default image instead of the one you uploaded.

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

It may actually be enough to invalidate the CSS caching by re-saving in the config manager ('re-saving' means pressing the save button of config manager without any changes of config options).

If you want to disable all or some kind of link icons, refer to disabling link icons.

See also


Si vous souhaitez associer à vos raccourcis InterWiki des fichiers images vous devez les placer dans le répertoire lib/images/interwiki vous pouvez également remplacer les fichiers images fournis par défaut. Ces fichiers images doivent avoir une taille de 16×16 pixels et être au format PNG ou GIF. Vous devez également mettre le nom du fichier image, sans son extension, sur la ligne correspondante du fichier conf/interwiki.conf.

Par exemple :

dans le fichier conf/interwiki.local.conf
ajoutez:             somewiki     http://www.some.com/wiki/
dans le répertoire lib/images/interwiki/
ajoutez l'image:       somewiki.gif

wpfr http://fr.wikipedia.org/wiki/
copiez et renommez l'image : lib/images/interwiki/wp.gif   en : lib/images/interwiki/wpfr.gif
 

Pour que la nouvelle image soit rapidement prise en compte dans vos pages, il faut purger le cache, y compris le cache des pages d'instructions. Pour cela, le mieux, si vous avez accès à un shell, est de faire:

$ touch conf/local.php

Il y a un raccourci InterWiki spécial nommé this. Il désigne toujours le répertoire du serveur web dans lequel DokuWiki est installé. Vous pouvez l'utiliser pour construire des URLs relatives. Par exemple ce qui suit désigne toujours le flux XML local feed.php.

[[this>feed.php]]

Pour de plus amples information sur InterWiki

Credits

fr/interwiki.txt · Dernière modification: 2018-05-08 10:42 par Digitalin