Restreindre la modification des thèmes distants

Depuis un certain temps, la meilleure pratique consiste à éviter de modifier localement les thèmes installés à partir d’un dépôt Git distant sur Discourse. Toute modification apportée au code du thème ou aux fichiers téléversés est effacée lors de la mise à jour du thème depuis le dépôt distant.

Dans ce commit, nous avons supprimé la possibilité de modifier localement un thème distant et nous appliquons désormais cette meilleure pratique dans Discourse.

Que se passe-t-il si j’ai un thème distant avec des modifications locales ?

Rien pour le moment. Votre thème reste tel quel jusqu’à ce que vous le supprimiez ou le mettiez à jour depuis le dépôt distant.

Comment conserver mes modifications locales ?

Si vos modifications concernent uniquement le CSS :

Vous pouvez copier vos modifications CSS uniquement vers un nouveau composant de thème local. Pour ce faire :

1. Cliquez sur Installer
2. Cliquez sur Créer nouveau
3. Cliquez sur le bouton Modifier dans le volet de droite.
4. Copiez vos modifications CSS dans le fichier approprié (commun/mobile/bureau).
5. Enregistrez et activez le composant de thème.
6. Mettez à jour votre thème distant pour écraser les modifications locales et éviter les duplications CSS.

Si vous avez modifié autre chose que le CSS (JS/Modèles) :

Nous recommandons, si vous souhaitez conserver vos modifications locales, de transformer le thème en thème local. Pour ce faire :

1. Ouvrez le thème dans Admin > Personnaliser
2. Cliquez sur Exporter pour télécharger le thème avec vos modifications locales.
3. Cliquez sur Installer sous la liste des thèmes, puis sur Depuis votre appareil
4. Téléversez le thème exporté, installez-le et activez-le comme précédemment.

Une autre option pour ceux qui sont intéressés consiste à forker le thème distant sur GitHub, à valider vos modifications dans le dépôt forké, puis à installer ce fork sur votre instance Discourse. Cela permet de réappliquer vos modifications par rapport aux futures mises à jour du dépôt principal, ce que la conversion en thème local ne permet pas.

Enfin, assurez-vous de supprimer le thème distant pour éviter toute duplication de modifications et toute confusion à l’avenir.

J’ai utilisé cette fonctionnalité pour prévisualiser rapidement les modifications de mon thème distant. Existe-t-il un moyen de le faire maintenant ? Je ne veux pas valider un changement de hauteur quelque part, le pousser, le récupérer et le mettre à jour uniquement pour constater que le changement était trop important ou insuffisant

Une méthode consiste à utiliser Discourse Theme CLI (application console pour vous aider à créer des thèmes) afin de tester le composant avec un autre nom avant de pousser le commit. Une autre option serait un site de développement ou de préproduction.

C’est donc le CLI ! Génial ! Je ne savais pas que cela existait, cela va beaucoup m’aider.

Merci pour l’astuce !

C’est génial ! Et vous serez ravi de ne plus jamais avoir à éditer depuis un navigateur web !