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

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

- 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/*`

Pas d'image de fond, mais possible d'en ajouter.

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 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_** 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


---

### Category post

Le composant est inspiré de **_Showcased Categories_** 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

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


## Licence

[![community-theme Copyright 2021-present Lydra](https://www.gnu.org/graphics/gplv3-with-text-136x68.png)](https://choosealicense.com/licenses/gpl-3.0/)

**community-theme** is maintained by [Lydra](https://lydra.fr/) and released under the GPL3 license.