WackoWiki: Layouts

https://wackowiki.org/doc     Version: 18.06.2020 07:40
Doc[link29]/Deutsch[link28]/Layouts
Auch verfügbar in English[link1], Française[link2], Русский[link3]


1. Allgemeines über Layouts

In WackoWiki gibt es die Möglichkeit, um mit Hilfe von eigenen HTML- und CSS-Dateien das Erscheinungsbild (fast) nach Belieben zu ändern. Diese sogenannten Layouts, auch Erscheinungsbild oder Oberflächendesign genannt, befinden sich in den Unterordner theme/.

2. Was sind Themen

Darstellungsoptionen
WackoWiki erlaubt es jedem, das Aussehen komplett zu verändern, ohne den PHP-Quellcode von WackoWiki zu ändern – dies erfolgt mit den im Themen-Verzeichnis gespeicherten Dateien.

Die Themen definieren das Aussehen aller Seiten in der Installation und können durch Hinzufügen (oder Abändern) der Konfiguration installiert werden.

Die Distribution kommt mit zwei Themen: Standard – welches man in der WackoWiki Installation sehen kann und Tabs, was zum Beispiel mit installiert wird.

3. Eigene Themen erstellen

Wenn die Installation angepasst werden soll, ist es am besten, ein neues Thema zu erstellen.
Auch wenn sich dein Thema nur geringfügig von Default/Tabs unterscheidet, erstelle ein neues Thema immer durch Kopieren – dies schützt dich davor, dass deine Änderungen bei der Aktualisierung auf die nächsten Versionen des Wikis versehentlich verloren gehen.

Ein neues Thema erstellt man am besten, indem man das alte Thema in ein neues Verzeichnis kopiert und die kopierten Dateien sorgfältig bearbeitet.

3.1. Weitere Layouts

Eine Übersichtsseite aller veröffentlichten Layouts mit Bildschirmabdrücken gibt es im englischen Bereich:
-> WackoThemes[link6]
Bluenatic Theme von Robert Vaeth
Bluenatic[link7] von Robert Vaeth[link8]

3.2. Installation von neuen Layouts

Entpacke die Datei und kopiere den entpackten Ordner in das Verzeichnis: theme/.
Entferne ggf. die .htaccess Dateien aus den Unterverzeichnissen, falls keine Grafiken und kein CSS interpretiert werden)

4. Default-Layout ändern

WackoWiki R5.5 Benutzer Einstellungen Allgemein
Standardmäßig ist das default-Layout ausgewählt, das man als Gast und als angemeldeter Benutzer sieht. Das kann in der Konfiguration[link9] geändert werden.

Zudem hat jeder registrierte Benutzer die Möglichkeit, in seinen Einstellungen das Layout zu ändern. Dieses wirkt sich allerdings nur auf seine persönliche Ansicht des Wikis aus.

5. Eigenes Layout entwerfen

5.1. Unterseiten zum Entwerfen eines Layouts

5.2. Inhalt der Layoutordner

Die Dateien sind in folgender Weise aufgeteilt:

5.2.1. Die äußere Erscheinung

wird durch die .php-Dateien im Layout-Unterordner theme/neues_layout/appearance/ festgelegt, welche den Kopf und den Fuß eines Wiki-Dokuments am Ende jeder Seite beschreiben, sprich das Layout um den selbst geschriebenen Inhalt. Es kann mit der Kopf und Fußzeile eines Textverarbeitungs-Dokuments verglichen werden.

5.2.2. Die Codefragmente[link4]

In die Kopf- und Fuß-Dateien können verschiedene Codefragmente eingefügt werden. Ein solches Codefragment erstellt dann zum Beispiel das Feld zur Suche.
Auf der Unterseite sind die einzelnen zur Verfügung stehenden Fragmente aufgeführt und beschrieben.

5.2.3. CSS – Cascading Style Sheets[link5]

Die .css-Dateien befinden sich im Layout-Unterordner theme/neues_layout/css/. Diese sind von Layout zu Layout sehr unterschiedlich aufgebaut und definieren teilweise auch ganz unterschiedliche Seitenbereiche.
Beim Layout default wird in der .css-Datei vorzugsweise das Aussehen von Text und Links festgelegt. Die Formatierung wird über die verschiedenen Klassen (class="name" in der HTML Ausgabe und .name in der CSS) gesteuert.
Bei den Layouts tabs und mambo sind diese Dateien weitaus größer und komplexer, da hier nicht nur Textformatierungen, sondern auch das Aussehen von einzelnen Tabellen oder weiteren Seitenbereichen festgelegt sind.

5.2.4. Icons – die Piktogramme

im Ordner theme/neues_layout/icon/ eines jedes Layouts werden vom System benutzt, um bestimmte Informationen vereinheitlicht hervorzuheben. Man kann die standardmäßig verwendeten Piktogramme hier ansehen[link11].


Natürlich können diese Grafiken gegen eigene ersetzt werden.

5.2.5. Lang – Die Spracheinstellungen für das Design

Die Sprachdateien zu den in der Lokalisierung[link12] beschriebenen Sprachen befinden sich im Ordner lang/.
Zusätzliche neue Wortgruppen, die du in dem neuen Layout benutzen willst, müssen im Unterordner theme/neues_layout/lang/ gespeichert sein. Der Name der Datei lautet wacko.xy.lang, wobei xy für die Sprache steht:


<?
//Beispielinhalt der Datei:
$theme_translation = [
  
'TextSearchPage' => 'Seite suchen',
  
'LoginPage' => 'Anmelden',
];
?>


Aufruf im Layout:

<?php echo $this->_t('LoginPage'); ?>


5.3. WackoWiki upgraden

Wenn Du den Ratschlag befolgt hast, ein neues Layout in einem neuen Ordner zu erstellen, anstatt eines der standardmäßigen bestehenden Layouts zu überschreiben, dann werden keine größeren Komplikationen auftreten. Nach der Aktualisierung der Skripte wird Wacko mit Ihrem neuen Layout wie früher funktionieren. Es muss bei Änderungen oder Erweiterungen des CSS möglicherweise das eigene CSS um die neuen Erweiterungen ergänzt werden.

Anders sieht es aus, wenn du das eigene Layout in eines der Standard-Layouts eingefügt habt bzw. ein bestehendes Layout an deine Bedürfnisse angepasst habt. Hierfür gibt es für Windows WinMerge[link13], mit dem ein Text auf Veränderungen untersucht und ergänzt werden kann. Linux/*nix können mit den mitgelieferten Programmen z.B. emacs oder Meld das Problem lösen. Eine einfachere Möglichkeit ist, den alten Ordner mit dem neu erstellten zu ersetzen.

5.4. Erfolgreich ein neues Layout erstellt?

Wenn Du ein neues Layout erstellt hast und es auch funktioniert, dann sende das neue Layout[link14] bitte an das WackoTeam[link15]. Mit hoher Wahrscheinlichkeit wird dein Design auf diesen Seiten veröffentlicht oder zu der nächsten Version hinzugefügt. Schon im voraus Danke dafür.

6. Fragen



Referring pages:

  1. Doc/Deutsch[link19]
  2. Doc/Deutsch/Layouts/Symbole[link20]
  3. Doc/Deutsch/Versionshistorie[link21]
  4. Doc/English/Themes[link22]
  5. Doc/Français/Themes[link23]
  6. Doc/Русский/Темы[link24]
  7. Users/DaCon[link25]
  8. Users/RobertVaeth/ThemeDepot[link26]
  9. Users/TheBone[link27]

zurück zur Übersicht[link28]