Page Layout

(deutsche Übersetzung der Seite PmWiki.Page Layout, Stand 21.08.2004)

Seitenlayout

Die Seite Custom Headers and Footers gibt bereits eine kurze Einführung, wie das Layout von Seiten in PmWiki verändert werden kann. Diese Seite geht tiefer in die Details der Layoutmöglichkeiten.

Anmerkung: Diese Seite bezieht sich noch auf die in PmWiki Version 0.5 verwendete Layoutstruktur. Die folgende Beschreibung muss für Version 0.6 aktualisiert werden.

Zunächst ist es nützlich, sich die Grundstruktur eines HTML-Dokumentes zu vergegenwärtigen. Ein Skript, das ein HTML-Dokument erzeugen soll, muss im Wesentlichen die folgenden Abschnitte erzeugen:

  HTTP Headers	        Content-type:, etc.
  Dokumenttyp           <!DOCTYPE …>
  Header                <html><head>
    Titel des Dokuments   <title>…</title>
    Stylesheets           <style>…</style>
    andere Header Tags     <meta …>
  Body                  </head><body …>
  HTML Anweisungen      , text, , etc.
  Ende des Dokuments    </body></html>

Grundsätzlich kann jede der eben aufgezählten Komponenten eines von PmWiki erzeugten HTML-Dokumentes durch eine oder mehrere Konfigurationsvariablen bestimmt werden. Beispielsweise lauten die Variablen, die das Aussehen einer WikiSeite beeinflussen wie folgt:

  HTTP Headers	        Content-type:, etc.            $HTTPHeaders
  Dokumenttyp           <!DOCTYPE …>                 $HTMLDoctypeFmt
  Header                <html><head>                        “
    Titel des Dokuments   <title>…</title>           $HTMLTitleFmt
    Stylesheets           <style>…</style>           $HTMLHeaderFmt
    andere Header Tags     <meta …> <link …>             “
  Body                  </head><body …>              $HTMLBodyFmt
    Header                
, text, , etc. $PageHeaderFmt Wiki-Text “ PrintText() function Footer “ $PageFooterFmt Ende des Dokuments </body></html> $HTMLEndFmt

Wie auch $PageHeaderFmt und $Page Footer Fmt (beschrieben in Custom Headers and Footers) können die anderen ‘Fmt’-Variablen Verweise auf Dateien auf der Festplatte, benutzerdefinierte Funktionen und Wikiseiten enthalten. Beispielsweise definiert PmWiki die Variable $HTMLStartFmt so, dass sie den gesamten Inhalt des HTML-Dokumentes bis zum HTML <body>-Tag enthält:

    $HTMLStartFmt = array('headers:', &$HTML Doctype Fmt, &$HTMLTitleFmt,
    &$HTMLHeaderFmt, $HTML Body Fmt);

Schließlich gibt es für die meisten PmWiki-Operationen (Browsen, Bearbeiten, Suchen etc.) Variablen, die die gesamten Seiteninhalte definieren. Beispielsweise wird das Layout einer Seite, die mittels der normalen ‘browse’-Aktion angezeigt wird, spezifiziert durch:

  $HandleBrowseFmt = array(&$HTML Start Fmt, &$PageHeaderFmt, &$Page Title Fmt,
    "function:PrintText", &$PageFooterFmt, &$HTML End Fmt);

Diese Variable $HandleBrowseFmt beinhaltet alle HTML-Header-Komponenten, $Page Header Fmt, den Text der Wikiseite selbst, $PageFooterFmt und das Ende des HTML-Dokumentes.

« Dateien und Verzeichnisse | PmWiki.Documentation Index | Umgang mit Robots »




This page may have a more recent version on pmwiki.org: PmWiki:PageLayout, and a talk page: PmWiki:PageLayout-Talk.