Verweise

Verweise (Links)

(deutsche Übersetzung der Seite PmWiki.Links, Stand 25.3.2005)

Ein Clou der WikiWikiWebs ist die Einfachheit, mit der man Verweise auf andere Seiten setzen kann. PmWiki bietet verschiedene Mechanismen zur Erzeugung solcher Verweise an.

Verweise zu anderen Seiten

Erstens kann man einen Verweis zu einer anderen Seite setzen, indem man einfach den Namen der Seite in doppelte eckige Klammern stellt, wie in [[Wiki Sandkasten]] oder [[Installation]]. Das Ergebnis sind Verweise auf die Seiten Wiki Sandkasten bzw. Installation erzeugt.

PmWiki geht solche Verweise durch, ersetzt den ersten Buchstaben jedes Worts durch einen Großbuchstaben und streicht die Leer- und Sonderzeichen (wie z.B. die Tilde '~') zwischen ihnen und verwendet das dann als Namen der Seite, zu der der Verweis führt. Ein Verweis zu einer Seite kann also auf verschiedene Weise geschrieben werden - [[Wiki sandkasten]], [[wiki sandkasten]] und [[WikiSandkasten]] verweisen alle auf die selbe Seite, nämlich WikiSandkasten.

Mit anderen Worten, PmWiki verwendet WikiWörter für die Seitennamen, die Verweise werden aber so dargestellt, wie sie eingegeben wurden.

An einen in eckigen Doppelklammern gesetzten Verweis können auch weitere Zeichen angehängt werden. Diese werden dann zu einem Teil des Verweistextes, beeinflussen aber nicht das eigentliche Verweisziel. So bleibt etwa [[wiki sandkasten]]rand ein Verweis auf WikiSandkasten, es wird aber als wiki sandkastenrand angezeigt.

Man kann auch Teile des Seitennamens im Verweistext unterdrücken lassen. So ist [[(wiki)Sandkasten]] immer noch ein Verweis auf WikiSandkasten, es wird aber nur Sandkasten angezeigt.

Schließlich kann man den Verweistext völlig unabhängig vom Seitennamen angeben. Dafür gibt es zwei Formen: sowohl [[WikiSandkasten|Spielplatz]] als auch [[Spielplatz -> WikiSandkasten]] ergeben einen Verweis auf WikiSandkasten, der als Spielplatz angezeigt wird.

Je nach Konfiguration erkennt PmWiki auch WikiWörter. Diese werden dann auch ohne doppelte eckige Klammern als Verweise dargestellt.

Verweise auf externe Websites (URLs)

Verweise auf externe Websites fangen einfach mit einer Buchstabenfolge wie 'http:', 'ftp:', usw. an. So verlinken http://www.google.de/ und [[http://www.google.de/]] beide zu Google. Wie im vorangegangenen Beispiel kann ein Autor den Linktext genau bezeichnen, indem er vom Senkrechtstrich oder der Zeichenfolge mit dem Pfeil Gebrauch macht, zum Beispiel [[http://www.google.de/ | Google]] und [[Google -> http://www.google.de]].

InterMap-Verweise werden ebenfalls unterstützt (siehe InterMap).

Verweise auf bestimmte Stellen (Ankerpositionen) einer Seite

Mit [[#Anker]] wird eine Ankerposition auf einer Seite definiert (das entspricht der HTML-Anweise <a name='...'>). Statt "Anker" schreibt man einen selbst ausgedachten Namen für die Ankerposition; Ankernamen dürfen nicht mit einer Ziffer beginnen und können pro Seite nur für einen Anker verwendet werden.

Verweise zu einer Ankerposition sehen so aus:

[[#Anker | Text]], wenn es auf der gleichen Seite ist.
Seitenname#Anker oder [[Seitenname#Anker | Verweistext]], wenn der Anker auf einer anderen Seite ist.

Die Form Seitenname(#Anker) ist meist günstiger als Seitenname#Anker, da ein Verweis in der ersten Form ohne den Ankernamen angezeigt wird (vgl. oben).

Verweise, die ein neues Fenster öffnen

Solche Verweise sind besonders nützlich, wenn man möchte, dass das Wikifenster offen bleibt, wenn der Anwender auf den Verweis klickt.

%newwin% http://www.pmichaud.com %% erzeugt diesen Verweis: http://www.pmichaud.com
%newwin% Main.WikiSandbox %% erzeugt diesen Verweis: Main.WikiSandbox

Alternativ kann man auch das Attribut target verwenden:

    %target=_blank% Alle Verweise in diesem Absatz (wie http://www.pmichaud.com)
    öffnen ein neues Fenster. %%

Das ergibt:

Alle Verweise in diesem Absatz (wie http://www.pmichaud.com) öffnen ein neues Fenster.

Das abschließende %% bewirkt lediglich, dass die Wirkung von %newwin bzw. %target=_blank% aufgehoben wird. Markierungen mit % enden mit dem Absatzende, im Prinzip braucht man %% also nicht anzugeben, wenn im Absatz keine weiteren Verweise vorkommen.

(Details zu dieser Methode stehen in WikiStile.)

<< Erstellen neuer Seiten | PmWikiDe.DokumentationsIndex | Bilder auf WikiSeiten >>