refactor: clarification of the confiruration

doc/configuration.md

@@ -2,16 +2,6 @@
 
 ## 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).
-
-**Le thème s'inspire de trois composants :**
-
-- _Versatile Banner_
-- _Categories boxes_
-- _Showcased Categories_
-
 ### Bannière _How to begin ?_
 
 C'est le composant **_Versatile Banner_** qui est utilisé pour cette bannière.
@@ -19,8 +9,6 @@ C'est le composant **_Versatile Banner_** qui est utilisé pour cette banniè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 / possibilité de la masquer.
 Elle apparaît sur les pages :
 
@@ -34,41 +22,40 @@ Elle apparaît sur les pages :
 - `/c/*`
 - `/t/*`
 
-Pas d'image de fond, mais possible d'en ajouter.
+Il n'y a pas d'image de fond, mais il es possible d'en ajouter une.
 
 Ensuite il faut configuer le contenu de la bannière : texte, images dans chaque colonnes.
 
-Pour personnaliser les images de la banniè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 personnaliser les images de la bannière, il faut les uploader sur le forum. Pour ça il faut créer un post avec les images dans la catégorie _staff_ (privée). Puis parcourir le post créé 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).
 
-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)
+### Les boites de catégories
 
----
+Le composant est **_Categories Layout Override_** qui affiche les boîtes de categories avec leur images.
 
-### Categories boxes
-
-Ce composant est inspiré du composant **_Categories Layout Override_** qui affiche les boîtes de categories.
+Dans Theme Settings/categories layout il faut choisir `catégories_boxes`.
 
 - Doc : https://meta.discourse.org/t/categories-layout-override/131098
 - Dépôt : https://github.com/tshenry/discourse-categories-layout-override
 
+### _Showcased Categories_
 
----
-
-### Category post
-
-Le composant est inspiré de **_Showcased Categories_** présentant deux boîtes avec une liste de 4 postes.
+Le composant présentant 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
+Vous pouvez définir la taille en nombre de post maximum du contenu des boîtes et les catégories qui seront dans les boites ainsi que leur titre.
+
+### Configuration des couleurs
 
-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_.
+Les couleurs peuvent être modifiés en créant 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). Vous pouvez dupliquer les palettes `Community Light` ou `Community Dark` pour faire vos propres palettes.
 
+Pour en savoir plus sur quel couleur correspond à quoi nous fournissons [un descriptif de celles-ci](descriptif_couleurs.md).
 
-## Licence
+Une fois votre palette créé ajouter celle-ci dans le thème : section **color palette**.
 
-[![community-theme Copyright 2021-present Lydra](https://www.gnu.org/graphics/gplv3-with-text-136x68.png)](https://choosealicense.com/licenses/gpl-3.0/)
+#### Installer des polices de caractère
 
-**community-theme** is maintained by [Lydra](https://lydra.fr/) and released under the GPL3 license.
+Vous pouvez aussi installer des fonts existantes sur Discourse, depuis **Admin/Settings/Basic Setup.**.
+Pour en savoir plus [voir ici](https://meta.discourse.org/t/how-to-change-default-font-of-your-site/21282).

doc/descriptif_couleurs.md

+# Descriptif de la palette de couleur
+
+## primary
+
+- La plupart du texte, des icônes et des bordures
+- Textes
+- Textes sections
+- Textes input
+- Titres
+- Bannière des options (en plus claire)
+- Génère un bandeau lors d'un :hover d'une image dans le topic.
+
+## secondary
+
+- Couleur d'arrière-plan principale, et couleurs du texte de certains boutons.
+- Couleur de fond des post/topics
+- Couleur de fond des catégories
+- Couleur de fond input
+- Couleur des textes/icones du footer
+- Couleur du texte des boutons
+- Couleur des icones dans topics
+
+## tertiary
+
+- Les liens, certains boutons, notifications et accentuation
+- Boutons:actif des menu
+- Ombre des boutons d'action (more, new topic)
+- Éléments des graphiques
+- Titres des graphiques
+- Titre:actifs des options des graphiques
+- Titre:hover des options des graphiques
+- Titre:hover du menu latéral
+- Surlignement des messages Discourse pour l'utilisateur.
+
+## quaternary
+
+- Liens de navigation
+- Section:active menu latéral
+- Icones:hover
+
+## header background
+
+- Couleur de font de la bannière
+- Bordures des post/topics
+- Boutons:actifs
+- Topics-action:hover
+- Titre des options:hover de la bannière
+
+## header primary
+
+- Texte, icones de la bannière
+- Fond de couleur de la page.
+
+## highlight
+
+Couleur d'arrière-plan (surligner) des post et topics.
+- Couleur de fond des champs de saisie
+
+## danger
+
+- Couleur d'arrière-plan (surligner) des actions like, suppression de post/topics
+- Couleur de fond des bouton:actifs dans le menu customize theme/component
+- Icone de suppression
+
+## success
+
+- Une action réalisée avec succès
+
+## love
+
+- Bouton like
+
+## primary-low-mid
+
+- Les icones
+
+## primary-medium
+
+- Les boutons
+- Bouton:hover des categories/options
+- Bordures des cadres

doc/discourse_theme_cli.md

@@ -6,9 +6,9 @@
 
 #### Installation
 
-Il faut commencer par générer une clé API dans Discourse, et on enregistre une clé API par thème.
+Il faut commencer par [générer une clé API `Global Key`](https://meta.discourse.org/t/discourse-theme-cli-console-app-to-help-you-build-themes/82950#credentials-4) dans Discourse, et on enregistre une clé API par thème.
 
-1. Installer `Ruby 2.2` minimum.
+1. Installer `Ruby 2.2` minimum, le mieu c'est d'utiliser [`rbenv`](https://github.com/rbenv/rbenv).
 2. Installer la gem `discourse_theme`.
 
 ```bash

doc/prerequis.md

@@ -37,6 +37,7 @@ Les catégories sont présentés sous forme de boite avec une image. La taille c
 
 - Doc : https://meta.discourse.org/t/categories-layout-override/131098
 - Dépôt : https://github.com/tshenry/discourse-categories-layout-override
+
 ### Category icons component
 
 Les catégories sont affichées avec des icônes complétant les titres.