DokuWiki

Modifiez cette page et cliquez sur « Enregistrer ». Voyez le guide de mise en page pour une aide à propos du formatage. Veuillez ne modifier cette page que si vous pouvez l'améliorer. Si vous souhaitez faire des tests, faites vos premiers pas dans le bac à sable.

====== 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 [[pagename|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 [[fr:changes#release_2017-02-19e_frusterick_manners|version 2017-02-19b "Frusterick Manners"]] de DokuWiki, la substitution interwiki pour les images externes est disponible.

===== Configuration des raccourcis InterWiki =====
Les raccourcis InterWikis sont définis dans deux fichiers :

* le fichier ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/interwiki.conf|<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 [[fr:pagename|des noms de page]].

Le format du fichier de configuration des liens interwiki est :

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 [[phpfn>rawurlencode|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, [[wp>Coral Content Distribution Network]] pourraient être utilisés par un raccourci ''coral'', défini à l'aide de quelques caractères de substitution :

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

Par exemple, la documentation [[https://wiki.ubuntu.com/|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:

<code>ubuntu https://wiki.ubuntu.com/{NAME}</code>

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

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

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 16x16 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 [[fr:caching|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.

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

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 à [[tips:disabling link icons]].

===== Astuce =====
==== Hastag (Fragment) ====
Si vous utilisez le nom de votre interwiki dans la partie fragment de votre URL, vous devez l'échapper.

Exemple:
  * Configuration
<file apache conf/interwiki.local.conf>
postconf  http://www.postfix.org/postconf.5.html\#{NAME}
</file>
  * Usage
<code>
[[postconf>smtpd_tls_received_header]]
</code>

===== Voir aussi =====

* [[fr:config|Configuration de DokuWiki]]
  * [[tips:interwiki_shortcuts|Additional InterWiki Shortcuts]]

===== Crédits =====

--- [[philippe@bdsemin.com|Philippe LAPEYRIE]]\\
Mise à jour  --- [[user>Digitalin|digitalin]] //2020-05-23 19:54//

Merci de recopier le code ci-contre pour prouver que vous êtes humain. V S R P᠎ R Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International