|
|
|
Englisch: 20 von 75931 Zugriffen |
PmWikiDe /
Seiten-Text-Variablen
Autoren (Fortgeschrittene)
Seiten-Text-Variablen sind Stringvariablen, die in dem Wikitext einer Seite erzeugt werden. Sie werden automatisch auch anderen Seiten zugänglich gemacht, so dass sie dort verwendet werden können. Seiten-Text-Variable können nur einen Namen haben, der einfache Latin/Roman-(ASCII)-Zeichen, Ziffern, Bindestriche und Unterstriche enthält. Das ist eine Einschränkung für internationale Wikis (experimentelle Rezepte für internationale STV: Cookbook:InternationalPTVs). Definition von Seiten-Text-VariablenEs gibt drei Wege, Seiten-Text-Variablen zu definieren:
Das erzeugt in der Seite eine neue Variable, auf die mit {$:Name} (wird zu "Crisses") zugegriffen werden kann.
Das erzeugt in der Seite die {$:Adresse} -Variable (Variablen-Markup wird zu "1313 Mockingbird Lane").
Das erzeugt in der Seite die {$:Land} -Variable (Variablen-Markup wird zu "Transylvania ").
VerwendungVerwendung auf der gleichen SeiteAuf der gleichen Seite können Sie die Seiten-Text-Variable einfach durch das Verwendung in Headern und Footern: besondere VerweiseWenn Sie aus einem GroupHeader, GroupFooter, einer SideBar, etc. heraus eine Seiten-Text-Variable der Hauptseite aufrufen möchten, müssen Sie besondere Verweisinformationen einschließen.
Um ausdrücklich die Seiten-Text-Variable der dargestellten Hauptseite aufzurufen, stellen Sie dem Markup für die Seiten-Text-Variablen ein Sternchen voran:
Um in der Hauptseite eine Variable aus dem Header oder Footer aufzurufen, siehe unten (Verwendung anderer Seiten). Besondere Verweise wirken auch auf Seitenspezifische Variablen und Seitenlistenvorlagen.
Verwendung anderer SeitenWenn Sie Daten aus einer anderen Seiten herausziehen wollen, verwenden Sie das
Verwendung auf eingebundenen Seiten (included pages)Seiten-Text-Variablen werden niemals zusammen mit ihrem Quelltext eingebunden. Siehe Verwendung anderer Seiten oben, um auf Seiten-Text-Variablen aus anderen Seiten zu verweisen. Verwendung mit SeitenlistenAuch Seitenlisten können auf die Seiten-Text-Variablen zugreifen:
Und um Seitenlisten zu erzeugen ( wie die in Site.Page List Templates, Seitenlisten, Seitenlistenvorlagen, Seitenspezifische Variablen beschriebenen), speichern Sie angepasste Seitenlisten in Site.Local Templates?. Seitenlisten können Seiten-Text-Variablen nutzen, um Seiten auszuwählen:
listet Seiten auf, die '$:City' auf 'Paris' gesetzt haben.
'Anführungszeichen' müssen die ganze Auswahl umschließen.
Der Seiten-Text-Variablen-Wert ist immer der Text, der in die Seite geschrieben wurde. Der wird erst ausgewertet, wenn die Variable gedruckt/ausgegeben wird als HTML. Beim Sortieren nach einer Seiten-Text-Variablen sind all die Werte in allen Seiten die noch nicht ausgewerteten Text-Strings und die Seitenlisten-Sortierfunktion tut was sie kann damit. Sie wertet den Text an dieser Stelle nicht aus. Prüfen auf gesetzt oder nichtSTV = Seiten-Text-Variable
Tip :
Verwendung von Seiten-Text-Variablen in einer Vorlage (Template)Zeige Seiten an, sortiert nach Zielgruppen-(Audience)-Seiten-Text-Variable
Verwendung von Seiten-Text-Variablen in bedingten TextauszeichnungenSeiten-Text-Variablen (STV) werden zugewiesen/ausgewertet, bevor irgendeine bedingte Textauszeichnung ausgewertet wird. Das bedeutet effektiv, dass Sie keine STV innerhalb einer if...else-Bedingung deklarieren können; und ebenso, dass eine STV einen Wert hat, selbst wenn sie in einer Verwendung innerhalb von Kode (nur für Entwickler)Die Standard- $var=PageVar(
Das funktioniert, indem sie alle Seiten-(Text-)Variablen, die sie in einer Seite findet, zwischenspeichert (in Übersetzung von PmWiki.PageTextVariables, Originalseite auf PmWikiDe.PageTextVariables — Rückverweise
|