Budo-Lexikon | PmWikiDe / Skins (Layout Vorlagen)

Administratoren (Grundlagen) (deutsche Übersetzung der Seite PmWiki.Skins, Stand 2007-09-22)

Inhalt

Was ist ein Skin ?
Wo bekomme ich Skins ?
Wie wird ein Skin benutzt ?
Wie wird ein Skin gemacht ?

Was ist ein Skin ?

Ein Skin ändert das Layout Ihrer Wiki-Installation: Dies können Sie mit Hilfe der folgenden Links ausprobieren: Es wird immer die gleiche Pm Wiki-Seite ("Pm Wiki.Skins") in den verschiedenen Layouts in einem separaten Fenster angezeigt.

Wie gesehen wird immer der gleiche Seiteninhalt mit veränderten Seitenelementen (etwa sidebar, header und footer) angezeigt. Verschiedene Skins zeigen die sidebar rechts, gar nicht oder links an. Manche Skins haben bestimmte action links und features die andere Skins nicht haben, insbesondere wenn sie für die Funktionen bestimmter Kochbuch-Rezepte konzipiert wurden.

Ein Skin ist also ein Set von Dateien, in denen festgelegt wird WIE Seiten eines Pm Wiki angezeigt werden. Normalerweise sind diese Dateien im Verzeichnis pub/skins/ einer Installation abgelegt. Jede Skin wird typischerweise durch eine oder mehrere der folgenden Datei-Typen definiert:

Eine Template Datei wie z.B. skin.tmpl oder gemini.tmpl. Ein Template ist in HTML oder XHTML geschrieben und bildet das Skelett einer Skin. Es enthält spezielle Marker, die Pm Wiki anzeigen, wo die Seiteninhalte dargestellt werden sollen.
CSS Dateien, die das Aussehen einer Skin kontrollieren.
Image Dateien, die als Hintergrund oder Dekoration einer Seiten dienen. Gebräuchliche image Dateiformate sind .jpg, .png, und .gif.
PHP Dateien, wie etwa skin.php. Diese ermöglichen über die Fähigkeiten von HTML and CSS hinausgehende Anpassungen einer Skin.
Dokumentationsdateien, wie etwa readme.txt oder skinname.txt, die z.B. spezielle Installationsschritte oder Anpassungsmöglichkeiten für Administratoren erlautern. Zur Funktion eines Skin sind diese aber nicht notwendig./

Wo bekomme ich Skins?

Skins sind in der Cookbook:Skins Kollektion erhältlich. Die dort aufgeführten Skins wurden von anderen Pm Wiki Administratoren für andere zur Verfügung gestellt und haben typischerweise ihr eigenes Set von Anpassungsmöglichkeiten. Folgen Sie dem Download-Link eines Skin Pakets.

Wie verwende oder installiere ich ein Skin?

Die meisten Skin Pakete liegen als .zip, .tgz, oder .tar.gz Dateien vor. Diese sollten mit gängiger Archiv-Software zu entpacken sein..

Entpacken Sie die Dateien nach pub/skins/ Ihres Pm Wiki-Verzeichnisses. Die meisten sorgfältig hergestellten Skin-Pakete sollten Sie in ein Unterverzeichnis mit dem Skin-Namen pub/skins/ entpacken.
- Falls kein eigenes Verzeichnis erstellt werden sollte, erstellen Sie eines und verschieben Sie die Skin-Dateien hinein.
Öffnen Sie die Datei local/config.php und fügen Sie folgende Zeile ein:

$Skin = 'my-favourite-skin';

wobei 'my-favourite-skin' der Name des Ordners mit dem gewählten Skin ist.

Nach einem Neuladen der Seite im Browser sollte die Veränderung zu sehen sein.

Lediglich bei einigen Proxy's (Zwischenspeicher für Internetinhalte) kann es aufgrund der eingestellten Aktualiseirungszeit geraume Zeit dauern, bis die Veränderung sichtbar wird. In diesem Falle ist der Proxy im Browser zu deaktivieren, was bei Arbeiten an Seiten im Internet generell zu empfehlen ist.

If you'd like to let your site's visitors choose one skin from a selection of skins you've installed, look at the Cookbook:SkinChange recipe. (That's what we used for the demo above.)

There are a number of ways to further customize the appearance of a skin, including adding statements to /local/config.php that are compatible with your chosen skin; adding css files to /pub/css/, such as local.css (for your entire wiki) and My Group ?.css (for My Group ?); and directly editing the skin's files. If the skin is updated regularly, you probably will want to avoid editing the files in the skin's folder. Check the skin's page in the Cookbook for specific suggestions.

<< Individuelle Einstellungen pro Gruppe | Dokumentationsindex | Web-Feeds >>