quizThemingJsonDoc top-level constant

String const quizThemingJsonDoc

Implementation

const String quizThemingJsonDoc = """
# 📚 QuizTheming JSON Declaration Guide

Le \`QuizTheming\` permet de personnaliser entièrement le visuel et la mise en page de votre quiz via un thème en JSON.

---

## 🎨 Exemple de structure JSON

\`\`\`json
{
  "appBackgroundImage": "assets/images/background.jpg",
  "quizHeaderImage": "assets/images/header.jpg",
  "logoImage": "assets/images/logo.png",

  "primaryColor": "#4D61BD",
  "selectedColor": "#4D61BD",
  "logoBackgroundColor": "#00000000",
  "textColor": "#000000",
  "appBackgroundColor": "#FFFFFF",
  "quizBoxBackgroundColor": "#FFFFFF",
  "questionBackgroundColor": "#00000000",

  "maxQuizWidth": 800,
  "maxQuizHeight": 600,
  "logoHeight": 150,
  "questionSpacing": 32,
  "quizBoxBackgroundBlurRadius": 0
}
\`\`\`

---

## 📑 Référence des champs

### 🔗 Images (optionnelles)

| Champ                 | Description                                     | Exemple                            |
|-----------------------|-------------------------------------------------|------------------------------------|
| \`appBackgroundImage\`  | Image d'arrière-plan de l'application          | \`https://images.pexels.com/photos/32039255/pexels-photo-32039255/free-photo-of-paysage-de-campagne-rustique-avec-un-vieux-hangar.jpeg\`  |
| \`quizHeaderImage\`     | Image dans l'entête du quiz                   | \`\`      |
| \`logoImage\`           | Logo de branding                              | \`\`        |

---

### 🎨 Couleurs

Les couleurs doivent être en chaîne HEX au format \`#RRGGBB\` ou \`#AARRGGBB\` (avec transparence).

| Champ                    | Description                                        | Exemple        |
|--------------------------|----------------------------------------------------|----------------|
| \`primaryColor\`            | Couleur principale (boutons, éléments majeurs)    | \`"#4D61BD"\`    |
| \`selectedColor\`           | Couleur des éléments sélectionnés                 | \`"#4D61BD"\`    |
| \`logoBackgroundColor\`     | Couleur de fond derrière le logo                  | \`"#00000000"\`  |
| \`textColor\`               | Couleur générale du texte                        | \`"#000000"\`    |
| \`appBackgroundColor\`      | Couleur de fond générale de l'application         | \`"#FFFFFF"\`    |
| \`quizBoxBackgroundColor\`  | Couleur de fond de la boîte du quiz              | \`"#FFFFFF"\`    |
| \`questionBackgroundColor\` | Couleur de fond derrière les questions           | \`"#00000000"\`  |

---

### 📏 Espacement & Mise en page

| Champ                        | Description                                         | Exemple  |
|------------------------------|-----------------------------------------------------|----------|
| \`maxQuizWidth\`               | Largeur max de la boîte de quiz (nullable)          | \`800\`    |
| \`maxQuizHeight\`              | Hauteur max de la boîte de quiz (nullable)         | \`600\`    |
| \`logoHeight\`                 | Hauteur du logo en pixels                         | \`150\`    |
| \`questionSpacing\`            | Espacement vertical entre les questions (en px)   | \`32\`     |
| \`quizBoxBackgroundBlurRadius\` | Flou de fond de la boîte de quiz (0 = aucun flou) | \`0\`      |

---

## ⚠ Notes importantes

- Les champs **optionnels** peuvent être omis ou mis à \`null\`.
- Toutes les **couleurs doivent être des chaînes HEX**, pas des entiers ARGB.
- Mettre **\`null\` pour largeur/hauteur** permet un comportement par défaut (aucune contrainte).

""";