Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

--- thoschwiki:dokuwiki:interwikilinkshortcuts [31.07.2020 14:17]
thosch Stub angelegt
+++ thoschwiki:dokuwiki:interwikilinkshortcuts [27.06.2021 15:56] (aktuell)
thosch [Snapcraft] Shortcut berichtigt
@@ Zeile 1: / Zeile 1: @@
-====== eigene InterWiki-Links ======
+====== 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-[[pagenames|Seitennamens]] mittels Shortcut getrennt durch das ''>'' Zeichen erreicht.
+Im [[doku>de:dokuwiki|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 ([[github>splitbrain/dokuwiki/blob/master/conf/interwiki.conf|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 [[doku>de:interwiki#Konfiguration von InterWiki Shortcuts|InterWiki Links]] entnommen werden.
+===== Icons für InterWiki Links =====
+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 16x16 Pixel sowie als PNG- oder GIF-Datei vorliegen.
+Bei einer Änderung der Dateien soll der Cache geleert werden:
+<code>
+rm -rf <path-to-dokuwiki>/data/cache/*
+</code>
+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 [[dockerhub>linuxserver/dokuwiki]] – sind [[thoschwiki:docker:apps:dokuwiki#persistieren_von_sitespezifischen_interwiki-link-icons|Besonderheiten zu beachten]].
+===== Erstellte eigene Shortcuts =====
+==== DockerHub ====
+[[https://hub.docker.com|DockerHub]] ist ein Repository für Docker-Images. Die URLs haben zwei Strukturen:
+^ URL ^ Nutzung ^
+| <code>https://hub.docker.com/u/<Username></code> | Link auf Übersichtsseite eine Benutzers |
+| <code>https://hub.docker.com/r/<Username>/<Repository></code> | 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:
+<code>https://hub.docker.com/r/<Username> => https://hub.docker.com/u/<Username></code>
+Daraus lässt sich der folgende shortcut ableiten:
+<code>dockerhub   https://hub.docker.com/r/{NAME}</code>
+Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem [[wpde>Favicon]] von Docker abgeleitet wurde.
+**Beispiel**:
+[[dockerhub>linuxserver/dokuwiki]]
+==== GitHub ====
+[[https://github.com/|GitHub]] ist ein auf [[wpde>Git]] basierender netzbasierter Dienst zur [[wpde>Versionskontrolle]].
+GitHub hat einen sehr klar strukturierten URL-Aufbau:
+<code>https://github.com/<Username>/<Repository></code>
+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:
+<code>github     https://github.com/{NAME}</code>
+Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem [[wpde>Favicon]] von GitHub abgeleitet wurde.
+**Beispiel**:
+[[github>thoschworks]]
+==== Snapcraft ====
+[[https://snapcraft.io/|Snapscraft]] ist ein Online-Repository für [[wpde>Snappy (Paketverwaltung)|Snappy-Pakete]].
+Snapcraft hat einen sehr klar strukturierten URL-Aufbau:
+<code>https://snapcraft.io/<Paketname></code>
+Daraus lässt sich der folgende shortcut ableiten:
+<code>snapcraft       https://snapcraft.io/{NAME}</code>
+Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem [[wpde>Favicon]] von GitHub abgeleitet wurde.
+**Beispiel**:
+[[snapcraft>atom]]
+==== ubuntuusers-Wiki ====
+Das [[ubuntuusers>startseite|Wiki von ubuntuusers.de]] ist eine Sammlung von Anleitungen und Problemlösungen zum Thema //Ubuntu-Linux// auf der [[https://ubuntuusers.de|Webplattform]] von //ubuntu Deutschland e.V.//.((Aus meiner Sicht hat die Plattform //ubuntuusers.de// in letzter Zeit an Drive verloren.))
+Das ubuntuusers-Wiki hat den folgenden URL-Aufbau:
+<code>https://wiki.ubuntuusers.de/<Artikelname>/</code>
+Daraus lässt sich der folgende shortcut ableiten:
+<code>ubuntuusers     https://wiki.ubuntuusers.de/{NAME}/</code>
+Neben dem InterWiki-Link wird eine Grafik angezeigt, die aus dem [[wpde>Favicon]] von ubuntuusers.de abgeleitet wurde.
+**Beispiel**:
+[[ubuntuusers>Startseite]]
+===== Credits =====
+Diese Seite verwendet Textauszüge aus der Hilfeseite [[doku>de:interwiki|InterWiki Links]].

ThoSch:Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge