Verweise

für die Liste aller Seiten

Ein zentraler Clou der Wikis ist die Einfachheit, mit der man Verweise ('hyper links') auf andere Seiten in den Text einer Seite einfügen kann. PmWiki bietet verschiedene Mechanismen zur Erzeugung solcher Verweise.

Verweise auf andere Seiten des Wikis

Um einen Verweis auf eine andere Seite zu setzen, setzen Sie einfach den Namen jener Seite in doppelte eckige Klammern – wie in [[Wiki Sandbox]] oder [[Installation]]. Aus diesen Formatierungsanweisungen erzeugt PmWiki Verweise auf die Seiten Wiki Sandbox bzw. Installation.

Dies geschieht, indem PmWiki bei Text in doppelten eckigen Klammern den ersten Buchstaben jedes Worts durch einen Großbuchstaben ersetzt, die Leer- und Sonderzeichen (wie z.B. die Tilde '~') zwischen ihnen streicht und die resultierende Zeichenkette dann als Namen der Seite verwendet, zu der der Verweis führt. Ein Verweis auf eine Seite kann also auf verschiedene Weise geschrieben werden – [[Wiki Sandbox]], [[wiki sandbox]] und [[WikiSandbox]] werden verschieden dargestellt, verweisen aber alle auf dieselbe Seite, nämlich WikiSandbox.

Mit anderen Worten: Wenn ein Verweis angelegt wird, wird das Ziel des Verweises nach obigen Kriterien erzeugt, der Text des Verweises aber exakt so angezeigt, wie er eingegeben wurde.

Einige Sites erkennen auch WikiWörter, sodass im Text auftretende WikiWörter automatisch als Verweis auf eine Seite gleichen Namens behandelt werden. Dies hängt von der Konfiguration der jeweiligen PmWiki-Installation ab und ist standardmäßig deaktiviert..

Verweise mit anderem Verweistext

Es gibt drei Wege, einen anderen Verweistext als den Seitennamen zu erhalten:

1. Verberge Namensteile. Verweisteile in Klammern () werden nicht angezeigt, wodurch [[(wiki) sandbox]] auf WikiSandbox verweist, aber als sandbox angezeigt wird. Benutzen Sie %28 und %29, wenn eine Adresse selbst Klammern enthält, http://www.example.com/linkwith%28parenthese%29.
2. Ändere den Verweistext. Sie können einen anderen Verweistext nach einem pipe-Zeichen (|) angeben wie in [[WikiSandbox | ein Spielplatz]] oder Sie benutzen einen Pfeil (->) dazu wie in [[ein Spielplatz -> WikiSandbox]], beide Verweise zeigen ein Spielplatz an.
3. Zeige den Seitentitel anstelle des Seitennamens. Die Verwendung spezieller Zeichen (etwa von Umlauten) in Seitennamen ist zwar unter PmWiki kein grundsätzliches Problem, aber bei manchen Servern kann es besser sein, keine Sonderzeichen für Seitennamen zu verwenden und sich stattdessen auf reine ASCII-Zeichen für den Seitennamen, der gleichzeitig ein Dateiname ist, zu beschränken. Jede Seite kann eine (:title <name>:)-Direktive enthalten, um den lokalisierten Titel mit Sonderzeichen zu definieren. [[SeitenName|+]] erzeugt dann einen Verweis auf SeitenName und nutzt den Titel dieser Seite als Verweistext – z. B. wird auf der Seite PmWikiFr/Sandbox mittels der Direktive (:title Bac à Sable:) ein Titel definiert, sodass der Verweis [[PmWikiFr.WikiSandbox|+]] folgendermaßen dargestellt wird: Bac à Sable?. Siehe auch $EnableLinkPlusTitlespaced.
   Seit PmWiki-Version 2.2.14 funktioniert dies auch für die technischen Seiten, die einen Eintrag in der XLPage haben, ohne die Notwendigkeit, in jene Seiten eine (:title PageTitleName:)-Direktive einzufügen (Für weitere Details siehe Localization.Localization).

Zusätzlich zu den obigen Wegen kann an den Verweis eine Nachsilbe angehängt werden, der dann Teil des Verweistextes, aber nicht des Ziels wird. So ist [[wiki sandbox]]es ein Verweis zu WikiSandbox, wird jedoch als wiki sandboxes dargestellt.
Beachten Sie, dass diese Möglichkeit erst seit der Version 2.2.90 auch mit der [[PageName|+]]-Schreibweise funktioniert.

  sandbox
  sandboxes
 wiki sandbox,
 wiki sandboxes
 Grundlagen der Bearbeitung
 Grundlagen der Bearbeitungen

Verweise mit Tooltipps

Seit Version 2.2.14 kann PmWiki Tooltipps anzeigen mit den folgenden Formaten:

externer Verweis

[[http://pmwiki.org"externer Tooltipp" | externer Verweis]], z. B. externer Verweis oder http://pmwiki.org

interner Verweis

[[Links"interner Tooltipp" | interner Verweis ]], z. B. interner Verweis oder Links

Ankerverweis

[[#name"Anker-Tooltipp"|Ankerverweis]] (since Version 2.2.48), z. B. Ankerverweis oder #name

InterMap Verweis

[[Wikipedia:Wiki"Tooltipp"| InterMap link ]], z. B. InterMap link oder Wikipedia:Wiki

Verweise auf nicht existierende Seiten

Verweise auf nicht existierende Seiten? werden speziell ausgezeichnet, um Autoren dazu zu animieren, diese Seiten zu erstellen und zu füllen. Siehe Erzeugung neuer Seiten für mehr Informationen.

Verweise auf Seiten anderer Gruppen

Verweise, wie sie oben geschrieben wurden, sind Verweise innerhalb einer Gruppe. Um einen Verweis auf eine Seite einer anderen Gruppe zu erzeugen, muss man den Gruppennamen mit angeben. Ein Verweis auf Main/WikiSandbox kann folgendermaßen geschrieben werden:

Verweisen Sie auf die Standardstartseite einer Gruppe, indem Sie den Seitennamen weglassen:

Siehe Wikigruppen für weitere Informationen über PmWiki-Gruppen.

Verweis-Abkürzungen

Verweise auf Kategorien

Kategorien sind ein Weg, um verwandte Seiten zu organisieren und zu finden. Die Idee ist, dass jede Seite, die in einen bestimmten Themenbereich fällt, einen Verweis auf eine gemeinsame Seite hat, die Verweise zu den anderen Seiten mit diesem Themenbereich enthält. Diese gemeinsamen Seiten werden automatisch in der besonderen Gruppe Category erstellt, deshalb werden diese Themenbereiche Kategorien genannt.

Das Hinzufügen einer Seite zu der Kategorie Thema ist einfach durch hinzufügen des [[!Thema]]-Markups irgendwo auf der Seite zu erreichen. Das erzeugt einen Verweis auf die Seite Category.Thema. [[!Thema]] ist also eine Art Verweis-Abkürzung auf die Seite Category.Thema. Siehe Categories für weitere Informationen.

Benutzerseiten-Verweise (Signaturen)

Ähnlich ist [[~Autor]] eine Verweis-Abkürzung auf die Seite Autor in der besonderen Gruppe Profiles. PmWiki erstellt automatisch einen Verweis diesen Typs für den aktuellen Autoren, wenn es drei Tilden (~) in einer Reihe (~~~) im Seitentext entdeckt. Der aktuelle Autor ist der Name, der in dem Autor-Feld beim Bearbeiten einer Seite erscheint. Das Hinzufügen einer vierten Tilde führt dazu, dass das aktuelle Datum und die aktuelle Uhrzeit hinzugefügt werden. Der Link erscheint dann als eine Signatur.

Wenn das Autor-Feld "Schreiberling" enthält, wird

• ~~~ durch Schreiberling? und
• ~~~~ durch Schreiberling? 26.04.2016 10:22 Uhr

ersetzt.

Referenz-Verweise

[[PageName|#]] erzeugt einenReferenz-Verweis wie unten gezeigt ^[1].

Verweise auf bestimmte Stellen einer Seite – Ankerpositionen

Um in einer Seite eine bestimmte Stelle, ein Lesezeichen, zu definieren, zu der/dem direkt gesprungen werden kann, wird [[#name]] verwendet. Dies erzeugt einen "Anker", welcher die Stelle auf der Seite eineindeutig kennzeichnet. Um an diese Stelle zu springen, können folgende Anweisungen verwendet werden:

• [[#name|Verweistext]] innerhalb der gleichen Seite, oder
• [[SeitenName#name]] oder [[SeitenName#name|Verweistext]] für eine Stelle auf einer anderen Seite.
• Die Form [[SeitenName(#name)]] ist nützlich, um den Ankertext im Link zu verbergen.

Beispielsweise ist dies ein Verweis auf den Abschnitt Intermaps weiter unten.

Hinweise:

• Der Anker selbst muss mit einem Buchstaben beginnen, nicht mit einer Ziffer,
• Ein Verweis auf einen Anker muss dem Anker in Groß- und Kleinschreibung gleichen. Der Internet Explorer mag zwar hinsichtlich der Großschreibung unempfindlich sein, aber Firefox ist es nicht. Beispielsweise ist weiter unten ein Anker namens "[[#robots]]" definiert; ein Verweis wie [[#Robots | Robots]] funktioniert im IE, nicht aber in Firefox: Robots.
• Leerzeichen sind in einem Anker nicht erlaubt:"[[#mein anker]]" funktioniert nicht, "[[#meinanker]]" schon.
• Alle Ankernamen in einer Seite müssen einzigartig sein.

Links auf Aktionen

Um auf eine bestimmte Aktion für die aktuelle Seite zu verweisen, benutzt man [[{$FullName}?action=actionname|linkname]].

Beispiele:

• [[{$FullName}?action=edit|Edit]] zum Ändern oder
• [[{$FullName}?action=diff|differences]] für die Auflistung von Versionen.

Links aus dem Wiki heraus

Verweise auf externe Websites (URLs)

Verweise auf externe Netzseiten fangen einfach mit einer Buchstabenfolge wie 'http:', 'ftp:', usw. an. So verweisen http://www.google.de/ und [[http://www.google.de/]] beide zu Google. Wie weiter oben beschrieben, kann ein Autor den Verweistext 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]].

Wenn der externe URL Klammern () enthält, lassen sich diese vor einer (Fehl-)Interpretation durch PmWiki schützen, indem man %28 für '(' und %29 für ')' verwendet.

Das Rezept Cookbook:FixURL macht es einfach, Klammern und andere Sonderzeichen in Verweisadressen zu kodieren.

Verweise auf lokale Dateien

Nicht alle Browser folgen solchen Verweisen (von einigen Internet-Explorer-Versionen wird berichtet, sie täten es). Man kann auf Dateien in lokalen Dateisystemen verweisen, indem man die dem Pfad der Dateien als Präfix 'file:///' voranstellt (zumindest für den Internet Explorer). So sind file:///S:\ProjPlan.mpp und [[Laufwerk S->file:///S:\]] beides gültige Verweise. Für Windows-Dateisysteme ist es eventuell besser, Netzwerk-Ordner (z.B. \\server1\verzeichnis\unterverzeichnis) anstelle von Laufwerkbuchstaben zu verwenden, da sich Letztere für verschiedene Nutzern unterscheiden können.

Siehe auch Cookbook:DirList.

Besonderheiten von Verweisen

Verweise als Referenzen

Verweise können auch als Referenzen spezifiziert werden, so dass das Verweis-Ziel nicht durch einen textuellen Verweistext, sondern durch eine "anonyme", numerische Referenz beschrieben wird. Die folgende Formatierungsanweisung dient dazu, fortlaufend nummerierte Referenz-Verweise innerhalb einer Wikiseite zu erzeugen:

Das Formatieren des Verweises als [[http://google.com |#]] erzeugt beim Betrachten der Seite lediglich: [2]. Beim nächsten Verweis im Referenz-Format erhöht sich die Referenz-Nummer automatisch um eins: Die Eingabe von [[http://pmwiki.com |#]] erzeugt [3] usw ...

InterMap

InterMap-Verweise werden ebenfalls unterstützt (siehe InterMap). Insbesondere kann der Path: InterMap-Eintrag zum Erzeugen relativer oder absoluter Verweise genutzt werden (z. B. Path:../../einverzeichnis/foo.html oder Path:/verzeichnis/irgendwas.gif).

Verweise, die ein neues Fenster öffnen

Um einen Verweis in einem neuen Fenster zu öffnen, wird %newwin% verwendet.

• %newwin% http://pmichaud.com %% erzeugt diesen Verweis: http://pmichaud.com
• %newwin% [[http://google.com/ | Google]] %% erzeugt diesen Verweis: Google
• %newwin% [[WikiSandbox]] %% erzeugt diesen Verweis: WikiSandbox

Alternativ kann man auch das Attribut target verwenden, um Verweise in einem neuen Fenster zu öffnen:

Verweise, denen Web-Roboter nicht folgen

Indem man einem Verweis die Anweisung %rel=nofollow% voranstellt, kann man robots und link checker veranlassen, diesem Link nicht zu folgen.

Verweise und CSS-Klasses

PmWiki vergibt automatisch bestimmte CSS-Klassen für verschiedene Typen von Verweisen. Unter anderem versetzt einen dies in die Lage, die Verweis-Typen unterschiedlich zu formatieren.

Hinweis: Diese Auflistung kann unvollständig sein.

.selflink

Ein Verweis auf die aktuelle Seite. Nützlich etwa, um in Navigationsleisten anzuzeigen, wo man sich gerade befindet.

.wikilink

Ein Verweis auf eine andere Seite innerhalb des Wikis.

.urllink

Ein Verweis auf eine Seite außerhalb des Wikis.

Hinweise

Hinweis: Das Standardverhalten von "+" (siehe oben) kann derart modifiziert werden, dass nicht einfach nur der Titel der Seite angezeigt wird, sondern auch alle Leerzeichen im Titel beachtet werden ("spaced title"). Dazu fügt man Folgendes zu 'config.php' hinzu:

## [[target |+]] title links
Markup('[[|+', '<[[|',
  "/(?>\\[\\[([^|\\]]+))\\|\\s*\\+\\s*]]/e",
  "Keep(MakeLink(\$pagename, PSS('$1'),
                 PageVar(MakePageName(\$pagename,PSS('$1')), '\$Titlespaced')
                ),'L')");

FAQ

[[http://example.com/ | WikiWort]]
[[WikiWort -> http://example.com/]]

für die Liste aller Seiten