---
title: Matrice de Depanare & Diagnoză Erori
description: Probleme frecvente, pași de diagnosticare, coduri de eroare și soluții practice pentru VertiWiki.
tags: [vertiwiki, depanare, diagnoza, erori, debugging, faq, romana]
---

# Matrice de Depanare & Diagnoză Erori

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

Acest ghid oferă o matrice completă de diagnosticare pentru identificarea și soluționarea rapidă a problemelor de configurare, rutare și randare în VertiWiki.

---

## 🔍 Matricea de Diagnosticare

| Simptom / Mesaj de Eroare | Cauză Probabilă | Soluție Imediată |
| :--- | :--- | :--- |
| **`Access to fetch at 'file://...' from origin 'null' has been blocked by CORS policy`** | Deschiderea fișierului `index.html` direct din sistemul de fișiere prin dublu-clic (`file:///`). | Porniți un server HTTP local: `python3 -m http.server` sau `npx serve .`. |
| **Pagină albă la accesarea site-ului** | Eroare de sintaxă în `config.json` (virgulă în plus, ghilimele neînchise). | Rulați `jq . config.json` pentru validare. Corectați sintaxa și reîncărcați pagina. |
| **Eroare 404 la clic pe un link din meniu** | Fișierul Markdown țintă nu există la calea specificată în `navigation.md`. | Confirmați că numele fișierului și calea corespund literă cu literă (inclusiv majuscule/minuscule). |
| **Diagrama Mermaid afișează text brut în loc de grafic** | Blocul de cod nu are eticheta de limbaj sau conține o eroare de sintaxă. | Asigurați-vă că blocul începe cu ```` ```mermaid ```` și folosește sintaxă validă (ex: `graph TD`). |
| **Formulele LaTeX afișează caractere brute `$..$`** | `enableMath` este setat pe `false` în `config.json`. | Setați `"enableMath": true` în `config.json` și folosiți `$$...$$` sau `\(...\)`. |
| **Căutarea modală (<kbd>⌘K</kbd>) nu găsește rezultate** | Indexarea asincronă este în curs sau limba activă diferă. | Verificați consola pentru erori MiniSearch. Căutarea este limitată la limba curentă (`en`, `ro`, `fr`). |
| **Prefix dublu în URL (`/#/ro/ro/ghid.md`)** | Linkurile din `ro/navigation.md` conțin prefixul de limbă explicit. | În fișierele de navigare localizate, folosiți căi relative curate (`ghid.md`), nu `ro/ghid.md`. |

---

## 🛠️ Proceduri de Diagnostic Pas cu Pas

### 1. Verificarea Solicitărilor de Rețea
1. Deschideți Developer Tools (<kbd>F12</kbd>).
2. Mergeți la fila **Network** și filtrați după **Fetch/XHR**.
3. Reîncărcați pagina și inspectați codurile HTTP:
   - `config.json`: Trebuie să returneze `200 OK`.
   - `navigation.md`: Trebuie să returneze `200 OK`.
   - Fișierul `.md`: Trebuie să returneze `200 OK`.
4. Dacă o cerere returnează `404`, analizați adresa URL completă pentru a verifica rezoluția căilor de bază.

### 2. Validarea Header-ului YAML Frontmatter
VertiWiki extrage frontmatter-ul delimitat de `---` la începutul fișierului (linia 1). Dacă metadatele nu apar:
- Asigurați-vă că nu există spații goale înainte de prima linie `---`.
- Ghilimelele sunt obligatorii pentru valori ce conțin două puncte (ex: `title: "Titlu: Partea 1"`).

---

## 💬 Asistență Suplimentară

Dacă problema persistă:
- Deschideți o sesizare pe [Depozitul GitHub](https://github.com/Octadira/vertiwiki/issues).
- Verificați [Harta Vizuală Interactivă](../sitemap.md) pentru a valida căile paginilor.
- Consultați opțiunile complete în [Prezentare Configurare](../configuration/overview.md).