Benutzer-Werkzeuge

Webseiten-Werkzeuge


thoschwiki:dokuwiki:interwikilinkshortcuts

Dies ist eine alte Version des Dokuments!


InterWiki-Links anpassen und einrichten

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.

Anlegen eigener Shortcuts

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 sind – zumindest bei Verwendung des Images linuxserver/dokuwikiBesonderheiten zu beachten.

Erstellte eigene Shortcuts

DockerHub

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:

linuxserver/dokuwiki

GitHub

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:

thoschworks

ubuntuusers-Wiki

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:

Startseite

Credits

Diese Seite verwendet Textauszüge aus der Hilfeseite InterWiki Links.

1)
Aus meiner Sicht hat die Plattform ubuntuusers.de in letzter Zeit an Drive verloren.
thoschwiki/dokuwiki/interwikilinkshortcuts.1600597311.txt.gz · Zuletzt geändert: 20.09.2020 12:21 von thosch