Die Layout-Variablen

Administratoren, Entwickler von Skins

< Variablen zum Entwanzen | Variablen | Die Pfad-Variablen >

Variablenersetzungen in den Skin-Vorlagen werden alle durch die Funktion FmtPageName() aus pmwiki.php durchgef�hrt. PmWiki-Variablen-Ersetzungen, auf die in den Seiten zugegriffen werden kann, werden durch die -Ersetzung aus stdmarkup.php gemanaged oder werden �bergeordnet in local/config-Dateien definiert.

$ActionSkin: Dieses Array wird benutzt, um das aktuelle Skin zu �berschreiben, wenn eine gegebene Aktion ausgef�hrt wird. Die gebr�uchlichste Nutzung ist, $ActionSkin['print']='foo' zu setzen, um das 'foo'-Skin zum Drucken einzustellen, was auch immer sonst in der $Skin-Variable eingestellt ist.
$WikiTitle: enth�lt den Wiki-Titel, so wie er in der Titelleiste des Browsers bzw. im Tab angezeigt wird.
$EnablePageTitlePriority: regelt, wie mehrfache (:title ...:)-Seiten-Direktiven gehandhabt werden.
: $EnablePageTitlePriority = 0; # PmWiki Voreinstellung, der zuletzt eingestellte Titel gewinnt (der Titel k�nnte von Include-Seiten oder vom GroupFooter ge�ndert werden).
: $EnablePageTitlePriority = 1; # der erste Titel gewinnt; wenn ein Titel in der Seite definiert wird, kann er von Include-Seiten nicht �berschrieben werden.
$EnableDiffInline: Auf 0 gesetzt, schaltet die Variable die Hervorhebung der ge�nderten W�rter in der Darstellung der Versionen einer Seite ab.
: $EnableDiffInline = 0; # Farben abschalten, reine Textunterschiede anzeigen
$HTMLStylesFmt: Ein Array von CSS-Anweisungen, die bei der Seitenausgabe in den HTML-Kopf (<head>-Teil) eingef�gt wird. Dies Array bietet einen einfachen Platz f�r Skripten, um spezifische CSS-Anweisungen hinzuzuf�gen.
$HTMLHeaderFmt: Ein Array aus HTML-Text, der in den <head>-Bereich eingef�gt wird an der Stelle, wo die Skin-Vorlage eine -Anweisung enth�lt. Dieses Array bietet einen einfachen Platz f�r Skripten, um spezifische HTML-Header-Zeilen einzuf�gen.

Sie m�chten zum Beispiel ein Logo f�r alle Seiten Ihres Wiki einrichten (ein PNG-Bildchen f�r Firefox (und andere ...), ein 'ico' f�r den Internet-Explorer)

$HTMLHeaderFmt['logo'] =
  '<link href="http://path/to/logo.png" type="image/png" rel="icon" />
  <link href="http://path/to/logo.ico" type="image/x-icon" rel="shortcut icon" />';

Noch ein Beispiel: wenn Sie eine rss-Anzeige in einigen Browsern erreichen wollen (etwa das rss-Icon in Firefox):

 
$HTMLHeaderFmt['rss'] =
  '<link rel="alternate" type="application/rss+xml" title="Rss All recent Changes" 
     href="$ScriptUrl/Site/AllRecentChanges?action=rss" />';

$HTMLFooterFmt: Wie $HTMLHeaderFmt oben, enth�lt diese Variable ein Array mit HTML-Text, der ziemlich am Ende der HTML-Seite an der Stelle eingef�gt wird, die durch die -Anweisung in der Skin-Vorlage bezeichnet ist (gew�hnlich direkt vor dem schlie�enden <body-Tag). Das wird vornehmlich durch Skripten benutzt, um eine spezifischen HTML-Ausgabe am Ende der Seitenausgabe einzuf�gen.
$MetaRobots: setzt den Wert des <meta name='robots' ... />-Tags, das PmWiki erzeugt, um den Zugriff der Suchmashinen-Roboter auf die Site zu regeln. PmWikis Voreinstellungen erlauben den Suchmaschinen nichts au�er die reinen Textseiten zu indexieren (also z. B. nicht dem Link 'Bearbeiten' zu folgen), auch die Seiten der PmWiki-WikiGruppe wird nicht in die Suchmaschine aufgenommen. Setzt man $MetaRobots explizit, so werden diese Voreinstellungen �berschrieben.

        # diese Site niemals indexieren
        $MetaRobots = 'noindex,nofollow';
        # das Robots-Tag ganz und gar deaktivieren
        $MetaRobots = '';

$MessagesFmt: Ein Array mit HTML-Text, der anstelle jedes (:messages:)-Markups angezeigt wird. Gew�hnlich wird es benutzt, um Angaben bez�glich der Bearbeiten-Seiten auszugeben.
$RecentChangesFmt: Ein Array, das das Format f�r die Auflistung der 'Aktuellen �nderungen' angibt.

Der Schl�ssel eines Arrayeintrags bezeichnet die Seite, wo �nderungen aufgezeichnet werden wie in

$RecentChangesFmt['$SiteGroup.AllRecentChanges']

Der Wert eines Arrayeintrags gibt das Format an, in dem die �nderungen aufgezeichnet werden wie in

'* [[{$Group}.{$Name}]]  . . . $CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]'

Beachten Sie die beiden aufeinanderfolgenden Leerzeichen vor den drei Punkten (. . .). Die beiden Leerzeichen trennen zwei Teile des Formats: der erste Teil �ndert sich nicht (z. B. ein Verweis auf die ge�nderte Seite, der zweite Teil �nder sich (z. B. der Autor und das Datum der �nderung). Beim Speichern einer Seite, entfernt PmWiki eine Zeile, die auf den ersten Teil passt, und f�gt eine Zeile hinzu mit dem aktuellen Format vor der ersten Zeile mit zwei Leerzeichen. Auf diese Weise bleibt jede Zeile mit zwei aufeinanderfolgenden Leerzeichen oben am Anfang auf der �nderungen-Seite.

Sie k�nnen das Folgende benutzen und anpassen, um das Format zu �ndern (f�gen Sie es in die config.php ein):

$RecentChangesFmt['$SiteGroup.AllRecentChanges'] = 
  '* [[{$Group}.{$Name}]]  . . . $CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]';
$RecentChangesFmt['$Group.RecentChanges'] =
  '* [[{$Group}/{$Name}]]  . . . $CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]';

Beachten Sie, dass sich die �nderungen an dem Format nur auf neu Geschriebenes auswirken. Mit anderen Worten m�ssen Sie eine Seite editieren, damit Ihr neues Format sichtbar wird. Beachten Sie auch, dass Sie zwei Leerzeichen zwischen dem Seitennamen und den weiteren Informationen zu dem Text stehen haben m�ssen.

Beachten Sie au�erdem, dass diese Variable weitere Nutzungen hat, wie keine �nderungen an den Seiten 'Aktuelle �nderungen' und 'Alle �nderungen' zu protokollieren, siehe PmWiki Questions.

$RecentUploadsFmt: Ein Array, das das Format f�r hochgeladene Dateien in den 'Aktuellen �nderungen' angibt. Es ist �hnlich dem $RecentChangesFmt. Wenn es aktiviert wird, werden neue hochgeladene Dateien in den 'Aktuellen �nderungen' geloggt. Voreinstellung ist inaktiv. Siehe Cookbook:RecentUploadsLog f�r weitere Informationen.
$DraftRecentChangesFmt: Ein Array mit dem Format f�r die 'Aktuellen �nderungen', wenn ein Entwurf gespeichert wird.

$RecentChangesFmt wird auf $DraftRecentChangesFmt gesetzt, wenn ein Entwurf gespeichert wird. So k�nnen Sie z. B. die Entw�rfe in einer gesonderten 'Aktuelle �nderungen an Entw�rfen'-Seite (engl.: Recent Draft Changes page) auflisten anstatt auf der 'Aktuelle �nderungen'-Seite der Gruppe:

$DraftRecentChangesFmt['$Group.RecentDraftChanges'] =
  '* [[{$Group}/{$Name}]]  . . . $CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]';
$DraftRecentChangesFmt['$Group.RecentChanges'] = '';

$RCLinesMax: Die maximale Zahl an Zeilen, die in der 'Aktuelle �nderungen'-Seite gespeichert werden. Der Standard ist 0, das bedeutet unendlich.

          $RCLinesMax = 1000;       # verwalte h�chstens 1000 aktuelle �nderungen

$PageRedirectFmt

Der Text, der angegeben wird, wenn eine Seite via (:redirect:)-Anweisung umgeleitet wurde.

$PageRedirectFmt = '<p><i>redirected from $FullName</i></p>';
$PageRedirectFmt = '';

F�r Anzeigeoptionen siehe auch die FAQ auf PageDirectives.

$WikiStyle: Ein Array, das die vordefinierten WikiStile enth�lt, die man auf einer Textseite einsetzen kann.
Siehe PmWikiDe.CustomWikiStyles
$WikiStyleApply: Ein Array, das den Geltungsbereich der Wikistile per HTML-Elementen definiert. Standardeinstellungen sind:

'item' => 'li|dt',
'list' => 'ul|ol|dl',
'div' => 'div',
'pre' => 'pre',
'img' => 'img',
'block' => 'p(?!\\sclass=)|div|ul|ol|dl|li|dt|pre|h[1-6]',
'p' => 'p(?!\\sclass=)'

Dies definiert, dass wir Wikistile ausdehnen k�nnen auf

LI-Elemente mit dem Schl�sselwort item
UL-, OL-, DL-Elenmente mit dem Schl�sselwort list
etc.

Ein Beispiel f�r die Ausdehnung des Geltungsbereiches auf ein LI-Element steht hierunter. F�r weitere Infomationen sei verwiesen auf WikiStyle scopes.

* %apply=item red%Hier ist ein rotes Listensymbol
* Dies Item enth�lt keinen Stil
* %red%Hier ist nur der Text rot, das Listensymbol aber nicht

Hier ist ein rotes Listensymbol
Dies Item enth�lt keinen Stil
Hier ist nur der Text rot, das Listensymbol aber nicht

Du kannst zus�tzliche HTML zu $WikiStyleApply hinzuf�gen(englisch), um Wikistile auf andere HTML-Elemente auszudehnen, zum Beispiel um Stile auf Tabellenzeilen oder Anker-Tags auszudehnen.

$MaxIncludes: kontrolliert die Zahl von Einf�gungen, die Seiten mit Hilfe von (:include:)- und anderen Anweisungen machen k�nnen, das wird genutzt, um endlose Rekursionen in den Griff zu bekommen. $MaxIncludes ist auf 50 gesetzt, kann aber vom Wikiadministrator auf jeden beliebigen Wert gestzt werden.

        $MaxIncludes = 50;            # Standard
        $MaxIncludes = 1000;          # erlaubt viele Einf�gungen
        $MaxIncludes = 0;             # unterbindet Einf�gungen

$Skin: listet den (die) Namen von Skins auf, die geladen werden, es sei denn, durch $ActionSkin wird das �berschrieben. Normalerweise enth�lt $Skin einen einzigen String, der den Namen eines Skinverzeichnisses enth�lt, aber es kann auch ein Array von Namen sein, wobei dann der erste gefundene Skin aus der Liste benutzt wird.
$SkinDirUrl: wird in scripts/skins.php auf die Basis-Url des Verzeichnisses des aktuellen Skins gesetzt (z. B. innerhalb des 'pub/skins/'-Verzeichnisses). Die Variable wird typischerweise innerhalb einer .tmpl-Datei eines Skins benutzt, um Zugriff auf .css-Dateien und grafische Elemente zu erhalten, die mit dem Skin verbunden sind.
$SkinLibDirs: Ein Array, das die passende Url liefert (Arrayeintrag-Wert), wenn man es mit dem Dateisystempfad zu einem Skin (oder zu einem Verzeichnis mit mehreren Skins) f�ttert (Arrayeintrag-Schl�ssel).

Der Schl�ssel ist das Verzeichnis, das die 'skin.tmpl'- und die 'skin.php'-Datei enth�lt, wie sie das PmWiki-Programm sieht.

Der Wert ist die Url (Webadresse) des Verzeichnisses, das die .css-, .gif- und andere Dateien enth�lt, die in den HTML-Kode eingebettet sind, die von PmWiki an den Browser geschickt werden. Dies Verzeichnis muss �ffentlich zug�nglich sein.

per Standard ist das Verzeichnis gesetzt auf:

$SkinLibDirs = array(
  "./pub/skins/\$Skin" => "$PubDirUrl/skins/\$Skin",
  "$FarmD/pub/skins/\$Skin" => "$FarmPubDirUrl/skins/\$Skin");

Extradetails: Wenn PmWiki nach einem Skin sucht, schaut es unter den Arrayschl�sseln nach einem Verzeichnis, das nach dem Skin benannt ist, und wenn es es findet, wird es dann die Dateien in diesem Verzeichnis und auch die Dateien unter der korrespondierenden Url (Arraywert) nutzen. Diese beiden zeigen normalerweise auf das gleiche �ffentlich zug�ngliche Verzeichnis, sie m�ssen es aber nicht.

$PageLogoUrl: ist die Url, die auf ein Logobild verweist, das die meisten Skins irgendwo auf der Wikiseite im Kopf anzeigen, (meistens oben links).
$EnablePathInfo: beeinflusst das Handling der Seiten-Urls. Wenn sie auf 1 gesetzt wird, ist die Url ...wiki.php/Main/Main, wenn sie auf 0 (Standard) gesetzt wird, ist die Url ...wiki.php?n=Main.Main.
$EnableFixedUrlRedirect: Wenn PmWiki nur einen Teil eines Seitennamen erh�lt (z. B. nur den Gruppennamen), benutzt es $EnableFixedUrlRedirect, um daraus einen vollst�ndigen Seitennamen zu machen, dann sendet es ein "redirect" an den Browser, um ihn zu veranlassen, die Seite mit dem vollst�ndigen Seitennamen aufzurufen. Setzt man $EnableFixedUrlRedirect auf 0, blockiert man diese Umleitung, so dass PmWiki im Weiteren mit dem angepassten Seitennamen statt mit dem Redirect arbeitet.
$GroupHeaderFmt: definiert die HTML-Einf�gung am oberen Rand jeder Seite. Der Standardwert ist:

        $GroupHeaderFmt = '(:include $Group.GroupHeader:)(:nl:)';

$GroupPrintHeaderFmt: definiert die HTML-Einf�gung am oberen Rand jeder Seite, wenn action=print aktiv ist. Der Standardwert ist:

        SDV($GroupPrintHeaderFmt,'(:include $Group.GroupPrintHeader:)(:nl:)');

$GroupFooterFmt: definiert die HTML-Einf�gung am unteren Rand jeder Seite. Der Standardwert ist:

        $GroupFooterFmt = '(:include $Group.GroupFooter:)(:nl:)';

$GroupPrintFooterFmt: definiert die HTML-Einf�gung am oberen Rand jeder Seite, wenn action=print aktiv ist. Der Standardwert ist:

        SDV($GroupPrintFooterFmt,'(:nl:)(:include $Group.GroupPrintFooter:)');

$PageNotFoundHeaderFmt

gibt den HTTP-Header an, der gesendet wird, wenn eine nicht existierende Seite angefordert wurde. Einige Webserver (bemerkenswerterweise Microsofts "Personal Web Sever") erfordern, dass diese Variable angepasst wird, damit sie funktioniert.

# default
$PageNotFoundHeaderFmt = 'HTTP/1.1 404 Not Found';
# return all pages as found
$PageNotFoundHeaderFmt = 'HTTP/1.1 200 Ok';

Vorsicht vor der Erwartung, es werde der Inhalt von Gruppen-(Headern|Footern) ausgegeben bei einer nicht esistierenden Seite. Standardm��ig antwortet PmWiki mit 404 (da ja die Seite nicht existiert), ungeachtet dessen, dass ein bi�chen was anzuzeigen ist. Firefox zeigt den Inhalt, wohingegen der Internet-Explorer seine eigene 404-Seite anzeigt. $PageNotFoundHeaderFmt MUSS auf die R�ckgabe von 200 eingestellt werden, damit ein erwartetes Verhalten von allen Browsern gezeigt wird.

$HTMLVSpace: $HTMLVSpace = ''; in einer localen Anpassunsdatei (z. B. local/config.php) zu setzen, verhindert die Einf�gung von abstanderzeugenden Abs�tzen () im erzeugten HTML-Kode. Um diese �nderung auf ein einziges Skin zu begrenzen, f�ge () in eine skin.php-Datei ein, stelle noch eine global $HTMLVSpace;-Anweisung voran.
$HTMLPNewline: Diese Variable erlaubt, Zeilenumbr�che als Standard zu setzen, d. h. ohne die Direktive (:linebreaks:) in die Seite oder einen Gruppenkopf (GroupHeader) einf�gen zu m�ssen. Um Zeilenumbr�che als Standard zu setzen, f�gen Sie Ihrer config.php folgende Zeile hinzu:
$HTMLPNewline = ' ';
$TableCellAttrFmt: F�r Tabellen werden die HTML-Attribute definiert, die jeder <td>- oder <th>-Zelle mitgegeben werden. Kann Referenzen enthalten auf $TableCellCount, was die Spaltennummer der aktuellen Zelle enth�lt.
$TableCellAlignFmt: F�r Tabellen, definiert die Tabellenattribute zum Ausrichten aller <td>- oder <th>-Zellen. Voreinstellung ist " align='%s'", wobei %s ersetzt wird durch 'center', 'left' oder 'right'. F�r eine g�ltigen HTML5-Ausgabe m�chten Sie dies vielleicht in der config.php-Datei �ndern in
$TableCellAlignFmt = " class='%s'";
und dann die CSS-Klassen td.center, td.left und td.right einrichten (entsprechend f�r th).
$TableRowAttrFmt: F�r Tabellen werden die HTML-Attribute definiert, die jeder <tr>-Zeile in der Ausgabe mitgegeben werden. Kann Referenzen enthalten auf $TableRowCount, der absoluten Gesamtzahl der Zeilen der Tabelle, oder $TableRowIndex, das eine fortlaufende Nummer f�r jede Zeile liefert von 1 bis $TableRowIndexMax.

        # Gib jeder Zeile eine einzigartige CSS-Klasse, 
        # basierend auf der Zeilennummer (tr1, tr2, tr3, ... )
        $TableRowAttrFmt = "class='tr\$TableRowCount'";
        # Gib den Zeilen alternierende CSS-Klassen (ti1, ti2, ti1, ti2, ti1, ... )
        $TableRowIndexMax = 2;
        $TableRowAttrFmt = "class='ti\$TableRowIndex'";

$TableRowIndexMax: Der Maximalwert f�r $TableRowIndex in Tabellen.

        # Set rows indexes as 1, 2, 3, 1, 2, 3, 1, 2, ...
        $TableRowIndexMax = 3;
        Siehe hierzu auch $TableRowAttrFmt

$EnableTableAutoValignTop: erweiterte Tabellen sind gedacht f�r das Layout und f�gen automatisch das valign='top'-Attribut ein, wenn in der Quelle kein valign-Attribut definiert ist. Wenn Sie in der config.php diese Variable auf 0 setzen, verhindern Sie diese automatische Hinzuf�gung.

        $EnableTableAutoValignTop = 0; # schalte automatisches valign='top'-Attribut ab

$FmtV['$TableCellCount']: interne Variable von PmWiki - die horizontale Spaltennummer der aktuellen Zelle. Zum Gebrauch in

$TableCellAttrFmt und $TableRowAttrFmt.

        Beispiel: $TableCellAttrFmt = 'class=col\$TableCellCount';

$FmtV['$TableRowIndex']: interne Variable von PmWiki - die Zeilenindexnummer der aktuellen Zelle, abgeleitet von $TableRowIndexMax (1,2,3,1,2,3,1,2,...)

        Example: $TableRowAttrFmt = "class='ind\$TableRowIndex'";

siehe auch Die Bearbeiten-Variablen

< Variablen zum Entwanzen | Variablen | Die Pfad-Variablen >

�bersetzung von PmWiki.LayoutVariables Originalseite auf PmWikiDe.LayoutVariables - Backlinks
Zuletzt ge�ndert:
PmWikiDe.LayoutVariables am 08.03.2015
PmWiki.LayoutVariables am 16.01.2023

2187 Buildings

22 Imminent Risk

197 High Risk

571 Watch List

73 For Sale

Special Pages

Architects:

Meta

Die Layout-Variablen