---
title: Instalare & Configurare
description: Metode de instalare, descărcare pachet autonom HTML, pachete npm și compilare VertiWiki din sursă.
tags: [vertiwiki, instalare, descarcare, npm, build, romana]
---

# Instalare & Configurare

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

VertiWiki poate fi integrat în proiectele dumneavoastră prin mai multe metode, în funcție de cerințe: descărcare directă a fișierului compilat, pachet npm sau compilare din sursă.

---

## 🎯 Tipuri de Distribuție

| Format | Ideal Pentru | Cerințe |
| :--- | :--- | :--- |
| **Pachet HTML Autonom** | Găzduire statică, S3/Cloudflare Pages, Echipe non-dev | Orice server web HTTP |
| **Pachet NPM** | Integrare în monorepo-uri JavaScript/TypeScript | Node.js `>=22` |
| **Compilare din Sursă** | Personalizări ale nucleului, plugin-uri custom | Vite & Node.js `>=22` |

---

## 📥 Metoda 1: Pachetul Autonom Într-un Singur Fișier (Recomandat)

Cea mai simplă și directă modalitate de a rula VertiWiki este descărcarea fișierului `vertiwiki.html`. Acesta include toate dependențele necesare (`marked`, `dompurify`, `mermaid`, `minisearch`, `prismjs`, `katex`) pre-integrate:

```bash
# Descărcare directă prin curl
curl -fsSL https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -o index.html

# Descărcare directă prin wget
wget https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -O index.html
```

---

## 📦 Metoda 2: Managerul de Pachete NPM

Dacă gestionați documentația într-un proiect bazat pe Node.js:

```bash
# npm
npm install vertiwiki

# pnpm
pnpm add vertiwiki

# yarn
yarn add vertiwiki

# bun
bun add vertiwiki
```

Pachetul conține distribuția compilată la `node_modules/vertiwiki/dist/vertiwiki.html` și declarațiile de tipuri TypeScript.

---

## 🔨 Metoda 3: Compilare din Sursă

Pentru a contribui sau a construi o distribuție personalizată:

### 1. Clonați Depozitul Git
```bash
git clone https://github.com/Octadira/vertiwiki.git
cd vertiwiki
```

### 2. Instalați Dependențele
```bash
npm install
```

### 3. Porniți Serverul Vite de Dezvoltare
```bash
npm run dev
```

### 4. Compilați Pachetul Autonom
```bash
npm run build
```

Această comandă rulează `vite build` folosind `vite-plugin-singlefile`, generând:
- `dist/index.html`
- `dist/vertiwiki.html`

### 5. Rulați Testele Automate
```bash
npm test
```

---

## 🚀 Servirea Documentației

Browserul blochează apelurile locale `fetch()` pe protocolul `file:///`. Rulați întotdeauna un server HTTP:

```bash
# Python 3
python3 -m http.server 3000

# Node.js
npx serve .

# Caddy
caddy file-server --listen :3000
```

---

## 🔗 Pașii Următori

- Configurați meniul și aspectul în [Prezentare Configurare](configuration/overview.md).
- Consultați opțiunile de găzduire pe Cloudflare sau Vercel în [Runbook Operațional](operations/runbook.md).