Crear un tema de Recalbox

49 páginas · 8 secciones
⌕
FRENESDE Mostrar todo Crear mi tema

Dividir el tema: <include>

Un tema serio no cabe en un solo archivo.

<include> carga otro archivo en ese punto exacto, como si su contenido estuviera copiado ahí.

<include>${root}/views/system.xml</include>
<include path="${root}/views/detailed.xml" />

Las dos escrituras funcionan: la ruta como contenido de la etiqueta, o como atributo path.

El orden importa

Dos componentes con el mismo nombre se sustituyen: gana el último leído. Pero « el último leído » no es « el último escrito » — dentro de un archivo, Recalbox trata primero todas sus inclusiones, y solo después sus propias vistas:

Las vistas de un archivo siempre pasan por encima de las de los archivos que incluye, aunque el <include> esté escrito más abajo. Entre dos inclusiones vecinas, en cambio, sí gana la última escrita.

base.xml fondo = azul rouge.xml fondo = rojo el fondo es ROJO leído de arriba abajo: dos componentes con el mismo nombre se reemplazan, gana el ÚLTIMO ese es todo el mecanismo de las sobrecapas — y por tanto de las opciones

Ese es todo el mecanismo de las capas — y así se construyen las opciones del tema: cada elección es un archivo cargado encima, que solo redefine lo que cambia. Ver Qué es una opción.

<include>${root}/views/base.xml</include>       <!-- pinta el fondo de azul -->
<include>${root}/options/rouge.xml</include>     <!-- lo repinta de rojo -->

Incluir bajo condición

Un <include> acepta if=, como un componente: el archivo solo se carga si la condición es verdadera.

<include if="crt">${root}/views/system-crt.xml</include>

Así se sirve una disposición distinta según la pantalla, sin duplicar todo lo demás. La lista de condiciones está en Mostrar bajo condición.