---
title: Installation & Configuration
description: Méthodes d'installation, téléchargement du paquet autonome HTML, paquets npm et compilation de VertiWiki depuis les sources.
tags: [vertiwiki, installation, telechargement, npm, build, francais]
---

# Installation & Configuration

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

VertiWiki s'intègre facilement dans votre flux de travail selon vos besoins : téléchargement du fichier unique autonome, intégration npm ou compilation depuis les sources.

---

## 🎯 Formats de Distribution

| Format | Idéal Pour | Prérequis |
| :--- | :--- | :--- |
| **Fichier HTML Autonome** | Hébergement statique, S3/Cloudflare Pages, Équipes non-dev | N'importe quel serveur HTTP |
| **Paquet NPM** | Intégration dans des monorepos JavaScript/TypeScript | Node.js `>=22` |
| **Compilation Source** | Développements personnalisés, plugins sur mesure | Vite & Node.js `>=22` |

---

## 📥 Méthode 1 : Fichier Autonome Unique (Recommandé)

La méthode la plus rapide consiste à télécharger le binaire HTML `vertiwiki.html`. Il contient l'ensemble des bibliothèques nécessaires (`marked`, `dompurify`, `mermaid`, `minisearch`, `prismjs`, `katex`) :

```bash
# Téléchargement direct via curl
curl -fsSL https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -o index.html

# Téléchargement direct via wget
wget https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -O index.html
```

---

## 📦 Méthode 2 : Gestionnaire de Paquets NPM

Pour intégrer VertiWiki dans un projet Node :

```bash
# npm
npm install vertiwiki

# pnpm
pnpm add vertiwiki

# yarn
yarn add vertiwiki

# bun
bun add vertiwiki
```

Le paquet inclut la distribution dans `node_modules/vertiwiki/dist/vertiwiki.html` ainsi que les types TypeScript.

---

## 🔨 Méthode 3 : Compilation depuis les Sources

Pour contribuer ou générer un build personnalisé :

### 1. Cloner le Répertoire
```bash
git clone https://github.com/Octadira/vertiwiki.git
cd vertiwiki
```

### 2. Installer les Dépendances
```bash
npm install
```

### 3. Démarrer le Serveur de Développement Vite
```bash
npm run dev
```

### 4. Compiler la Distribution Unique
```bash
npm run build
```

Cette commande exécute `vite build` avec `vite-plugin-singlefile`, produisant :
- `dist/index.html`
- `dist/vertiwiki.html`

### 5. Lancer les Tests Automatisés
```bash
npm test
```

---

## 🚀 Servir la Documentation

Les navigateurs bloquent les requêtes `fetch()` sur `file:///`. Servez toujours votre wiki via un serveur HTTP :

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

# Node.js
npx serve .

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

---

## 🔗 Prochaines Étapes

- Configurez les options d'affichage dans [Aperçu de la Configuration](configuration/overview.md).
- Découvrez les recettes de déploiement dans le [Runbook Opérationnel](operations/runbook.md).