InterWiki Links

Die Ursprungsidee des InterWiki war die Schaffung eines großen, über das gesamte Internet verteilten Wiki. Heute ist es jedoch wesentlich einfacher, auf jeweiligen Wikis auf Grund der einfachen Verlinkungsmöglichkeit zu verweisen.

Im DokuWiki wird dies durch eine vordefinierte Verknüpfung des Wiki-Seitennamens mittels Shortcut getrennt durch das > Zeichen erreicht.

Beispiel:

[[wp>Wiki]] Link zu englischsprachigen Wikipedia,
[[Meatball>TourBusStop]] Link zum MeatBall wiki TourBusStop,
[[google>Wiki]] Link zur Suche mit google.com.

Wiki Link zu englischsprachigen Wikipedia, TourBusStop Link zum MeatBall wiki TourBusStop, Wiki Link zur Suche mit google.com

Es gibt einen speziellen interwiki Shortcut: this. Er zeigt immer auf das Verzeichnis des Webservers, auf dem DokuWiki intstalliert ist. Du kannst ihn verwenden um relative URLs zu erzeugen. Beispielsweise kannst Du immer auf das lokale XML feed verweisen: feed.php

[[this>feed.php]]

mehr Info im InterWiki:

• InterWiki auf MeatBall
• InterWiki auf c2.com Wiki

InterWiki Shortcuts werden in der Datei conf/interwiki.conf definiert. Die bereits eingetragenen Shortcuts stammen aus http://usemod.com/intermap.txt. Du kannst Deine eigenen Interwiki-Links durch Anlegen der Datei conf/interwiki.local.conf und den ensprechenden Einträgen erzeugen.

Es ist durchaus möglich, die Originaldatei conf/interwiki.conf zu modifizieren, jedoch wird diese bei Update des DokiWiki überschrieben, die Anpassung geht verloren.

Du kannst Grafikdateien, namensgleich zu den Shortcuts erstellen und im Verzeichnis lib/images/interwiki speichern, um sie anstelle der Vorgabegrafik zu verwenden. Sie sollte im Format 16×16 Pixel sowie als PNG- oder GIF-Datei vorliegen. Du solltest das Cache leeren, falls Du wieder die Standardgrafik statt deines Icons verwenden möchtest.

rm -rf <path-to-dokuwiki>/data/cache/*

Das Format der interwiki config Datei lautet:

<shortcut>      <url zum wiki>

Der Shortcut ist jener, der später zur Verwendung benötigt wird. In der URL können Platzhalter verwendet werden, um die Verlinkung flexibler zu gestalten.

If no placeholder is given the URL-encoded wikiname will be appended to the URL.

Folgende Platzhalter stehen zur Verfügung:

Platzhalter	wird ersetzt durch
{URL}	URL-encoded wikiname
{NAME}	wikiname without any encoding (the part which is appended to the url in interwiki.local.conf)
{SCHEME}	scheme part if an URL was given as wikiname
{HOST}	host part if an URL was given as wikiname
{PORT}	port part if an URL was given as wikiname
{PATH}	path part if an URL was given as wikiname
{QUERY}	query part if an URL was given as wikiname

Die letzten 5 Parameter sind nützlich bei der Erstellung von Interwiki-Links in Cache-Systemen. Beachte hierzu den coral Shortcut gemäß Eintrag in der Datei interwiki.conf.