---
title: Guide de Démarrage Rapide
description: Configurez et déployez une instance VertiWiki prête pour la production en moins de cinq minutes.
tags: [vertiwiki, demarrage-rapide, tutoriel, configuration, installation, francais]
---

# Démarrage Rapide en 5 Minutes

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

Ce tutoriel pratique vous guide pas à pas dans la création, la configuration et la prévisualisation d'une base de connaissances VertiWiki complète.

---

## 🛠️ Étape 1 : Créer le Dossier du Projet

Ouvrez votre terminal et initialisez un nouveau répertoire :

```bash
mkdir my-knowledge-base
cd my-knowledge-base
```

---

## 📦 Étape 2 : Télécharger le Moteur VertiWiki

Récupérez le fichier HTML autonome et nommez-le `index.html` :

```bash
curl -fsSL https://github.com/Octadira/vertiwiki/releases/latest/download/vertiwiki.html -o index.html
```

Ce fichier unique regroupe l'intégralité de l'application : routeur, thèmes, assainisseur et plugins.

---

## ⚙️ Étape 3 : Créer la Configuration Runtime (`config.json`)

Créez le fichier `config.json` à la racine de votre projet :

```json
{
  "title": "Manuel de l'Équipe Ingénierie",
  "brandDisplay": "title",
  "useSideMenu": true,
  "useTableOfContents": true,
  "enableSearch": true,
  "enableMath": true,
  "enableMermaid": true,
  "enableCodeCopy": true,
  "enableThemeChooser": true,
  "defaultTheme": "dark",
  "themePreset": "default",
  "navigationFile": "navigation.md",
  "homePage": "index.md"
}
```

---

## 🌲 Étape 4 : Définir la Navigation Latérale (`navigation.md`)

VertiWiki s'appuie sur un fichier Markdown avec des titres `# Catégorie` et des listes `* [Titre](chemin.md)` :

```markdown
# Premiers Pas
* [Accueil](index.md)
* [Règles d'Architecture](guidelines.md)

# Runbooks
* [Gestion des Incidents](playbook.md)
```

---

## 📝 Étape 5 : Rédiger les Premières Pages

Créez vos documents Markdown :

### `index.md`
```markdown
---
title: Page d'Accueil du Manuel
description: Espace central regroupant les standards d'ingénierie et procédures de l'équipe.
tags: [manuel, interne, ingenierie]
---

# Bienvenue sur le Manuel de l'Équipe

Ce wiki rassemble nos guides d'architecture, procédures opérationnelles et documentations d'onboarding.

## Fonctionnalités
- **Recherche Instantanée** : Appuyez sur <kbd>⌘K</kbd> ou <kbd>/</kbd> pour chercher dans tout le site.
- **Thème Sombre / Clair** : Ajustez le thème depuis la barre supérieure.
- **Support des Wikilinks** : Créez des liens facilement vers [[guidelines|Règles d'Architecture]].
```

### `guidelines.md`
```markdown
---
title: Règles d'Architecture
description: Standards de conception logicielle et conventions de code.
tags: [architecture, regles, conception]
---

# Règles d'Architecture

> [!NOTE]
> Tout nouveau microservice doit respecter notre politique de sécurité zero-trust.
```

---

## 🚀 Étape 6 : Lancer le Serveur Local

Comme VertiWiki utilise l'API `fetch()` pour charger les fichiers Markdown, lancez un serveur HTTP local :

```bash
# Avec Python 3
python3 -m http.server 8000

# OU avec Node.js
npx serve .
```

Ouvrez `http://localhost:8000` dans votre navigateur. Votre nouveau wiki est immédiatement prêt, interactif et interrogeable !

---

## 🔍 Prochaines Étapes

- Consultez les formats de distribution dans [Installation & Configuration](installation.md).
- Personnalisez les styles et options dans [Aperçu de la Configuration](configuration/overview.md).
- Examinez le fonctionnement interne dans [Architecture Système](concepts/architecture.md).