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.

Beachten Sie eine Besonderheit für die deutschen Seiten in diesem Wiki: Die meisten Seiten, die die Handhabung des Wikis beschreiben, sind Übersetzungen der entsprechenden englischen Seiten. Weil die Verwaltung so einfachen ist, wird dabei der Originalname der Seite übernommen, bei der Anzeige wird aber statt des (englischen) Namen der Seite deren deutscher Titel angezeigt. Das wird erreicht, indem dem Namen ein |+ hintangestellt wird, z. B. ergibt [[Links|+]] den Verweis Verweise auf diese Seite (siehe unten).

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, https://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 Seitentitel>:)-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).

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. Wollen Sie die Nachsilbe anhängen, ohne dass sie Bestandteil des Linktextes wird, müssen Sie ein Nullzeichen dazwischen einfügen, [[wiki sandbox]][==]es erscheint dann so: wiki sandboxes
Beachten Sie, dass diese Möglichkeit erst seit der Version 2.2.90 auch mit der [[PageName|+]]-Schreibweise funktioniert.

*[[(wiki) sandbox]]
*[[(wiki) sandbox]]es
*[[WikiSandbox | wiki sandbox]],
*[[WikiSandbox | wiki sandbox]]es
*[[BasicEditing | +]]
*[[BasicEditing | +]]en

Verweise mit Tooltipps

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

externer Verweis

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

interner Verweis

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

Ankerverweis

[[#name"Anker-Tooltipp"|Ankerverweis]] (seit 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:

* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | Verweistext]]
* [[Main.WikiSandbox | +]]

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

* [[Main.]]
* [[Main/]]

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

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 "Author" enthält, wird

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

ersetzt.

Verweis-Abkürzungen

[[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,
• Gültige Zeichen für Ankernamen sind Buchstaben, Ziffern, Bindestrich (-), Unterstreichungszeichen (_) und der Punkt (.).
• 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.

Abschnitte

Während in HTML der Zweck der Anker ist, eine Position im Text anzuspringen, dienen sie in PmWiki auch noch einem internen Zweck: Jeder Anker erzeugt auch einen Abschnitt, denn Abschnitte sind definiert als Teil einer Seite zwischen ihrem Startanker und dem nächsten Anker.

Für weitere Details siehe Seitenabschnitte.

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 Sites fangen einfach mit einer Buchstabenfolge wie 'https:','http:', 'ftp:', usw. an. So verweisen https://www.google.de/ und [[https://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 [[https://www.google.de/ | Google]] und [[Google -> https://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:

[[https://en.wikipedia.org/wiki/Wiki_%28disambiguation%29 | link to "Wiki (disambiguation)" ]]

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

Verweise mit Sonderzeichen

Um Sonderzeichen, einschließlich Anführungszeichen, Leerzeichen, Pipes (|) und Klammern in Verweisadressen benutzen zu können, machen Sie sie mit der Schreibweise [=Verweisadresse=] unschädlich.

Verweise des Wikis auf Ressourcen der selben Website

Sie können den Path:-Präfix benutzen, um einen Verweis außerhalb des Wikis und doch in der gleichen Website hinzuzufügen.

Benutzen Sie Path:/pfad/zur/ressource mit einem einleitenden Schrägstrich für Verweise relative zur Websitewurzel wie in www.example.com/pfad/zur/ressource.

Sie können auch einen eigenen InterMap-Präfix definieren, der auf einen spezifischen Pfad verweist, und ihn als Abkürzung verwenden, zum Beispiel:

   Pictures: /assets/pictures/$1

In einer Wikiseite benutzen Sie dann Pictures:photo.jpg anstelle von Path:/assets/pictures/photo.jpg oder https://www.example.com/assets/pictures/photo.jpg

Siehe InterMap-Präfixe für weitere Informationen.

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. file:///\\server1\wurzelverzeichnis\unterverzeichnis) anstelle von Laufwerkbuchstaben zu verwenden, da sich Letztere für verschiedene Nutzer unterscheiden können. Nicht alle Browser folgen solchen Verweisen, der Internet Explorer erlaubt sie.

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 [[https://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 [[https://pmwiki.com |#]] erzeugt [3], [[#intermaps |#]] erzeugt [4] usw ...

Es sei darauf hingewiesen, dass dieses Merkmal ganz bewusst einfach gehalten wurde und nicht wie bibliografische Verweise funktioniert: dieser nachfolgende Verweis [[https://pmwiki.com |#]] erzeugt [5] und verwendet nicht die vorige Verweisdefinition wieder.

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% https://pmichaud.com %% erzeugt diesen Verweis: https://pmichaud.com
• %newwin% [[https://google.com/ | Google]] %% erzeugt diesen Verweis: Google
• %newwin% [[WikiSandbox]] %% erzeugt diesen Verweis: WikiSandbox

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

%target=_blank% Alle Verweise in diesem Absatz, wie bspw. https://www.pmichaud.com, öffnen sich in einem neuen Fenster.

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-Klassen

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.

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:

 $EnableLinkPlusTitlespaced = 1;

FAQ

%newwin% https://example.com/

* mailto:meineadresse@example.com
* [[mailto:meineadresse@example.com]]
* [[mailto:meineadresse@example.com | Schreib mir eine E-Mail!]]
* [[mailto:meineadresse@example.com?subject=Irgendein Betreff&body=Text der E-Mail | Schreib mir eine E-Mail!]]

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

(:if exists Group1.Page:)
   [[Group1.Page|Page]]
(:elseif exists Group2.Page:)
   [[Group2.Page|Page]]
(:ifend:)

für die Liste aller Seiten