Englisch: IDB Wiki |
PmWikiDe /
Layout anpassen
Administrator
Diese Seite ist veraltet und hier für historische Zwecke (obwohl sie immernoch nützlich sein könnte) — siehe Skinvorlagen wegen einer aktuellerer Version.
Diese Seite beschreibt, wie ein WikiAdministrator das Wiki Erscheinungsbild (Layout) anpassen kann. Dies betrifft insbesondere die Kopf- und Fußbereiche. Das Layout wird über sogenannte Skins festgelegt, welche im Verzeichnis pub/skins/ gespeichert werden. Jeder Skin erhält ein Unterverzeichnis und eine Vorlagendatei (z.B. meinskin.tmpl), welche das Layout der Seitendarstellung definiert. Weiterhin werden in dieses Unterverzeichnis alle CSS-Dateien und Grafiken abgelegt, die für das Layout benötigt werden. Um dies zu verdeutlichen: PmWiki wird ausgeliefert mit einem Standard-Skin, der "pmwiki" heißt. Dieser ist folglich unter pub/skins/pmwiki gespeichert. Dieses Verzeichnis enthält eine .tmpl Datei, die definiert, wie eine Wikiseite aufgebaut werden soll. Weiterhin befinden sich dort CSS- und Grafikdateien. Wer das Layout anpassen möchte, hat grundsätzlich 3 Möglichkeiten:
Erstellen oder Verändern einer VorlageDie grundlegenden Schritte für die Anpassung eines Layouts ist das Anlegen eines eigenen Skin-Verzeichnisses unterhalb von pub/skins/, dem Anlegen einer Vorlagendatei (.tmpl) und evtl. dem hinzufügen von CSS- und Grafikdateien. In der Konfiguration muss man die Variable Im folgenden werden die einzelnen Schritte erklärt. Anpassen des "pmwiki" SkinsDer pmwiki Skin (pub/skins/pmwiki) ist Teil der PmWiki Installation. Es ist ungünstig, diesen direkt zu ändern, weil bei einem Upgrade dieser überschrieben würde. Stattdessen sollte man ihn einfach in ein neues Verzeichnis kopieren, z.B. nach pub/skins/xyzskin. Nachdem dies gemacht ist, kann man in diesem Verzeichnis die .tmpl anpassen. Nachdem dies erledigt ist, setzt man in der zentralen Konfigurations-Datei local/config.php die Variable Skin Vorlagen DateiEine Vorlagen-Datei (Template mit .tmpl-Endung) ist eine HTML-Datei, die zusätzlich Variablen bzw. Platzhalter enthält. Wenn PmWiki eine Seite zum Browser ausliefert, werden diese Platzhalter durch konkrete Inhalte ersetzt, z.B. den Seiteninhalt. Die Platzhalter werden als HTML-Kommentar eingebettet. Die Direktive In der ganzen Vorlagen-Datei werden Variablen wie $PageUrl, Einige weitere oft verwendeten Variablen sind: Es gibt weitere Direktiven, womit Inhalte anderer Seiten aufgenommen werden können oder externe Dateien eingefügt werden. Auch
können diverse PHP Funktionen aufgerufen werden. Die Direktive Variablen-Substitution funktioniert ebenfalls in Direktiven, so dass << | Dokumentationsindex | >>
Originalseite auf PmWikiDe.LayoutBasics - Rückverweise |