Family Wiki | PmWikiDe / InterMap-Präfixe

für die Liste aller Seiten

Autoren (Fortgeschritten)

< Einbinden anderer Seiten | Dokumentations-Index | Bedingte Auszeichnung >

Mit 'InterMap' (in anderen Wikis auch InterWiki genannt) wird ein System zum Verweisen zwischen verschiedenen WikiWikiWeb-Websites bezeichnet. Es wurde ursprünglich durch UseMod:UseModWiki und Meatball:MeatballWiki entwickelt. Das Prinzip dabei ist, dass ein einzelnes Wort als Abkürzung für einen gesamten einmal definierten Pfad steht. InterMap-Verweise haben die Form MapPrefix:Seitenpfad, wobei der vorangestellte Hostname (MapPrefix) in einen Teil der Internetadresse umgewandelt wird. Diese Umwandlung beruht auf den Einträgen in den Dateien intermap.txt und localmap.txt.

Die Standarddatei intermap.txt

Die standardmäßig in PmWiki enthaltene intermap.txt (im Verzeichnis scripts/) enthält die folgenden Einträge für InterMap-Präfixe:

 PmWiki:     https://pmwiki.org/wiki/PmWiki/ 
 Cookbook:   https://pmwiki.org/wiki/Cookbook/ 
 Skins:      https://www.pmwiki.org/wiki/Skins/
 Wiki:       http://c2.com/cgi/wiki? 
 UseMod:     http://usemod.com/cgi-bin/wiki.pl? 
 Meatball:   http://usemod.com/cgi-bin/mb.pl? 
 Wikipedia:  https://en.wikipedia.com/wiki/ 
 PITS:       https://pmwiki.org/PITS/ 
 PmL10n:     https://www.pmwiki.org/wiki/Localization/
 Path:

Hinweis: Bearbeiten Sie diese Datei nie direkt siehe unten

Die Seite Site.InterMap ?

Sie können Ihre eigenen Präfixe in Ihrer lokalen Site.InterMap-Seite ? einrichten.

Damit wird "PmWiki:Variables" zu "https://pmwiki.org/wiki/PmWiki/" + "Variables" und damit zu einem Verweis auf die Seite PmWiki.Variables auf der offiziellen PmWiki-Webseite. Wikipedia:Stonehenge führt Sie auf den Wikipedia-Artikel über die berühmten Steinformationen in England.

Benutzung in Wikiseiten

Wie mit normalen Verweisen lässt sich die Syntax mit doppelten eckigen Klammern verwenden, um einen Verweistext zu definieren:

* [[Meatball:StartingPoints | Startpunkt]] drüben bei Meatball
* [[Startpunkt -> Meatball:StartingPoints]] drüben bei Meatball

Startpunkt drüben bei Meatball
Startpunkt drüben bei Meatball

Um einen Verweis auf genau den Pfad, der durch InterMap repräsentiert wird, zu erzeugen (z.B. https://en.wikipedia.com/wiki/ für Wikipedia), kann man [[Wikipedia:. | Wikipedias Startseite]] benutzen. Daraus resultiert ein Verweis auf Wikipedias Startseite. Beachten Sie den Punkt (.) hinter dem InterMap:-Teil.

In einem deutschen Wiki werden Sie eher den Eintrag https://de.wikipedia.com/wiki/ für Wikipedia benutzen. In der Seite Site.InterMap ? würden Sie bei Wiktionary, Wikivoyage etc. den Präfix en. durch de. ersetzen.

Das besondere InterMap-Präfix Path: kann für relative URLs in relativen Verweisen verwendet werden.

InterMap anpassen

Die derzeit verfügbaren InterMap-Präfixe der lokalen PmWiki-Installation werden vom Administrator über die Seite Site.InterMap ? und die Datei local/localmap.txt vordefiniert.

Ein InterMap-Eintrag hat folgendes Format:

MapPräfix: https://www.einedomain.de/teil/url/

Der InterMap-Eintrag kann in allen von PmWiki unterstützten Verweisschemata eingesetzt werden.
Sie können Ihre eigenen InterMap-Verweise erzeugen, indem Sie einen oder mehrere der folgenden Punkte ausführen:

Verändern Sie die Seite Site.InterMap ? und setzen Sie einen Eintrag wie den obigen hinein.
Erzeugen Sie eine Datei names /local/localmap.txt und setzen Sie einen Eintrag wie den obigen hinein. PmWiki liest automatisch die Präfixe ein, nachdem die Einträge aus intermap.txt geladen wurden.
In einer Wiki-Farm-Installation können Sie eine Datei namens local/farmmap.txt erzeugen und dort einen Eintrag wie den obigen einfügen. Diese Präfixe gelten dann für alle Wikis der Farm.
Versichern Sie sich, dass nach dem Doppelpunkt wenigstens ein Leerzeichen folgt.

Hinweis: Bearbeiten Sie die Datei scripts/intermap.txt nicht direkt! Wenn Sie es dennoch tun, werden Sie Ihre Anpassungen an den Einstellungen beim nächsten Upgrade von PmWiki wieder verlieren.

Variable und InterMap-Verweise

Es ist möglich, Variablen innerhalb der InterMap-Einträge zu verwenden. Das Folgende erzeugt DiesesWiki:- und DieseSeite:-Abkürzungen:

DiesesWiki:        $ScriptUrl
DieseSeite:        {$PageUrl}

Sie können auch InterMap-Präfixe erzeugen, bei denen der Text des Eintrags in der Mitte der Internetadresse eingefügt wird. Fügen Sie hierzu einfach '$1' an der Stelle ein, an der die Ersetzung stattfinden soll. Beispiel:

Jargon: http://www.catb.org/~esr/jargon/html/$1.html

Hier wird Jargon:F/feature-creep umgewandelt zu http://www.catb.org/~esr/jargon/html/F/feature-creep.html.

Tipps und Tricks

Es ist möglich, Ihre InterMap-Präfixe direkt in der Seite Site.InterMap ? zu dokumentieren. Weder wird der Extratext die Ausführungsgeschwindigkeit merklich verringern, noch wird er die Definition der Präfixe unterbrechen. Es muss aber klar sein, das jede Zeile, die mit einem Wort und einem Doppelpunkt beginnt, als Präfixdefinition angesehen wird.

Die Reihenfolge, in der die verschiedenen Quellen auf die Definitionen von Präfixen untersucht werden, wird durch die Variable $InterMapFiles kontrolliert. Gegenwärtig ist die Rangordnung (vom Höchsten zum Geringsten) wie folgt:

local/localmap.txt
$SiteGroup.InterMap
$FarmD/local/farmmap.txt
$FarmD/scripts/intermap.txt

InterMap Präfixe in einer Farm

Wenn man InterMap-Präfixe in einer Farm verwenden möchte, dann muss die Datei im local/-Verzeichnis der Farm farmmap.txt heißen und nicht localmap.txt.

FAQ

Ist die Groß/Kleinschreibung der InterMap-Namen relevant.

Ja, es ist also eAdmin: ein anderer InterMap-Verweis als EAdmin:.

Wie erreiche ich eine localmap.txt-Abbildung mit dem Effekt von Pics: Path:/somepathto/pics/?

Benutzen Sie das Folgende:

Pics: /somepathto/pics/

Wie kann ich ein InterMap in PHP definieren?

Benutzen Sie das Folgende:

      $LinkFunctions['PmWikiHome:'] = 'LinkIMap';
      $IMap['PmWikiHome:'] = 'https://pmwiki.org/wiki/$1';

Siehe auch $LinkFunctions

Wie kann ich einen Intermapverweis definieren, der sich auf Dateien des Servers 'root' bezieht?

Von der Seite https://example.org/index.php/Main/HomePage möchte ich einen relativen Verweis auf ein Verzeichnis auf der 'root'-Ebene der Site erzeugen. Der voll-qualifizierte URL ist https://example.org/commoninfo/infoaboutu.php. Ich möchte das machen, weil sich der Domainname ändern wird, was einen absoluten Verweis kaputt machen würde.

Erzeugen Sie folgendermaßen einen Intermapverweis:

   Root    /

Dann wäre Ihr relativer Link:

   Root:commoninfo/infoaboutu.php

Oder Sie benutzen den vordefinierten Präfix "Path:" wie in Path:/commoninfo/infoaboutu.php.