Discourse est hautement personnalisable, vous permettant de modifier presque tous les aspects de son apparence grâce aux thèmes.
Pour garantir la compatibilité avec les mises à jour continues de Discourse et les nouvelles fonctionnalités, tous les thèmes nécessitent une maintenance occasionnelle. La fréquence de cette maintenance 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 s’il existe des thèmes ou des composants de thème officiels correspondant à la fonctionnalité souhaitée. Ceux-ci sont mis à jour en même temps que Discourse. Ils peuvent également servir d’exemples pour aborder vos propres personnalisations.
- Remplacez le texte de l’interface en utilisant la fonction administrateur → personnaliser → texte en recherchant le texte spécifique et en le mettant à jour là-bas.
- Le CSS des thèmes 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 administrateur → personnaliser → thèmes soit pratique pour les ajustements mineurs, les systèmes de contrôle de version facilitent 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 des sorties de plugin. Discourse utilise Ember.js, donc la création de composants Ember est idéale. Cette méthode isole les fonctionnalités personnalisées, réduit la maintenance et aide à éviter les conflits avec les mises à jour de Discourse.
Remplacer les modèles JavaScript et HTML par défaut de Discourse dans un thème devrait ê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 consultez nos guides sur les thèmes :
- Guide pour débutants sur l’utilisation des thèmes Discourse
- Guide pour designers sur les thèmes Discourse
- Guide pour développeurs sur 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 principales de Discourse dans votre thème
- Comment ajouter des paramètres à votre thème Discourse
- Créateur de thèmes, créez et affichez des thèmes sans installer Discourse !
Ce document est sous contrôle de version - proposez des modifications sur github.