Der Kopf: das <theme>-Tag
Was dein Theme identifiziert — und NUR in theme.xml gehört.
<theme> ist die Wurzel jeder XML-Datei eines Themes. Aber seine Identitätsattribute haben nur in theme.xml einen Sinn: Diese Datei liest der Theme-Manager, um zu wissen, worum es geht.
Merken In
theme.xmlfüllst du sie alle aus: Ohne sie erscheint dein Theme ohne Namen, ohne Version, und der Manager weiß nicht, auf welchen Bildschirmen es funktioniert. In den anderen Dateien schreibst du ein nacktes<theme>: Sie zu wiederholen bringt nichts und kann verwirren.
Die Attribute
| Attribut | Rolle | Beispiel | Wenn es fehlt |
|---|---|---|---|
name | Name in der Theme-Liste | name="Mein Theme" | der Ordnername |
version | Version des Themes | version="1.2" | nicht angezeigt |
author | Der Autor | author="Benoît" | nicht angezeigt |
recalbox | Mindestversion von Recalbox | recalbox="10.0" | alle Versionen |
compatibility | Unterstützte Bildschirmtypen: hdmi, crt, jamma, tate | compatibility="hdmi,crt" | hdmi |
resolutions | Unterstützte Auflösungen: qvga, vga, hd, fhd | resolutions="hd,fhd" | fhd,hd |
compatibility und resolutions sind genau die Piktogramme, die der Theme-Manager zeigt: HDMI / CRT / JAMMA / TATE auf der einen Seite, SD 240p / SD+ 480p / HD 720p / FULLHD 1080p auf der anderen. Sie falsch anzugeben heißt versprechen, was das Theme nicht hält.
⚠️ Ohne sie kann dein Theme nicht veröffentlicht werden im Theme-Manager: Das offizielle Repository verlangt einen Namen, eine Version und einen Autor. Siehe Das Theme teilen.
Die zwei Fälle
In theme.xml — das vollständige Tag:
<theme name="Mein Theme" version="1.2" author="Benoît"
recalbox="10.0" compatibility="hdmi,crt" resolutions="hd,fhd">
…
</theme>In allen anderen Dateien des Themes — das nackte Tag:
<theme>
<view name="system"> … </view>
</theme>