Dein erstes Theme erstellen

Der Weg — mit dem Studio, oder von Hand.

Das Ergebnis ist dasselbe: ein Theme-Ordner. Zwei Wege führen dorthin.

Mit dem Studio

1. Starte von einer Vorlage. Die leere Seite ist der schlechteste Anfang. Eine Vorlage kommt mit fertig platzierten Komponenten: Du ersetzt sie.
2. Wähle deine Bildschirmauflösungen — HD 16:9, CRT 4:3, vertikaler Bildschirm (TATE). Was auf einen Breitbildschirm passt, passt nicht auf einen Röhrenfernseher. Beginne mit einer, ergänze die anderen später.
3. Platziere deine Komponenten: Ziehe sie aus der linken Spalte, stelle sie in der rechten ein.
4. Wechsle das System in Ansichtsoptionen und schau hin: Der häufigste Fehler ist ein Theme, das auf einer einzigen Maschine eingestellt wurde und überall sonst zerbricht. Nicht alle Logos haben dieselbe Form, nicht alle Namen dieselbe Länge.
5. Exportiere, kopiere den Ordner auf deine Maschine, probiere es aus — siehe Das Theme ausprobieren.

Von Hand

1. Starte von einem bestehenden Theme. Öffne eines, lies es: Das ist der schnellste Weg zu verstehen, wie es gemacht wird. Das offizielle Recalbox-Theme ist ein guter Anfang.
2. Lege den Ordner und sein theme.xml an — die einzige Pflichtdatei. Siehe Ordner und Dateien.
3. Kündige an, was du abdeckst, im <theme>-Tag: compatibility für die Bildschirmtypen, resolutions für die Auflösungen. Diese beiden Attribute schalten die Piktogramme des Theme-Managers ein — sie falsch anzugeben heißt versprechen, was das Theme nicht hält. Siehe Der Kopf.
4. Schreibe deine Ansichten, eine pro Bildschirm, und teile in mehrere Dateien auf, sobald es wächst — siehe Das minimale funktionierende Theme, dann Das Theme aufteilen.
5. Bediene die anderen Bildschirme mit Bedingungen statt alles zu kopieren: <include if="crt">.
6. Kopiere den Ordner auf deine Maschine und probiere es aus — und lies themes.log bei der ersten unsichtbaren Komponente.

In beiden Fällen lauert derselbe Fehler: nur auf DEINEM Bildschirm und DEINEM System zu prüfen.