Verweise
Autoren (Grundlagen)
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 zu anderen Seiten des WikisUm einen Verweis zu einer anderen Seite zu setzen, stellt man einfach den Namen jener Seite in doppelte eckige Klammern -- wie in 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 zu einer Seite kann also auf verschiedene Weise geschrieben werden -- Mit anderen Worten: Wenn eine Seite angelegt wird, wird das Ziel des Verweises nach obigen Kriterien erzeugt, der Text des Verweises aber exakt so angezeigt, wie er eingegeben wurde. An einen Verweis kann eine Nachsilbe angehängt werden, der Teil des Verweistextes, aber nicht des Ziels wird. So ist Um Text, der nicht dargestellt werden soll, können Klammern gesetzt werden. Schließlich kann man den Verweistext mit Hilfe eines senkrechten Striches (|) völlig unabhängig vom Seitennamen angeben. So verweist Einige Sites erkennen auch WikiWörter, wo 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. Abgekürzte VerweiseDie Verwendung spezieller Zeichen (etwa von Umlauten) in Seitennamen ist zwar unter PmWiki kein grundsätzliches Problem, aber manchmal unterscheiden sich die Zeichensätze zwischen dem Rechner, von dem aus eine Seite bearbeitet wird, und dem Rechner, der zum Lesen der Seite genutzt wird. Insbesondere mit UTF-8 kann es dann zu Problemen kommen. Insofern ist es besser, keine Sonderzeichen für Seitennamen zu verwenden und sich stattdessen ASCII-Zeichen zu beschränken. Jede Seite kann eine (:title <name>:)-Direktive enthalten um den lokalisierten Titel anstelle des Seitennamens anzuzeigen. Für diesen Fall sind die folgenden Tipps nützlich:
Verweise auf bestimmte Stellen (Ankerpositionen) einer SeiteUm in einer Seite eine Stelle zu definieren, zu der direkt gesprungen werden kann, wird
Beispielsweise ist dies ein Verweis auf den Abschnitt Intermaps weiter unten. Hinweise:
Links aus dem Wiki herausVerweise auf externe Websites (URLs)Verweise auf externe Netzseiten fangen einfach mit einer Buchstabenfolge wie 'http:', 'ftp:', usw. an. So verlinken Wenn die externe URL Klammern () enthält, lassen sich diese vor einer (Fehl-)Interpretation durch PmWiki schützen, indem man ( '(' und ) ')' verwendet. Verweise auf lokale DateienMan kann auf Dateien in lokalen Dateisystemen verweisen, indem man die dem Pfad der Dateien als Präfix Besonderheiten von VerweisenVerweise als ReferencenVerweise können auch als Referenzen spezifiziert werden, so dass das Verweis-Ziel nicht durch einen 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 InterMapInterMap-Verweise werden ebenfalls unterstützt (siehe InterMap). Insbesondere kann der Verweise zu Seiten in anderen WikigruppenSiehe Wikigruppen. Verweise, die ein neues Fenster öffnenUm einen Link in einem neuen Fenster zu öffnen wird
Alternativ kann man auch das Attribut
Verweise, denen Robots? nicht folgenIndem man einem Verweis die Anweisung %rel=nofollow% voranstellt, kann man robots und link checker veranlassen, diesem Link nicht zu folgen. Verweise und CSS-KlassesPmWiki 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.
Man könnte etwa eine Klasse Markup('[[#','<[[','/(?>\\[\\[#([A-Za-z][-.:\\w]*))\\]\\]/e', "Keep(TrackAnchors('$1') ? '' : \"<a name='$1' id='$1' class='anchor'></a>\", 'L')"); HinweiseHinweis: 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')"); << Erzeugung neuer Seiten | Dokumentationsindex | Bilder >> Wie erzeuge ich einen Verweis, der in einem neuen Browserfenster geöffnet wird? Benutze den Wikistil
Wie erzeuge ich einen Verweis, der in einem neuen Browserfenster geöffnet wird und kann gleichzeitig das Aussehen dieses neuen Fenster beeinflussen? Dazu ist Javascript erforderlich. Siehe das Kochbuch-Rezept Cookbook:PopupWindow (nur auf Englisch verfügbar). We kann ich eine E-Mail-Adresse in einee Wikiseite einfügen? Benutze die Formatierungsanweisung
Siehe auch die Kochbuch-Rezepte Cookbook:EProtect und Cookbook:ProtectEmail für ausführlichere Informationen über den Schutz von E-Mail-Adressen vor Spammern (nur auf Englisch verfügbar). Wie kann ich einen WikiWort-Verweis zu einem Verweis auf eine externe anstatt auf eine interne Seite machen? Benutze 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')? Benutze die Direktive (:pagelist link=IrgendeineSeite:) -- zeige alle Verweise auf IrgendeineSeite (:pagelist link={$FullName}:) -- zeige alle Verweise auf die aktuelle Seite Welche Verweis-Schemen (URI-Schemen) unterstützt PmWiki? Siehe die eigene Seite Link schemes (nur auf Englisch verfügbar). Wie kann ich Verweise auf anderer Internet-Protokolle -- wie etwa nntp:, ssh:, xmpp: etc. -- ermöglichen. Siehe das Kochbuch-Rezept Cookbook:Add Url schemes (nur auf Englisch verfügbar). 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).
Übersetzung von PmWiki.Links
Originalseite auf PmWikiDe.Links - Rückverweise |