Restringi la modifica dei temi remoti

Per molto tempo, la migliore pratica è stata quella di evitare di modificare localmente i temi installati da un repository Git remoto su Discourse. Qualsiasi modifica al codice del tema o ai file caricati veniva eliminata durante l’aggiornamento del tema dal repository remoto.

Con questo commit, abbiamo rimosso la possibilità di modificare localmente un tema remoto e stiamo ora applicando questa migliore pratica in Discourse.

Cosa succede se ho un tema remoto con modifiche locali?

Al momento, nulla. Il tuo tema rimane invariato finché non lo rimuovi o non lo aggiorni dalla sorgente remota.

Come posso conservare le mie modifiche locali?

Se le tue modifiche riguardano solo il CSS:

Puoi copiare le tue modifiche CSS solo in un nuovo componente tema locale. Per farlo:

  1. Clicca su Installa
  2. Clicca su Crea nuovo
  3. Clicca sul pulsante Modifica nel pannello di destra.
  4. Copia le tue modifiche CSS nel file appropriato (common/mobile/desktop).
  5. Salva e abilita il componente del tema.
  6. Aggiorna il tuo tema remoto per sovrascrivere le modifiche locali ed evitare CSS duplicati.

Se hai modificato più del solo CSS (JS/Template):

Se desideri conservare le tue modifiche locali, consigliamo di convertire il tema in un tema locale. Per fare ciò:

  1. Apri il tema in Amministrazione > Personalizza
  2. Clicca su Esporta per scaricare il tema con le tue modifiche locali.
  3. Clicca su Installa nell’elenco dei temi, poi su Dal tuo dispositivo
  4. Carica il tema esportato, installalo e abilitalo come in precedenza.

Un’altra opzione per chi è interessato è effettuare un fork del tema remoto su GitHub, commitare le tue modifiche nel repository forkato e installare tale fork sulla tua istanza di Discourse. Questo permette di riapplicare (rebase) le tue modifiche sugli eventuali futuri aggiornamenti del repository principale, cosa che la conversione in un tema locale non offre.

Infine, assicurati di rimuovere il tema remoto per evitare duplicazioni delle modifiche e confusione in futuro.

35 Mi Piace

Ho usato questa funzione per visualizzare rapidamente le modifiche del mio tema remoto. C’è un modo per farlo ora? Non voglio fare commit di una modifica dell’altezza da qualche parte, pusharla, fare pull e aggiornare solo per scoprire che la modifica era eccessiva o insufficiente :frowning:

1 Mi Piace

Un modo consiste nell’utilizzare Discourse Theme CLI (applicazione da console per aiutarti a creare temi) per provare il componente con un nome diverso prima di inviare il commit. Un’altra opzione sarebbe un sito di sviluppo o di staging.

2 Mi Piace

Il CLI è! Fantastico! Non sapevo che esistesse una cosa del genere, questo aiuterà molto.

Grazie per il consiglio!

2 Mi Piace

È fantastico! E sarai felice di non dover più modificare da un browser web! :clinking_glasses:

4 Mi Piace