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 une maintenance occasionnelle. La fréquence de maintenance dépend de la complexité et du type de personnalisation. Vous pouvez minimiser les efforts de maintenance de votre thème en suivant ces directives :
- Recherchez des thèmes officiels ou des composants de thème qui correspondent aux fonctionnalités souhaitées. Ceux-ci sont mis à jour en parallèle de Discourse. Ils peuvent également servir d’exemples sur la façon d’aborder vos propres personnalisations.
- Remplacez le texte de l’interface en utilisant la fonction admin → personnaliser → texte en recherchant le texte spécifique et en le mettant à jour là.
- 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 des ajustements mineurs, les systèmes de contrôle de version peuvent faciliter le suivi et le dépannage des modifications plus complexes.
- Pour des personnalisations avancées, créez des modules indépendants pour de nouvelles fonctionnalités et intégrez-les via des points d’insertion 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 le JavaScript et les modèles 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 de thèmes :
- Guide du débutant pour l’utilisation des thèmes Discourse
- Guide du designer 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 avec les thèmes et les 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.