---
title: Matrice de Dépannage & Diagnostic des Erreurs
description: Problèmes fréquents, étapes de diagnostic, codes d'erreur et solutions pratiques pour VertiWiki.
tags: [vertiwiki, depannage, diagnostic, erreurs, debugging, faq, francais]
---

# Matrice de Dépannage & Diagnostic des Erreurs

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

Ce guide fournit une grille de diagnostic pour cerner et corriger rapidement les éventuelles anomalies de configuration, de routage ou de rendu dans VertiWiki.

---

## 🔍 Matrice de Diagnostic

| Symptôme / Message d'Erreur | Cause Probable | Résolution Immédiate |
| :--- | :--- | :--- |
| **`Access to fetch at 'file://...' from origin 'null' has been blocked by CORS policy`** | Ouverture directe du fichier `index.html` depuis l'explorateur de fichiers (`file:///`). | Démarrez un serveur HTTP local : `python3 -m http.server` ou `npx serve .`. |
| **Écran blanc immaculé** | Erreur de syntaxe JSON dans `config.json` (virgule superflue, guillemet manquant). | Validez le fichier avec `jq . config.json` et corrigez la syntaxe. |
| **Erreur 404 au clic sur un lien du menu** | Le fichier Markdown visé n'existe pas au chemin indiqué dans `navigation.md`. | Vérifiez scrupuleusement la casse et l'emplacement exact du fichier `.md`. |
| **Le diagramme Mermaid affiche du texte brut** | Bloc de code dépourvu de balise `mermaid` ou contenant une erreur de syntaxe interne. | Vérifiez le bloc ```` ```mermaid ```` et contrôlez la syntaxe du diagramme. |
| **Les formules LaTeX affichent des symboles bruts `$..$`** | `enableMath` est configuré sur `false` dans `config.json`. | Activez `"enableMath": true` dans `config.json` et utilisez `$$...$$` ou `\(...\)`. |
| **La recherche (<kbd>⌘K</kbd>) ne renvoie aucun résultat** | L'indexation est en cours ou la recherche est ciblée sur une autre langue. | Notez que la recherche est restreinte à la langue en cours (`en`, `ro`, `fr`). |
| **Double préfixe dans l'URL (`/#/fr/fr/guide.md`)** | Liens avec préfixe de langue codé en dur dans `fr/navigation.md`. | Utilisez des chemins relatifs propres (`guide.md`) sans préfixer par `fr/`. |

---

## 🛠️ Diagnostics Étape par Étape

### 1. Contrôle des Requêtes Réseau
1. Ouvrez les Outils de Développement (<kbd>F12</kbd>).
2. Sélectionnez l'onglet **Network** et filtrez par **Fetch/XHR**.
3. Rechargez la page et vérifiez les codes de retour :
   - `config.json` : Doit répondre `200 OK`.
   - `navigation.md` : Doit répondre `200 OK`.
   - Document `.md` : Doit répondre `200 OK`.

### 2. Validation du Frontmatter YAML
- Le bloc doit impérativement débuter à la première ligne sans espace préalable.
- Les chaînes comprenant des deux-points doivent être encadrées de guillemets.

---

## 💬 Obtenir de l'Aide

- Ouvrez un ticket sur le [Dépôt GitHub](https://github.com/Octadira/vertiwiki/issues).
- Consultez le [Plan Visuel Interactif](../sitemap.md).
- Revoyez les paramètres dans [Aperçu de la Configuration](../configuration/overview.md).