Ordner und Dateien

Eine einzige Regel, und viel Freiheit.

Ein Theme ist ein Ordner in /recalbox/share/themes/.

Die einzige Regel

Dieser Ordner muss eine Datei theme.xml enthalten.

Das ist alles. theme.xml ist der Einstiegspunkt: Recalbox sucht sie in der Wurzel des Ordners, und wenn sie fehlt, existiert das Theme nicht.

Nichts anderes ist vorgeschrieben. Keine Unterordnernamen, keine Aufteilung, keine Organisation. Du kannst ein ganzes Theme in dieser einen Datei schreiben.

Aufteilen, weil es praktischer ist

Ein ernsthaftes Theme kommt schnell auf Tausende Zeilen. Man teilt es daher in mehrere XML-Dateien auf, geordnet wie man will, die theme.xml einbindet:

mon-theme/
  theme.xml            ← der einzige vorgeschriebene Name
  variables.xml
  views/
    system.xml
    detailed.xml
    menu.xml
  data/
    fonts/
    images/

Diese Namen gehören dir: Nenne sie, wie du willst. Üblich ist, in veröffentlichten Themes wie in den Exporten des Studios, sie auf Englisch zu schreiben — views/, data/, fonts/ — weil das die Sprache der Tags ist, die sie enthalten.

Der Einbindungsmechanismus wird in Das Theme aufteilen erklärt.

Die Pfade

Ein in einer Datei geschriebener Pfad ist relativ zu dieser Datei. Sobald man in Unterordner aufteilt, wird das zur Fehlerquelle.

Geh über ${root}, das immer die Wurzel des Themes bezeichnet:

<path>${root}/data/images/fond.jpg</path>   <!-- ✅ funktioniert aus jeder Datei -->
<path>../data/images/fond.jpg</path>        <!-- fragil: hängt davon ab, wo die Zeile steht -->