Crear tu primer tema

El camino a seguir — con el estudio, o a mano.

El resultado es el mismo: una carpeta de tema. Dos caminos para llegar.

Con el estudio

1. Parte de una plantilla. La página en blanco es el peor punto de partida. Una plantilla llega con sus componentes ya colocados: tú los sustituyes.
2. Elige tus resoluciones de pantalla — HD 16:9, CRT 4:3, pantalla vertical (TATE). Lo que cabe en una pantalla ancha no cabe en un televisor de tubo. Empieza por una sola, añade las demás después.
3. Coloca tus componentes: arrástralos desde la columna izquierda, ajústalos en la derecha.
4. Cambia de sistema en Opciones de la vista y mira: el error más frecuente es un tema ajustado en una sola máquina que se rompe en las demás. No todos los logotipos tienen la misma forma, ni todos los nombres la misma longitud.
5. Exporta, copia la carpeta a tu máquina, pruébalo — ver Probar el tema.

A mano

1. Parte de un tema existente. Abre uno, léelo: es la forma más rápida de entender cómo se hace. El tema oficial de Recalbox es un buen comienzo.
2. Crea la carpeta y su theme.xml — el único archivo obligatorio. Ver Carpetas y archivos.
3. Anuncia lo que cubres en la etiqueta <theme>: compatibility para los tipos de pantalla, resolutions para las resoluciones. Estos dos atributos encienden los pictogramas del gestor de temas, y anunciarlos mal es prometer lo que el tema no cumple. Ver La cabecera.
4. Escribe tus vistas, una por pantalla, y divide en varios archivos en cuanto crezca — ver El tema mínimo que funciona, luego Dividir el tema.
5. Sirve las demás pantallas con condiciones en lugar de copiarlo todo: <include if="crt">.
6. Copia la carpeta a tu máquina y pruébalo — y lee themes.log al primer componente invisible.

En ambos casos acecha el mismo error: comprobar solo en TU pantalla y TU sistema.