Discourse è altamente personalizzabile, consentendoti di modificare quasi ogni aspetto del suo aspetto tramite temi.
Per mantenere la compatibilità con gli aggiornamenti e le nuove funzionalità di Discourse, tutti i temi richiedono una manutenzione occasionale. La frequenza della manutenzione dipende dalla complessità e dal tipo di personalizzazione. Puoi ridurre al minimo gli sforzi di manutenzione per il tuo tema seguendo queste linee guida:
- Cerca temi o componenti tema ufficiali che corrispondano alla funzionalità desiderata. Questi vengono aggiornati insieme a Discourse. Possono anche servire da esempi su come approcciare le tue personalizzazioni.
- Sostituisci il testo dell’interfaccia utilizzando la funzione admin → personalizza → testo cercando il testo specifico e aggiornandolo lì.
- Il CSS del tema è additivo, consentendoti di sovrascrivere gli stili predefiniti senza modificarli direttamente. Questo approccio migliora la manutenibilità del CSS e riduce al minimo i conflitti con gli aggiornamenti.
- Utilizza un sistema di controllo versione come Git con GitHub, GitLab o Bitbucket per tracciare le modifiche. Sebbene l’editor HTML e CSS in admin → personalizza → temi sia conveniente per piccole modifiche, i sistemi di controllo versione possono semplificare il tracciamento e la risoluzione di problemi più complessi.
- Per personalizzazioni avanzate, crea moduli indipendenti per nuove funzionalità e integrali tramite plugin outlet. Discourse utilizza Ember.js, quindi la creazione di componenti Ember è ideale. Questo metodo isola la funzionalità personalizzata, riduce la manutenzione e aiuta a evitare conflitti con gli aggiornamenti di Discourse.
Sovrascrivere il JavaScript e i template HTML predefiniti di Discourse all’interno di un tema dovrebbe essere un’ultima risorsa, poiché è più probabile che queste modifiche siano incompatibili con gli aggiornamenti di Discourse, possano essere difficili da risolvere e siano più soggette a errori che causano tempi di inattività.
Per ulteriori informazioni sull’utilizzo e sulla creazione di temi Discourse, non esitare a porre domande sulla nostra community Meta, e dai un’occhiata alle nostre guide sui temi:
- Guida per principianti all’uso dei temi Discourse
- Guida per designer ai temi Discourse
- Guida per sviluppatori ai temi Discourse
- Come abilitare la modalità sicura per risolvere problemi con temi e plugin
- Struttura di temi e componenti tema
- Crea e condividi un componente tema per font
- Come creare e condividere uno schema colore
- Come utilizzare le variabili core di Discourse nel tuo tema
- Come aggiungere impostazioni al tuo tema Discourse
- Theme Creator, crea e mostra temi senza installare Discourse!
Questo documento è controllato in versione - suggerisci modifiche su github.