====== InterWiki Links ======

Die Ursprungsidee des InterWiki war die Schaffung eines großen, über das gesamte Internet verteilten [[wiki:wiki|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-[[wiki:pagenames|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.

[[wp>Wiki]] Link zu englischsprachigen Wikipedia, [[Meatball>TourBusStop]] Link zum MeatBall wiki TourBusStop, [[google>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 [[wiki:syndication|XML feed]] verweisen: [[this>feed.php]]

  [[this>feed.php]]

**mehr Info im InterWiki:**

  * [[MeatBall>InterWiki]] auf MeatBall
  * [[Wiki>InterWiki]] auf c2.com Wiki

===== Konfiguration von InterWiki Shortcuts =====

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 16x16 Pixel sowie als PNG- oder GIF-Datei  vorliegen. Du solltest das Cache leeren, falls Du wieder die Standardgrafik statt deines Icons verwenden möchtest.  

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

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 [[phpfn>rawurlencode|URL-encoded]] wikiname will be appended to the URL. FIXME 

Folgende Platzhalter stehen zur Verfügung:

^ Platzhalter ^ wird ersetzt durch  FIXME^
| {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''.