La balise <subset> donne un nom lisible et une aide à un groupe d'options de thème. Le groupe lui-même est créé par les balises <include> qui portent le même attribut subset ; <subset> sert uniquement à l'habiller pour l'utilisateur.
Les options ainsi déclarées apparaissent dans MENU PRINCIPAL > OPTIONS DE L'INTERFACE > THÈME, sous un en-tête portant le nom du thème.
<subset> se place à la racine du <theme>, en dehors des <view>.
<theme>
<subset subset="colorset" title="Colour set" title.fr="Jeu de couleurs"
help="Choose the colour palette of the theme."
help.fr="Choisissez la palette de couleurs du thème." />
<include name="Sombre" subset="colorset" path="./couleurs/sombre.xml" />
<include name="Clair" subset="colorset" path="./couleurs/clair.xml" />
</theme>
| Propriété | Obligatoire | Rôle |
|---|---|---|
subset |
Oui | Nom technique du groupe. Doit correspondre exactement à l'attribut subset des <include> |
title |
Non | Libellé affiché dans le menu |
help |
Non | Texte d'aide affiché sous le menu |
if |
Non | Condition de déclaration du groupe |
Le nom du groupe est libre : colorset, iconset, menu, systemview et gamelistview sont les noms historiques, mais rien n'empêche de déclarer fond, police ou ambiance.
title et help acceptent les suffixes de langue, de locale complète et de région, comme n'importe quelle propriété de thème.
<subset subset="ambiance"
title="Mood" title.fr="Ambiance" title.de="Stimmung"
help="Pick the overall mood of the theme."
help.fr="Choisissez l'ambiance générale du thème." />
Recalbox retient la première correspondance rencontrée dans le fichier. L'ordre de déclaration compte donc, et une correspondance sur la langue seule (title.de) l'emporte sur une correspondance sur la locale (title.de_CH) si elle est écrite avant. Les règles complètes sont détaillées dans la page des variables contextuelles.
Les codes de langue font 2 caractères (liste ISO 639-1), les codes de pays aussi (liste ISO 3166-2).
<subset> sans <include> correspondant ne produit aucune option dans les menus.<include> — Recalbox retombe automatiquement sur la première valeur du groupe et enregistre la correction.