Werkzeuge für Theme-Designer
Diese Seite ist für Theme-Designer, die wissen möchten, welche Werkzeuge es in Exponential und drumherum gibt und welche Einstellungen ein Entwickler für sie einschaltet. Die meisten davon sind Entwicklungseinstellungen: Sie gehören auf einen Entwicklungs- oder Vorschau-Siteaccess, nie auf die Live-Website. Jede Zeile verlinkt auf die Seite, die sie ausführlich erklärt.
Inhalt
- Sehen, welches Template was gezeichnet hat
- Die Debug-Ausgabe
- Gepackte oder ungepackte Stylesheets
- Ein Design neben dem Live-Design ausprobieren
- Werkzeuge in der Administration
- Browser-Werkzeuge
- Werkzeuge zur Qualitätsprüfung
- Welche Einstellung wohin gehört
Sehen, welches Template was gezeichnet hat
Einstellung (site.ini, [TemplateSettings]) | Was Sie sehen | Seite |
|---|---|---|
ShowTemplatePathComments=enabled | jedes ausgegebene Template in Kommentare <!-- START ... --> und <!-- STOP ... --> mit seinem Pfad gehüllt; funktioniert bei eingeschaltetem Template-Compiler | Kommentare mit Template-Pfaden |
Debug=enabled mit ShowXHTMLCode=enabled | die älteren Debug-Markierungen der Templates in der Seite | Template-Debugging |
ShowUsedTemplates=enabled (braucht die Debug-Ausgabe) | eine Tabelle aller für die Seite verwendeten Templates | Ein Design debuggen |
Die Einstellungsdatei warnt selbst, dass diese Einstellungen jeder Ausgabe Markup hinzufügen, auch E-Mails, JSON und Feeds. Verwenden Sie sie nur auf einem Entwicklungs-Siteaccess.
Die Debug-Ausgabe
[DebugSettings] DebugOutput=enabled fügt unter der Seite einen Bericht mit Fehlern, Warnungen, Zeitmessungen und, mit
der Einstellung oben, den verwendeten Templates hinzu. Er lässt sich auf bestimmte Adressen beschränken (DebugByIP mit
DebugIPList[]). Warnungen über fehlende Templates oder unbekannte Operatoren sind oft die Antwort auf "Warum erscheint
meine Änderung nicht?" (Ein Design debuggen).
Gepackte oder ungepackte Stylesheets
Im normalen Betrieb packt ezjscore die Stylesheets und Skripte einer Seite in gecachte Dateien. Während der Arbeit an
einem Design sind ungepackte Dateien im Stil-Inspektor des Browsers leichter zu lesen. Der Packer folgt standardmäßig
[TemplateSettings] DevelopmentMode und lässt sich mit [eZJSCore] Packer in ezjscore.ini ausdrücklich setzen (laut
Kommentar in den Einstellungen nimmt er enabled, disabled oder eine Stufe von 0 bis 3 an). Nach einer Änderung am
Stylesheet muss auf einer Website mit eingeschaltetem Packen die gepackte Datei erneuert werden; das erledigt ein
Entwickler mit den Deploy-Schritten (Der Packer-Cache und Deployments).
Die Namen gepackter Dateien tragen bereits die Änderungszeit; hängen Sie also nie ?v= an einen Link.
Ein Design neben dem Live-Design ausprobieren
Ein Vorschau-Siteaccess liefert dieselben Inhalte mit Ihrem Design unter einer eigenen Adresse aus, während Besucher das Live-Design behalten. Er ist der richtige Ort für Reviews (Ein Design auf einem Siteaccess in der Vorschau ansehen).
Werkzeuge in der Administration
| Werkzeug | Wo | Verwendung |
|---|---|---|
| Template-Editor | Reiter Design, Template-Editor | die Templates eines Siteaccess und ihre Overrides der Reihe nach sehen; schnelle Änderungen auf einer Testwebsite (Der Template-Editor) |
| Assistent für Design-Erweiterungen | Setup > RAD, /setup/designextension | eine vollständige Theme-Erweiterung als Ausgangspunkt erzeugen (Der Assistent für Design-Erweiterungen) |
| Layout-Editor | Layouts | Testlayouts mit jedem Ansichtstyp von Blöcken bauen (Der Layout-Editor) |
| Klassendefinitionen | Setup > Klassen | Felder für das Zuordnungsblatt ablesen |
Änderungen im Template-Editor existieren nur auf dieser Installation; ein Theme gehört in Dateien unter Versionskontrolle.
Browser-Werkzeuge
Die Entwicklerwerkzeuge des Browsers erledigen den größten Teil der visuellen Arbeit:
- den Element-Inspektor, mit sichtbaren Kommentaren mit Template-Pfaden im DOM;
- Geräteemulation bei 375 px und echten Zoom auf 200 % (Bei verschiedenen Zoomstufen testen);
- Emulation des Farbschemas (hell und dunkel) und Emulation reduzierter Bewegung;
- Emulation von Farbsehschwächen;
- das Netzwerk-Panel für Anfragen an andere Hosts und die Performance-Prüfung für LCP und CLS (Für Performance-Budgets gestalten);
- die Konsole, um Verstöße gegen die Content Security Policy zu sehen (Checkliste: CSP).
Werkzeuge zur Qualitätsprüfung
| Prüfung | Werkzeug | Seite |
|---|---|---|
| Kontrast | ein beliebiger Kontrastprüfer; die Verhältnisse im Palettenblatt notiert | Farbkontrast |
| Barrierefreiheit | der Barrierefreiheitsbaum des Browsers und ein automatischer Prüfer, dazu Tastatur und Screenreader von Hand | Checkliste: Barrierefreiheit |
| Visuelle Änderungen zwischen Releases | Bildschirmfotos hell, dunkel und gezoomt, verglichen | Visuelle Regressionsprüfungen |
| Template-Syntax | der Befehl zur Template-Prüfung, den ein Entwickler ausführt | Template-Debugging |
| Stilregeln der Administration | der Design-Test in der Testsuite | Der Test der Admin-Stilregeln |
Welche Einstellung wohin gehört
Entwicklungseinstellungen gehören in die site.ini.append.php des Entwicklungs-Siteaccess oder in einen
Einstellungs-Override der Entwicklungsinstallation, gesetzt vom Entwickler oder Administrator. Sie gehören nie in Ihre
Theme-Erweiterung, denn ein Theme, das die Debug-Ausgabe einschaltet, schaltet sie für jede Website ein, die es
installiert (Die Design-Einstellungen, die ein Theme mitliefert).
Verwandte Seiten
- Ein Design debuggen
- Lektion 1.3: Welches Template hat dieses Markup geschrieben?
- Caching für Designer
- Freie Dokumentation: Diese Seite dürfen Sie unter der GNU FDL 1.3 frei kopieren, übersetzen und verbessern.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.