Discourse est hautement personnalisable, vous permettant de modifier presque tous les aspects de son apparence grâce aux thèmes.
Pour maintenir la compatibilité avec les mises à jour continues de Discourse et les nouvelles fonctionnalités, tous les thèmes nécessitent un entretien occasionnel. La fréquence de l’entretien dépend de la complexité et du type de personnalisation. Vous pouvez minimiser les efforts de maintenance pour votre thème en suivant ces directives :
- Vérifiez les thèmes ou les composants de thème officiels qui correspondent à la fonctionnalité souhaitée. Ceux-ci sont mis à jour avec Discourse. Ils peuvent également servir d’exemples sur la manière d’aborder vos propres personnalisations.
- Remplacez le texte de l’interface utilisateur en utilisant la fonctionnalité admin → personnaliser → texte en recherchant le texte spécifique et en le mettant à jour à cet endroit.
- Le CSS du thème est additif, vous permettant de remplacer les styles par défaut sans les modifier directement. Cette approche améliore la maintenabilité du CSS et minimise les conflits avec les mises à jour.
- Utilisez un système de contrôle de version comme Git avec GitHub, GitLab ou Bitbucket pour suivre les modifications. Bien que l’éditeur HTML et CSS dans admin → personnaliser → thèmes soit pratique pour les ajustements mineurs, les systèmes de contrôle de version peuvent faciliter le suivi et le dépannage des modifications plus complexes.
- Pour les personnalisations avancées, créez des modules indépendants pour les nouvelles fonctionnalités et intégrez-les via les connecteurs de sortie de plugin (plugin outlets). Discourse utilise Ember.js, donc la construction de composants Ember est idéale. Cette méthode isole la fonctionnalité personnalisée, réduit la maintenance et aide à éviter les conflits avec les mises à jour de Discourse.
Remplacer le JavaScript et les modèles HTML par défaut de Discourse dans un thème doit être un dernier recours, car ces modifications sont plus susceptibles d’être incompatibles avec les mises à jour de Discourse, peuvent être difficiles à dépanner et sont plus sujettes aux erreurs entraînant des temps d’arrêt.
Pour plus d’informations sur l’utilisation et la création de thèmes Discourse, n’hésitez pas à poser des questions sur notre communauté Meta et à consulter nos guides de thémisation :
- Guide du débutant pour l’utilisation des thèmes Discourse
- Guide du concepteur pour les thèmes Discourse
- Guide du développeur pour les thèmes Discourse
- Comment activer le mode sans échec pour dépanner les problèmes liés aux thèmes et aux plugins
- Structure des thèmes et des composants de thème
- Créer et partager un composant de thème de police
- Comment créer et partager un schéma de couleurs
- Comment utiliser les variables de base de Discourse dans votre thème
- Comment ajouter des paramètres à votre thème Discourse
- Theme Creator, créez et affichez des thèmes sans installer Discourse !
Ce document est contrôlé par version - suggérez des modifications sur github.