Seiten-Text-Variablen

für die Liste aller Seiten

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 haben einen Namen, der nur einfache Latin/Roman-(ASCII)-Zeichen, Ziffern, Bindestriche und Unterstriche enthält (reguläre STVs haben also keine Umlaute oder Zeichen mit Akzenten). Das ist eine Einschränkung für internationale Wikis (experimentelle Rezepte für internationale STV: Cookbook:InternationalPTVs).

Definition von Seiten-Text-Variablen

Es gibt drei Wege, Seiten-Text-Variablen zu definieren (weitere Muster (englische Beschreibung) können bei Bedarf definiert werden):

  • Verwenden Sie eine Definitionsliste - das normalen Wiki-Markup für eine Definitionsliste erzeugt eine Seiten-Text-Variable.
Beispiel einer Definitionslliste:
:Name: Crisses
"{$:Name}"
Name
Crisses

"Crisses"

Das erzeugt in der Seite eine neue Variable, auf die mit {$:Name} (wird zu "Crisses") zugegriffen werden kann.
  • Verwenden Sie einen einfachen Doppelpunkt als Trenner in einem normalen Text.
Beispiel für Doppelpunkt als Trenner:
Adresse: 1313 Mockingbird Lane

"{$:Adresse}"

Adresse: 1313 Mockingbird Lane

"1313 Mockingbird Lane"

Das erzeugt in der Seite die {$:Adresse}-Variable (Variablen-Markup wird zu "1313 Mockingbird Lane").
  • Verwenden Sie eine versteckte Direktiven-Form – ein PmWiki-Markup, das zwar nicht auf der Seite erscheint, aber dennoch eine Variable definiert.
Beispiel für eine Direktive:
(:Land: Transylvania :)
"{$:Land}"

"Transylvania "

Das erzeugt in der Seite die {$:Land}-Variable (Variablen-Markup wird zu "Transylvania ").

Standardwerte zum Leeren oder Zurücksetzen von Seitentextvariablen

Wenn eine Seitentextvariable nicht in einer Seite definiert wurde oder wenn der Besucher der Seite kein Leserecht für die Seite hat, die die Variablendefinition enthält, gibt das Markup für den Zugriff auf die Variable wie {$:Country} eine leere Zeichenkette zurück.

Ein Administrator kann einen Standardwert für solche Fälle definieren (PmWiki 2.2.121+). Das folgende Array kann in der local/config.php-Datei definiert werden:

  $DefaultUnsetPageTextVars = array(
    'SpezifischeVariable' => 'SpezifischeVariable is unset',
    '*PartialMatch*' => 'some value',
    '*' => '(unset)',
  );
  $DefaultEmptyPageTextVars = array(
    'SpezifischeVariable' => 'SpezifischeVariable is set, but empty',
    '*' => '(empty)',
  );

In dem obigen Beispiel geben die {$:SpezifischeVariable} oder die {AndereSeite$:SpezifischeVariable} einen vordefinierten Wert zurück:

  • den in $DefaultUnsetPageTextVars definierten Wert, wenn die Variable in dem Seitentext nicht definiert wurde oder wenn der Besucher der Seite kein Leserecht für AndereSeite hat,
  • den in $DefaultEmptyPageTextVars definierten Wert, wenn der Besucher Leserecht hat und die Variable definiert, aber leer, ist, z. B. (:SpezifischeVariable::) (zwischen den letzten beiden Doppelpunkten steht nichts).

Die Muster werden der Reihe nach abgeglichen und die erste Übereinstimmung bestimmt den Wert, der der Variablen zugewiesen wird. Der Stern * passt auf jede Zeichenkette. In dem obigen Beispiel gibt eine undefinierte Variable, die weder auf 'SpezifischeVariable' noch auf '*PartialMatch*' passt, den Wert '(unset)' aus.

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.

Beispiel
{*$:Land}\\
{{*$Group}/PmWiki$:Summary}

Transylvania
Startseite, Allgemeines zur Software PmWiki

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 Seiten

Wenn Sie Daten aus einer anderen Seiten herausziehen wollen, verwenden Sie das {Group/PageName$:Var}-Format.

Beispiel:
Suburb: Khandallah
(:Lake:Taupo:)
:Mountain:Mt Ruapehu

->"{PageTextVariables$:Suburb}"
->"{{$FullName}$:Lake}"
->"{PmWikiDe/PageTextVariables$:Mountain}"

Suburb: Khandallah

Mountain
Mt Ruapehu
"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:

Beispiel:
(:pagelist group=PmWikiDe order=$:Summary count=6 fmt=#singleline:)

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:

Beispiel:
(:pagelist group=PmWiki $:City=Paris count=8 fmt=#singleline order=-name:)
listet Seiten auf, die '$:City' auf 'Paris' gesetzt haben.
Beispiel: Mehrfachauswahl mit Leerzeichen
(:pagelist group=PmWiki $:City="Addis Abeba,Paris" order=-$:Version count=8 fmt=#singleline:)
'Anführungszeichen' müssen die ganze Auswahl umschließen.
  • Wenn Sie Seiten-Text-Variablen zum Auswählen oder Sortieren nutzen, setzen Sie keine geschweiften Klammern um den Variablennamen. Die geschweifte Form nimmt eine Ersetzung vor bevor das Seitenlisten-Kommando ausgewertet wird.
  • Verweisquelltext innerhalb des Inhalts einer versteckten Seiten-Text-Variablen (im Gegensatz zu den anderen Arten, STVn anzugeben), wird nicht als Verweis in der Seite verwahrt. Dadurch wird der Verweis nicht sichtbar durch die Seitenlistenoption 'link='. Wenn Sie den Verweis durch 'link=' angezeigt bekommen wollen, dürfen Sie im Quelltext keine Direktive benutzen, um die Variable anzulegen, oder setzen Sie den Verweis in die Seite und verbergen Sie ihn ggf. durch eine false-Bedingung:
    (:Linkme: [[PageToLink]]:) (:if false:){$:Linkme}(:ifend:)

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.

Z. B. ist es mit einem Seitennamen in der Form "jjjjMonat" einfacher, eine Seiten-Variable zu benutzen, die in config.php bestimmt wurde, anstelle einer Seiten-Text-Variablen:

$FmtPV['$NameToYearMonth'] = '[[PmWikiDe/Functions#PSFT|PSFT]]("[=%Y%m=]", strtotime($name))'; # siehe $FmtPV und PSFT

Benutzen Sie dann (:pagelist order=$NameToYearMonth:)

Alternativ schreiben Sie in die Wikiseite:

(:MonthNum:07:)

da der folgende Markup-Ausdruck nicht funktionieren wird:

(:MonthNum:{(ftime fmt=%m when="{$Namespaced}")}:)

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.

Beispiel: Seiten ohne eine Zusammenfassung (Summary)
(:pagelist group=PmWikiDe $:Summary=-?* count=6  fmt=#singleline:)

Verwendung von Seiten-Text-Variablen in einer Vorlage (Template)

Zeige Seiten an, sortiert nach Zielgruppen-(Audience)-Seiten-Text-Variable

Beispiel:
>>comment<<
[[#byaudience]]
(:if ! equal '{=$:Audience}' '{<$:Audience}':)
-<'''{=$:Audience}''':  
(:ifend:)
[[{=$Name}]]
[[#byaudienceend]]
>><<
(:pagelist group=PmWikiDe count=10 fmt=#byaudience order=-$:Audience:)

{=$:Audience}:

{=$Name}?

Verwendung von Seiten-Text-Variablen in bedingten Textauszeichnungen

Seiten-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 (: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. für die Liste aller Seiten


Übersetzung von PmWiki.PageTextVariables,   Originalseite auf PmWikiDe.PageTextVariables   —   Rückverweise

Zuletzt geändert:   PmWikiDe.PageTextVariablesam 27.04.2022
 PmWiki.PageTextVariablesam 26.04.2022