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.
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..
Es gibt drei Wege, einen anderen Verweistext als den Seitennamen zu erhalten:
[[(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.
[[WikiSandbox | ein Spielplatz]] oder Sie benutzen einen Pfeil (->) dazu wie in [[ein Spielplatz -> WikiSandbox]], beide Verweise zeigen ein Spielplatz? an.
[[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.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.
|
Eingabe |
Anzeige |
[[(wiki) sandbox]] [[(wiki) sandbox]]es [[WikiSandbox | wiki sandbox]], [[WikiSandbox | wiki sandbox]]es [[BasicEditing | +]] [[BasicEditing | +]]en | sandbox? sandboxes? wiki sandbox?, wiki sandboxes? Grundlagen der Bearbeitung Grundlagen der Bearbeitungen |
Seit Version 2.2.14 kann PmWiki Tooltipps anzeigen mit den folgenden Formaten:
[[http://pmwiki.org"externer Tooltipp" | externer Verweis]], z. B. externer Verweis oder http://pmwiki.org
[[Links"interner Tooltipp" | interner Verweis ]], z. B. interner Verweis oder Links
[[#name"Anker-Tooltipp"|Ankerverweis]] (since Version 2.2.48), z. B. Ankerverweis oder #name
[[Wikipedia:Wiki"Tooltipp"| InterMap link ]], z. B. InterMap link oder Wikipedia:Wiki
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, 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:
|
Eingabe |
Anzeige |
* [[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.
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.
Ä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.
[[PageName|#]] erzeugt einenReferenz-Verweis wie unten gezeigt [1].
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.
[[SeitenName(#name)]] ist nützlich, um den Ankertext im Link zu verbergen.
Beispielsweise ist dies ein Verweis auf den Abschnitt Intermaps weiter unten.
Hinweise:
[[#robots]]" definiert; ein Verweis wie [[#Robots | Robots]] funktioniert im IE, nicht aber in Firefox: Robots.
[[#mein anker]]" funktioniert nicht, "[[#meinanker]]" schon.
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.
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.
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.
[[http://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.
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.
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-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).
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:
%target=_blank% Alle Verweise in diesem Absatz, wie bspw. http://www.pmichaud.com, öffnen sich in einem neuen Fenster. | Alle Verweise in diesem Absatz, wie bspw. http://www.pmichaud.com, öffnen sich in einem neuen Fenster. |
Indem man einem Verweis die Anweisung %rel=nofollow% voranstellt, kann man robots und link checker veranlassen, diesem Link nicht zu folgen.
%rel=nofollow$[[Ihr Verweis]]%%
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.
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')");
Wie erzeuge ich einen Verweis, der in einem neuen Browserfenster geöffnet wird?
Benutzen Sie den Wikistil %newwin% – so wie im folgenden Beispiel:
%newwin% http://example.com/ |
Wie erzeuge ich einen Verweis, der in einem neuen Browserfenster geöffnet wird, wenn ich gleichzeitig das Aussehen dieses neuen Fensters beeinflussen will?
Dazu ist Javascript erforderlich. Siehe das Kochbuch-Rezept Cookbook:PopupWindow (nur auf Englisch verfügbar).
Wie kann ich eine E-Mail-Adresse in eine Wikiseite einfügen?
Benutzen Sie die Formatierungsanweisung mailto: – so wie in den folgenden Beispielen:
* mailto:[email protected] * [[mailto:[email protected]]] * [[mailto:[email protected] | Schreib mir eine E-Mail!]] * [[mailto:[email protected]?subject=Irgendein Betreff&body=Text der E-Mail | Schreib mir eine E-Mail!]] |
Die Auszeichnung [[mailto:[email protected]?cc=[email protected]&bcc=[email protected]&subject=Pre-set Subject&body=Pre-set body | display text]] =] lässt Sie noch weitere Parameter angeben wie den Nachrichtentext und weitere Empfänger (mag sein, dass das nicht mit allen Browsern und E-Mail-Programmen funktioniert).
Siehe auch im Kochbuch-Rezept Cookbook:DeObMail nach ausführlicheren Informationen über den Schutz von E-Mail-Adressen vor Spammern (nur auf Englisch verfügbar).
Wie kann ich Verweise auf andere Protokolle wie nntp:, ssh: xmpp: usw. aktivieren?
Siehe Cookbook:Add Url schemes
Wie kann ich einen WikiWort-Verweis zu einem Verweis auf eine externe anstatt auf eine interne Seite machen?
Benutzen Sie die Formatierungsanweisungen für Verweise. Es gibt folgende zwei Möglichkeiten:
[[http://example.com/ | WikiWort]] [[WikiWort -> http://example.com/]]
Wie finde ich alle Seiten, die auf eine bestimmte Seite verweisen (sogenannte 'backlinks')?
Benutzen Sie link=Gruppe.Seite im Wiki-Suchfeld, um alle Seiten zu finden, die auf 'Gruppe.Seite' zeigen.
Benutzen Sie die Direktive (:pagelist:)-Direktive mit der Option "link=" – so wie im folgenden Beispiel:
(:pagelist link=IrgendeineSeite:) – zeige alle Verweise auf IrgendeineSeite
(:pagelist link={$FullName}:) – zeige alle Verweise auf die aktuelle Seite
Bachten Sie, dass (mit wenigen Ausnahmen) 'includes', 'conditionals', Seitenlisten, Suchergebnisse, 'wikitrails' und Umleitungen ('redirects') nicht für Wikilinks ausgewertet werden, dadurch werden Links, die diese in die Seite setzen, nicht als Backlinks gefunden. Alle anderen Direktiven und Markups, z. B. Verweise, die durch (:pmform:) in die Seite eingefügt werden, werden gefunden.
Welche Verweis-Schemen (URI-Schemen) unterstützt PmWiki?
Siehe die eigene Seite Linkschemata.
Wie öffne ich externe Verweise in einem neuen Fenster oder markiere sie mit einem Icon?
Siehe das Kochbuch-Rezept Cookbook:External links (nur auf Englisch verfügbar).
Wie kann ich ein Bild als Link benutzen?
Benutzen Sie [[Page| Attach:image.jpg ]] oder [[ http://site | http://site/image.jpg ]] Siehe Images#links
Warum folgt mein Browser keinen Verweisen auf lokale Dateien (file://)?
Aus Sicherheitsgründen folgen die meisten Browser einem Verweis auf file:// nur dann, wenn die Seite, die auf die Datei verweist, ebenfalls auf dem lokalen Laufwerk liegt. Mit anderen Worten, die meisten Browser folgen dem Verweis nicht, wenn Sie die verweisende Seite mit http:// geladen haben, wie es bei einer PmWiki-Site der Fall ist. Siehe auch Cookbook:DirList wegen eines Workarounds.
Übersetzung von PmWiki.Links, Originalseite auf PmWikiDe.Links — Backlinks
| Zuletzt geändert: | PmWikiDe.Links | am 07.10.2017 |
| PmWiki.Links | am 06.11.2019 |