Skins (Layout-Vorlagen)
Administratoren (Grundlagen)
InhaltWas 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 PmWiki-Seite ("PmWiki.Skins") in den verschiedenen Layouts in einem separaten Fenster angezeigt. Wie man sieht, 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 Aktions-Verweise und Features, die andere Skins nicht haben, insbesondere wenn sie für die Funktionen bestimmter Kochbuch-Rezepte konzipiert wurden. Ein Skin ist also ein Satz von Dateien, in denen festgelegt wird wie Seiten eines PmWiki angezeigt werden. Die Skins sind als Unterverzeichnisse des pub/skins/-Verzeichnisses gespeichert. Beispielsweise würde man den Skin beispiel in dem Verzeichnis pub/skins/beispiel/ erstellen. Jedes Skin wird typischerweise durch eine oder mehrere der folgenden Datei-Typen definiert:
Wo bekomme ich Skins?Skins sind in der Cookbook:Skins-Sammlung erhältlich. Die dort aufgeführten Skins wurden von anderen PmWiki-Administratoren für alle zur Verfügung gestellt und haben typischerweise ihren eigenen Satz von Anpassungsmöglichkeiten. Folgen Sie dem Download-Link eines Skin-Pakets. Wie verwende oder installiere ich einen Skin?Die meisten Skin Pakete liegen als .zip-, .tgz-, oder .tar.gz-Dateien vor. Diese sollten mit gängiger Archiv-Software zu entpacken sein..
wobei 'my-favourite-skin' der Name des Ordners mit dem gewählten Skin ist.
Nach dem Neuladen einer Seite im Browser sollte die Veränderung zu sehen sein. Lediglich bei einigen Proxy's (Zwischenspeicher für Internetinhalte) kann es aufgrund der eingestellten Aktualisierungszeit 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. Wenn Sie den Besuchern Ihrer Site die Möglichkeit einräumen wollen, einen aus den Skins auszuwählen, die Sie installiert haben, dann sehen Sie nach in dem Cookbook:SkinChange-Rezept, wie das geht (Das ist das, was wir oben für die Demos gemacht haben). Wie kann ich einen existierenden Skin anpassen?Es gibt eine Vielzahl an Wegen, wie das Erscheinen eines Skins angepasst werden kann, einschließlich
Wenn der Skin regelmäßig aufgefrischt wird, werden Sie es vermeiden wollen, die Dateien in dem Skin-Verzeichnis zu bearbeiten- Prüfen Sie die Seite des Skins in dem Kochbuch wegen passender Vorschläge. Wenn Sie das Standard-PmWiki- oder Print-Skin ändern wollen, dass mit der PmWiki-Distribution ausgeliefert wird, sollten Sie eine Kopie der Verzeichnisse pub/skin/pmwiki/ und pub/skin/print/ mit einem neuen Namen machen und diese dann anstelle der Standardskins benutzen. Während die Namen von skin.tmpl und skin.css gewöhlich keine Rolle spielen, MUSS die optionale skin.php-Datei den gleichen Namen haben, wie der Skin. Wie erstelle ich einen Skin?Der beste Weg, Ihren eigenen Skin zu erstellen, ist, PmWikis Standardskin zu kopieren und zu verändern.
Der Grund, warum wir Ihnen empfehlen mit dem Standardskin zu beginnen ist, dass er ein ziemlich einfacher Skin ist, viel mehr als so mancher der Skins, die Sie in Cookbook:Skins finden. Der Startpunkt ist die Vorlagen-(.tmpl)-Datei, die das Grundgerüst des Layouts liefert. Innerhalb der Vorlagendatei sind eine Reihe von speziellen Platzhaltern und Direktiven, die PmWiki Platz zum Einfügen der relevanten Daten der aktuellen Seite zur Verfügung stellen. Skinvorlagen beschreibt die Formate und Direktiven in weiteren Details. Es gibt auch Skin-Leitlinien auf pmwiki.org. Es geht über den Horizont dieser Seite hinaus zu erklären, wie HTML, XHTML oder CSS geschrieben wird, aber es gibt dazu eine Menge guter Tutorials für alle drei, nicht zuletzt selfhtml.org. Aber Achtung, wenn Sie auf ein Tutorial stoßen, dass erklärt, wie man <font>- oder <blink>-Tags benutzt oder wie man eine Seite mit unsichtbaren 1-Pixel-GIFs layoutet, suchen Sie sich eine andere Seite, diese Dinge sind sein mindestens fünf Jahren überholt. Sie sollten Ihren Skin in einer Vielzahl von Browsern testen – idealerweise in so vielen wie Sie können, auf so vielen Plattformen, wie es Ihnen möglich ist — aber mindestens sollte der Internet Explorer 8, Firefox 3 und Chrome als die verbreitetsten dabei sein, weil diese unterschiedliche Fehler haben, die zu unterschiedlichen Anzeigen führen können. Zusätzlich ist ein Test auf Opera und Safari nützlich. Vergessen Sie nicht, beim Testen auch z. B. die Fenstergröße oder die Schriftgröße zu verändern. DruckskinsStandardmäßig wird Ihr neues Skin den Standard-pub/skins/print/-Skin benutzen. Um das zu überschreiben, fügen Sie das Folgende in die local/config.php ein: $ActionSkin['print'] = 'yourprintskin';
Das weist PmWiki an, 'yourprintskin' anstelle des Standards zu benutzen für '?action=print' Wetkzeuge, die Sie brauchenEs gibt gute Beispiele für alle diese Programme, die umsonst erhältlich sind. HTML- und CSS-Editoren. Es gibt zwei Typen von Editoren: graphische (WYSIWYG oder "what you see is what you get" — "Sie bekommen was Sie sehen") und Text-Editoren, mit denen man den 'Quelltext' schreibt. Graphische Editoren sind weniger einschüchternd für Anfänger, aber man lernt nicht so viel, oder man kennt seinen Kode nicht so gut wie man würde mit einem Text-Editor. Welchen Sie auch nehmen, wählen Sie einen, der Syntax-Highlightning (Syntax-Hervorhebung) für HTML und CSS beherrscht, weil Sie so Fehler eher erkennen. Außerdem sind Live-Vorschau-Features beim Entwickeln von PmWiki-Skins nicht sooo hilfreich, denn PmWiki macht Sachen, die die Live-Vorschau nicht machen kann, als da sind Ersetzen von Platzhaltern und Variablen und Einfügen von Sidebar-Inhalten. Test-Wiki. Sie wollen nicht gerade Verwüstungen an Ihrem Skin anrichten, während Besucher Ihre Site ansehen können. Eine bessere Idee ist das Aufsetzen von Test-Wikis, entweder auf Ihrem richtigen Webserver oder auf Ihrem eigenen Rechner. Linux- oder MacOS-Rechner-Eigner haben womöglich schon einen Webserver mit PHP auf Ihrem Rechner laufen, aber Windows-Benutzer haben das eher nicht. Wenn das auf Sie zutrifft, könnten Sie einen Blick auf das Rezept Cookbook:Standalone werfen, das PmWiki betreibt, ohne einen komplexen Webserver zu brauchen, oder auf Cookbook:InstallOnIIS. Eine gute Wahl ist auch http://www.apachefriends.org/de/xampp-windows.html, wo man ein komplettes, vorkonfiguriertes Paket mit Apache, MySql, PHP und Perl bekommt. Versuchen Sie ein Paket zu bekommen, das die gleichen Komponenten und Versionen hat, wie Iht Webserver, so kann am wenigsten schief gehen, wenn die Site live benutzt wird. FTP-Client zum Transfer der Dateien auf den Webserver. Wahrscheinlich haben Sie schon einen. Color-Picker. Ihr Editor könnte schon einen enthalten, oder Sie suchen sich ein selbständiges Programm. Das ist extrem hilfreich zum Erschaffen und Speichern von Farbpaletten. Siehe auchWie ändere ich den Standardnamen des Wikis in der oberen linken Ecke? Setzen Sie das Folgende in die config.php: $WikiTitle = 'My Wiki Site';
Die docs/sample-config.php-Datei enthält ein Beispiel zum Ändern des Titels. Wie kann ich PmWiki-Seiten in eine Webseite einbetten. Lassen Sie sie durch eine PHP-Seite laufen oder setzen Sie sie in einen Frame. Wie ändere ich die Font- oder Hintergrundfarbe des Hinweisblockes auf der Bearbeiten-Seite? Fügen Sie einen CSS-Stil in die pub/css/local.css-Datei ein.
Übersetzung von PmWiki.Skins
Originalseite auf PmWikiDe.Skins - Rückverweise |