Dies ist eine alte Version des Dokuments!
Die Ursprungsidee des InterWiki war die Schaffung eines großen, über das gesamte Internet verteilten Wikis. Heute ist es jedoch eher ein schneller Weg von einem Wiki in ein anderes 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 zur englischsprachigen Wikipedia, [[wpde>Wiki]] Link zur deutschsprachigen Wikipedia
Die InterWiki Shortcuts werden in der Datei conf/interwiki.conf
definiert (aktuelle Version im GitHub-Repository).
Das Format der interwiki config Datei lautet:
<shortcut> <url zum wiki>
Diese Funktion lässt sich nicht nur für Verlinkungen auf Wikis nutzen, sondern für Verlinkungen auf alle Web-Sites, die einen streng strukturierten Aufbau der URLs haben.
Eine Änderung oder Ergänzung der Datei conf/interwiki.conf
ist durchaus möglich, jedoch gehen die selbst angelegten Shortcuts beim Update des DokuWikis verloren. Daher sollten eigene Shortcuts in der Datei conf/interwiki.local.conf
abgelegt werden werden.
Details können der Hilfseite InterWiki Links entnommen werden.
Im Verzeichnis lib/images/interwiki
sind Grafikdateien, die namensgleich zu den Shortcuts sind (Kleinschreibung beachten!), abgelegt. Diese Dateien werden als Icon neben dem InterWiki-Link angezeigt.
Laut Dokumentation können diese Dateien gegen eigene Dateiversionen ausgetauscht werden. Sie sollten im Format 16×16 Pixel sowie als PNG- oder GIF-Datei vorliegen.
Bei einer Änderung der Dateien soll der Cache geleert werden:
rm -rf <path-to-dokuwiki>/data/cache/*
Es ist möglich, auf diesem Weg auch Icons für eigene InterWiki-Shortcuts zu integrieren.
Beim Einsatz des DokuWiki in einem Docker-Container – zumindest bei Verwendung des Images linuxserver/dokuwiki – sind Besonderheiten zu beachten.
DockerHub ist ein Repository für Docker-Images. Die URLs haben zwei Strukturen:
URL | Nutzung |
---|---|
https://hub.docker.com/u/<Username> | Link auf Übersichtsseite eine Benutzers |
https://hub.docker.com/r/<Username>/<Repository> | Link auf Repository |
Wird bei einem Link für ein Repository nur der Username, aber nicht der Repository-Name vorgegeben, dann wir der Seitenaufruf vom DockerHub-Webserver automatisch in das Format für eine Benutzerseite umgeschrieben:
https://hub.docker.com/r/<Username> => https://hub.docker.com/u/<Username>
Daraus lässt sich der folgende shortcut ableiten:
dockerhub https://hub.docker.com/r/{NAME}
Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem Favicon von Docker abgeleitet wurde.
Beispiel:
GitHub ist ein auf Git basierender netzbasierter Dienst zur Versionskontrolle.
GitHub hat einen sehr klar strukturierten URL-Aufbau:
https://github.com/<Username>/<Repository>
Die Benutzerseite kann unter Weglassen des Repository-Namens erreicht werden. Durch Anfügen weiterer Bestandteile können auch zielgerichtet einzelne Teile des Repositories (z.B. Dateien, Issues, Wiki) adressiert werden.
Daraus lässt sich der folgende shortcut ableiten:
github https://github.com/{NAME}
Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem Favicon von GitHub abgeleitet wurde.
Beispiel:
Das Wiki von ubuntuusers.de ist eine Sammlung von Anleitungen und Problemlösungen zum Thema Ubuntu-Linux auf der Webplattform von ubuntu Deutschland e.V..1)
Das ubuntuusers-Wiki hat den folgenden URL-Aufbau:
https://wiki.ubuntuusers.de/<Artikelname>/
Daraus lässt sich der folgende shortcut ableiten:
ubuntuusers https://wiki.ubuntuusers.de/{NAME}/
Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem Favicon von ubuntuusers.de abgeleitet wurde.
Beispiel:
Diese Seite verwendet Textauszüge aus der Hilfeseite InterWiki Links.