---
title: Prezentare Configurare & Schemă
description: Referință completă pentru fișierul de configurare runtime (config.json) și opțiunile de aspect VertiWiki.
tags: [vertiwiki, configurare, schema, setari, config-json, romana]
---

# Prezentare Configurare & Schemă

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

Comportamentul VertiWiki este controlat în totalitate de un fișier declarativ `config.json` aflat în directorul rădăcină al documentației. Modificările devin active la următoarea reîncărcare a paginii în browser.

---

## 📄 Configurație Minimală Funcțională

```json
{
  "title": "Baza Mea de Cunoștințe",
  "navigationFile": "navigation.md",
  "homePage": "index.md"
}
```

---

## 🛠️ Referința Completă a Schemei de Configurare

| Proprietate | Tip | Implicit | Descriere |
| :--- | :--- | :--- | :--- |
| `title` | `string` | `"VertiWiki"` | Numele portalului afișat în antet și în `<title>`-ul documentului. |
| `logo` | `string` | `undefined` | Calea către imaginea logo din antet (SVG, PNG, WebP). |
| `favicon` | `string` | `undefined` | Calea către resursa favicon personalizată. |
| `brandDisplay` | `'both' \| 'logo' \| 'title'` | `'both'` | Afișează în antet doar sigla, doar textul sau ambele. |
| `useSideMenu` | `boolean` | `true` | Activează sau dezactivează meniul lateral de navigare. |
| `useTableOfContents` | `boolean` | `true` | Activează coloana din dreapta cu cuprinsul paginii ("Pe această pagină"). |
| `enableSearch` | `boolean` | `true` | Activează căutarea full-text în memorie prin MiniSearch și scurtătura (<kbd>⌘K</kbd>). |
| `enableMath` | `boolean` | `true` | Activează formatarea formulelor matematice LaTeX prin KaTeX. |
| `enableMermaid` | `boolean` | `true` | Activează randarea diagramelor și graficelor Mermaid. |
| `enableCodeCopy` | `boolean` | `true` | Adaugă buton de copiere pe antetele blocurilor de cod. |
| `enableAiCopy` | `boolean` | `true` | Activează butonul "Copiază pentru AI" în antetul articolelor. |
| `enableThemeChooser` | `boolean` | `true` | Afișează selectorul de teme în bara de navigare. |
| `enableLanguageChooser` | `boolean` | `false` | Afișează comutatorul de limbă în bara de navigare. |
| `locales` | `LocaleConfig[]` | `[]` | Vectorul de limbi suportate (vezi [Setări Multi-Limbă](#setari-multi-limba)). |
| `collapsibleNavigation`| `boolean` | `true` | Permite plierea și extinderea secțiunilor din meniul lateral. |
| `defaultTheme` | `'auto' \| 'light' \| 'dark'` | `'auto'` | Modul inițial al temei înainte de salvarea opțiunii utilizatorului. |
| `themePreset` | `string` | `'default'` | Identificatorul presetului de temă activ (ex: `'obsidian'`, `'dracula'`, `'nord'`). |
| `customThemes` | `string[] \| object[]` | `[]` | Căi către fișiere JSON de teme (ex: `["themes/obsidian.json"]`) sau obiecte de temă. |
| `layoutMode` | `string` | `'default'` | Stilul global de layout: `'default'`, `'book'`, `'handbook'`, `'api'` sau `'hub'`. |
| `contentWidth` | `'normal' \| 'readable' \| 'full'` | `'normal'` | Lățimea conținutului: standard (850px), optimizată pentru lectură (68ch) sau completă (100%). |
| `headerLinks` | `HeaderLinkItem[]` | `[]` | Legături externe și butoane de acțiune în antetul paginii. |
| `customCss` | `string \| string[]` | `undefined` | Calea către fișiere CSS externe pentru personalizări suplimentare. |
| `navigationFile` | `string` | `"navigation.md"`| Fișierul Markdown care definește structura meniului. |
| `homePage` | `string` | `"index.md"` | Fișierul Markdown încărcat implicit la accesarea rădăcinii. |
| `llmsTxtUrl` | `string` | `"llms.txt"` | Calea relativă sau absolută către indexul pentru agenți AI. |
| `footerText` | `string` | `undefined` | Textul sau codul HTML afișat în subsolul paginilor. |
| `githubUrl` | `string` | `undefined` | Adresa depozitului GitHub afișată în antet. |

---

## 🌐 Setări Multi-Limbă (`locales`)

Pentru documentații multilingve, configurați lista de locale:

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

- `code`: Codul de limbă ISO 639-1.
- `label`: Denumirea afișată în selectorul de limbi.
- `prefix`: Prefixul căii din URL pentru această limbă.
- `isDefault`: Marchează limba canonică implicită.

---

## 🔗 Pașii Următori

- Configurați politicile de securitate în [Securitate & Granițe CSP](security.md).
- Consultați ghidurile de implementare pe servere în [Runbook Operațional](../operations/runbook.md).