Benutzer-Werkzeuge

Webseiten-Werkzeuge


thoschwiki:dokuwiki:interwikilinkshortcuts

Dies ist eine alte Version des Dokuments!


eigene InterWiki-Links

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, abgelegt. Diese Dateien werden als Icon neben dem InterWiki 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/*

Theoretisch sollte es möglich sein, auf diesem Weg auch Icons für eigene InterWiki-Shortcuts zu integrieren.

Erschwerend kommt hinzu, dass sich das Verzeichnis lib/images/interwiki außerhalb der bisher bestehenden Volumes des Docker-Containers befindet und somit bei jedem Neuerstellen des Containers mit den Werten aus dem Image überschrieben wird.

Hierfür gibt es zwei Lösungsansätze:

  1. Ablage der Dateien im bestehenden Volume und Kopieren via docker exec -it dokuwiki cp …
  2. Erstellen und Einbinden eines zusätzlichen Volumes für das Verzeichnis lib/images/interwiki

Als Zwischenlösung sind die Grafikdateien im Namensraum internals:interwikiicons (Zugriff nur für Admin) abgelegt und werden per docker exec -it dokuwiki cp … kopiert.

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}

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}

Credits

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

thoschwiki/dokuwiki/interwikilinkshortcuts.1596274470.txt.gz · Zuletzt geändert: 01.08.2020 11:34 von thosch