Documentations

doc/configuration.md

+# Configuration du thème et des composants
+
+## Comment ça marche ?
+
+### Configuration du thème
+
+Les couleurs par défaut peuvent être modifier avec votre palette de couleurs dans `Customize / Colors`. Pour plus d'information sur les palettes de couleurs [voir ici](https://meta.discourse.org/t/how-to-create-and-share-a-color-scheme/61196).
+
+**Trois composants sont utilisés dans notre thème :**
+
+- _Versatile Banner_
+- _Categories boxes_
+- _Showcased Categories_
+
+### Bannière _How to begin ?_
+
+C'est le composant **_Versatile Banner_** qui est utilisé pour cette banière.
+
+- Doc : https://meta.discourse.org/t/versatile-banner/109133
+- Dépôt : https://github.com/tshenry/discourse-versatile-banner.git
+
+#### Configuration
+
+La bannière s'affiche pour tout le monde et il est possible de la masquer mais pas de l'enlever.
+Elle apparaît sur les pages :
+
+- `/latest`
+- `/categories`
+- `/new`
+- `/unread`
+- `/top*`
+- `/tag/*`
+- `/tags/*`
+- `/c/*`
+- `/t/*`
+
+Il n'y a pas de fond ni d'image de fond, il est néanmoins possible d'en ajouter.
+
+Ensuite il faut configuer le contenu de la bannière : texte, images dans chaque colonnes en ecrivant le code HTML.
+
+Pour personnaliser les images de la banière, il faut les ajouter dans la categorie accessible uniquement par [les responsables](https://meta.discourse.org/t/upload-image-in-discourse/141504/4). 
+
+Pour se faire, créez un post avec une image dans la catégorie _staff_ (privée). parcourir le post créée qui affiche l'image et faite un clic droit pour **copier le lien de l'image**. Puis, coller ce lien dans la page configuration du composant, section `Column Icons`.
+[Pour plus d'information voir ici](https://meta.discourse.org/t/upload-image-in-discourse/141504/4)
+
+---
+
+### Categories boxes
+
+Ce composant est inspiré du composant **_Categories Layout Override_**. C'est luis qui affiche les boîtes de categories.
+
+- Doc : https://meta.discourse.org/t/categories-layout-override/131098
+- Dépôt : https://github.com/tshenry/discourse-categories-layout-override
+- [ ] TODO mettre le lien de notre dépot
+
+
+---
+
+### Category post
+
+Le composant **_Showcased Categories_** présente deux boîtes avec une liste de 4 postes.
+
+- Doc : https://meta.discourse.org/t/showcased-categories-theme-component/173524
+- Dépôt : https://github.com/discourse/discourse-showcased-categories.git
+
+#### Configuration
+
+Défini la taille en nombre de post maximum du contenu des boîtes et les catégories qui seront dans les boites contenu : _Latest_ et _Top_.