Discourse è altamente personalizzabile e ti consente di modificare quasi ogni aspetto del suo aspetto tramite i temi.
Per mantenere la compatibilità con gli aggiornamenti di Discourse in corso e le nuove funzionalità, 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:
- Controlla i temi o i componenti tema ufficiali che corrispondono alla funzionalità desiderata. Questi vengono aggiornati insieme a Discourse. Possono anche servire da esempi su come affrontare le tue personalizzazioni.
- Sostituisci il testo dell’interfaccia utilizzando la funzione admin → customize → text 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 tenere traccia delle modifiche. Sebbene l’editor HTML e CSS in admin → customize → themes sia conveniente per piccole modifiche, i sistemi di controllo versione possono facilitare il tracciamento e la risoluzione di problemi di modifiche più complesse.
- Per personalizzazioni avanzate, crea moduli indipendenti per nuove funzionalità e integrali tramite plugin outlets. Discourse utilizza Ember.js, quindi la creazione di componenti Ember è l’ideale. Questo metodo isola la funzionalità personalizzata, riduce la manutenzione e aiuta a evitare conflitti con gli aggiornamenti di Discourse.
Sovrascrivere JavaScript predefinito di Discourse e i modelli HTML all’interno di un tema dovrebbe essere l’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 maggiori informazioni sull’utilizzo e la creazione di temi Discourse, non esitare a porre domande sulla nostra community Meta e a dare un’occhiata alle nostre guide di theming:
- Guida per principianti all’utilizzo dei temi Discourse
- Guida per designer ai temi Discourse
- Guida per sviluppatori ai temi Discourse
- Come abilitare la Modalità Sicura per risolvere i problemi con temi e plugin
- Struttura di temi e componenti tema
- Creare e condividere un componente tema per i 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 tramite versione - suggerisci modifiche su github.