configuration.md

# Configuration du thème et des composants

## Comment ça marche ?

### Configuration des couleurs

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). Vous pouvez dupliquer les paletes `Community Light` ou `Community Dark` pour faire vos propres palettes.

### Bannière _How to begin ?_

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 :

- `/latest`
- `/categories`
- `/new`
- `/unread`
- `/top*`
- `/tag/*`
- `/tags/*`
- `/c/*`
- `/t/*`

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 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).

### Les boites de catégories

Le composant est **_Categories Layout Override_** qui affiche les boîtes de categories avec leur images.

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

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

Vou 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

**Option 2 Créer une palette manuellement dans **color** pour créer sa *palette de couleurs* en partant d'une palette existante**
- Copier une palette existante et faire ses modifications.

- Ajouter une ***palette de couleurs*** dans son thème : section **color palette**.
⚠️ Choisir cette option enlèvera les fonts installer. Il faudra en installer d'autres dans Admin/Settings/Basic Setup.


#### Installer une police de caractère

- Les fonts sont installées grâce au fichier about.json du dépôt, nous l'avons vu plus haut.
- On peut aussi installer des fonts existantes du Discourse, depuis **Admin/Settings/Basic Setup.**