-
Anzeigen
- Bearbeiten
- Versionen
- Druckansicht
- Rückverweise
Seiten-Text-Variablen
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.
Definition von Seiten-Text-Variablen
Es gibt drei Wege, Seiten-Text-Variablen zu definieren:
- Verwenden Sie eine Definitionsliste - das normalen Wiki-Markup für eine Definitionsliste erzeugt eine Seiten-Text-Variable.
:Name: Crisses "{$:Name}" |
"Crisses" |
{$:Name}
(wird zu "Crisses") zugegriffen werden kann.
- Verwenden Sie einen einfachen Doppelpunkt als Trenner in einem normalen Text.
Adresse: 1313 Mockingbird Lane "{$:Adresse}" | Adresse: 1313 Mockingbird Lane "1313 Mockingbird Lane" |
{$:Adresse}
-Variable (Variablen-Markup wird zu "1313 Mockingbird Lane").
- Verwenden Sie ein verstecktes Direktiven-Form - PmWiki-Markup, das nicht auf der Seite erscheint, dennoch eine Variable definiert.
(:Land: Transylvania :) "{$:Land}" | "Transylvania " |
{$:Land}
-Variable (Variablen-Markup wird zu "Transylvania ").
Verwendung
Verwendung auf der gleichen Seite
Auf der gleichen Seite können Sie die Seiten-Text-Variable einfach durch das {$:Var}
-Format auflösen (wie oben gezeigt).
Verwendung in Headern und Footern: besondere Verweise
Wenn 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: {*$:Adresse}
in der GroupFooter- oder GroupHeader-Seite.
{*$:Land}\\ {{*$Group}/PmWiki$:Summary} | Transylvania |
Um in der Hauptseite eine Variable aus dem Header oder Footer aufzurufen, siehe unten (Verwendung anderer Seiten).
Verwendung anderer Seiten
Wenn Sie Daten aus einer anderen Seiten herausziehen wollen, verwenden Sie das {Group/PageName$:Var}
-Format.
Suburb: Khandallah (:Lake:Taupo:) :Mountain:Mt Ruapehu ->"{PageTextVariables$:Suburb}" ->"{{$FullName}$:Lake}" ->"{PmWikiDe/PageTextVariables$:Mountain}" | Suburb: Khandallah
"Khandallah"
"Taupo"
"Mt Ruapehu"
|
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 Seitenlisten
Auch Seitenlisten können auf die Seiten-Text-Variablen zugreifen:
(:pagelist group=PmWikiDe order=$:Summary count=6 fmt=#simple:) |
Und um Seitenlisten zu erzeugen ( wie die in Site.Page List Templates, Page Lists, Page List Templates, Page Variables beschriebenen), speichern Sie angepasste Seitenlisten in Site.Local Templates.
Seitenlisten können Seiten-Text-Variablen nutzen, um Seiten auszuwählen:
(:pagelist group=PmWiki $:City=Paris count=8 fmt=#simple order=-name:) |
(:pagelist group=PmWiki $:City="Addis Abeba,Paris" order=-$:Version count=8 fmt=#simple:) |
- Wenn Sie Seiten-Text-Variablen zum Auswählen oder Ordnen nutzen, setzen Sie keine geschweiften Klammern um den Variablennamen. Die geschweifte Form nimmt eine Ersetzung vor bevor das Seitenlisten-Kommando ausgewertet wird.
Prüfen auf gesetzt oder nicht
STV = Seiten-Text-Variable
=- | STV ist gesetzt (ist nicht leer), z. B. (:pagelist $:Var=- :) |
=-?* | STV ist nicht gesetzt (ist leer), d. h. nicht ein Zeichen gefolgt von 0 oder mehr Zeichen, z. B. (:pagelist $:Var=-?* :) |
=* | zeige alle Seiten, unabhängig von der Seiten-Text-Variablen (langsam) |
=-* | zeige keine Seiten, unabhängig von der Seiten-Text-Variablen (langsam) |
Tip : (:if ! equal "{$:STV}" "":)
testet, ob STV leer bzw. nicht gesetzt ist oder nicht.
(:pagelist group=PmWikiDe $:Summary=-?* count=6 fmt=#simple:) |
Verwendung von Seiten-Text-Variablen in einer Vorlage (Template)
Zeige Seiten an, sortiert nach Zielgruppen-(Audience)-Seiten-Text-Variable
>>comment<< [[#byaudience]] (:if ! equal '{=$:Audience}' '{<$:Audience}':) -<'''{=$:Audience}''': (:ifend:) [[{=$Name}]] [[#byaudienceend]] >><< (:pagelist group=PmWikiDe count=10 fmt=#byaudience order=-$:Audience:) |
Verwendung von Seiten-Text-Variablen in bedingten Textauszeichnungen
Seiten-Text-Variablen 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 (:if false:)....(:if:)
-Bedingung gesetzt wurde.
Verwendung innerhalb von Kode (nur für Entwickler)
Die Standard-PageVar($pagename,$varname)
-Function kann Seiten-Text-Variablen zurückgeben, aber denken Sie daran, Dollarzeichen und Doppelpunkt hinzuzufügen wie hier;
$var=PageVar($pagename,'$:City')
Das funktioniert, indem sie alle Seiten-(Text-)Variablen, die sie in einer Seite findet, zwischenspeichert (in $PChache) und die Verlangte zurückgibt.
Übersetzung von PmWiki.PageTextVariables
Originalseite auf PmWikiDe.PageTextVariables - Rückverweise
Zuletzt geändert:
PmWikiDe.PageTextVariables am 23.09.2013
PmWiki.PageTextVariables am 10.02.2014