---
title: Aperçu de la Configuration & Schéma
description: Référence exhaustive du fichier de configuration runtime (config.json) et des options d'affichage de VertiWiki.
tags: [vertiwiki, configuration, schema, parametres, config-json, francais]
---

# Aperçu de la Configuration & Schéma

> For the complete documentation index and agent navigation, see [llms.txt](/llms.txt).

Le comportement de VertiWiki est entièrement administré par un fichier déclaratif `config.json` placé à la racine du dossier documentaire. Les modifications prennent effet dès le rafraîchissement du navigateur.

---

## 📄 Configuration Minimale Fonctionnelle

```json
{
  "title": "Ma Base de Connaissances",
  "navigationFile": "navigation.md",
  "homePage": "index.md"
}
```

---

## 🛠️ Schéma Exhaustif des Paramètres

| Propriété | Type | Valeur par Défaut | Description |
| :--- | :--- | :--- | :--- |
| `title` | `string` | `"VertiWiki"` | Nom du portail affiché dans la barre de titre et l'en-tête. |
| `logo` | `string` | `undefined` | Chemin du fichier logo (SVG, PNG, WebP). |
| `favicon` | `string` | `undefined` | Chemin du favicon personnalisé. |
| `brandDisplay` | `'both' \| 'logo' \| 'title'` | `'both'` | Contrôle l'affichage du logo, du texte ou des deux. |
| `useSideMenu` | `boolean` | `true` | Active la barre latérale de navigation. |
| `useTableOfContents` | `boolean` | `true` | Active la colonne de droite ("Sur cette page"). |
| `enableSearch` | `boolean` | `true` | Active la recherche plein texte via MiniSearch (<kbd>⌘K</kbd>). |
| `enableMath` | `boolean` | `true` | Active le rendu des formules LaTeX avec KaTeX. |
| `enableMermaid` | `boolean` | `true` | Active le rendu des diagrammes Mermaid. |
| `enableCodeCopy` | `boolean` | `true` | Ajoute un bouton de copie sur chaque bloc de code. |
| `enableAiCopy` | `boolean` | `true` | Active l'action "Copier pour l'IA" dans les en-têtes d'articles. |
| `enableThemeChooser` | `boolean` | `true` | Affiche le sélecteur de thème dans la barre supérieure. |
| `enableLanguageChooser` | `boolean` | `false` | Affiche le sélecteur de langue dans la barre supérieure. |
| `locales` | `LocaleConfig[]` | `[]` | Liste des langues prises en charge (voir [Options Multilingues](#options-multilingues)). |
| `collapsibleNavigation`| `boolean` | `true` | Permet de plier/déplier les catégories du menu latéral. |
| `defaultTheme` | `'auto' \| 'light' \| 'dark'` | `'auto'` | Thème initial avant enregistrement du choix utilisateur. |
| `themePreset` | `string` | `'default'` | Identifiant du preset actif (ex : `'obsidian'`, `'dracula'`, `'nord'`). |
| `customThemes` | `string[] \| object[]` | `[]` | Chemins vers des fichiers JSON de thèmes ou objets de thème. |
| `layoutMode` | `string` | `'default'` | Style de mise en page : `'default'`, `'book'`, `'handbook'`, `'api'` ou `'hub'`. |
| `contentWidth` | `'normal' \| 'readable' \| 'full'` | `'normal'` | Largeur de contenu : standard (850px), lecture (68ch) ou pleine largeur (100%). |
| `headerLinks` | `HeaderLinkItem[]` | `[]` | Liens externes et boutons d'action dans l'en-tête. |
| `customCss` | `string \| string[]` | `undefined` | Chemins vers des feuilles de style CSS additionnelles. |
| `navigationFile` | `string` | `"navigation.md"`| Fichier Markdown décrivant l'arborescence. |
| `homePage` | `string` | `"index.md"` | Fichier Markdown d'accueil. |
| `llmsTxtUrl` | `string` | `"llms.txt"` | Chemin relatif vers l'index pour agents IA. |
| `footerText` | `string` | `undefined` | Texte ou code HTML de pied de page. |
| `githubUrl` | `string` | `undefined` | Lien vers le dépôt GitHub. |

---

## 🌐 Options Multilingues (`locales`)

```json
{
  "enableLanguageChooser": true,
  "locales": [
    { "code": "en", "label": "English", "isDefault": true },
    { "code": "ro", "label": "Română", "prefix": "ro" },
    { "code": "fr", "label": "Français", "prefix": "fr" }
  ]
}
```

---

## 🔗 Prochaines Étapes

- Configurez les règles de sécurité dans [Sécurité & CSP](security.md).
- Consultez les recettes de déploiement dans le [Runbook Opérationnel](../operations/runbook.md).