Creare un tema

Un tema definisce il rendering pubblico di Ciarvi. Può contenere template, partial, asset e blocchi riutilizzabili.

Struttura iniziale

Un pacchetto minimo può avere questa struttura:

mio-tema/
├── theme.json
├── layouts/
│   └── base.html
├── page-templates/
│   └── default.html
├── partials/
└── assets/
    ├── css/
    └── js/

Manifest del tema

Nel file theme.json dichiara almeno nome, slug, versione e template predefiniti:

{
  "name": "Mio Tema",
  "slug": "mio-tema",
  "version": "1.0.0",
  "defaultLayout": "base",
  "defaultPageTemplate": "default"
}

I file dichiarati devono esistere realmente nel pacchetto.

Layout e contenuto

Il layout definisce il contenitore generale e il punto in cui Ciarvi inserisce la pagina. I template decidono come presentare il contenuto; le partial aiutano a non ripetere header e footer.

Installazione e collaudo

Installa il tema in un ambiente di sviluppo. Controlla pagine con e senza immagini, menu, blocchi, traduzioni, dispositivi mobili e console del browser.

Per il sistema dei temi completo, consulta gli esempi del pacchetto ufficiale della versione che stai utilizzando: manifest, regioni e blocchi evolvono insieme al core.