Zéro Runtime Serveur • Pipeline 100% Navigateur • Bundle Autonome 4 Mo

100% Statique, Fichier Unique Moteur de Wiki & Documentation

Déposez simplement un fichier autonome index.html à côté de vos fichiers Markdown. Aucun pipeline de compilation Node.js, aucune base de données et aucune commande de reconstruction. Compilation instantanée côté client avec Marked v15, DOMPurify, KaTeX, Prism, Mermaid et gestion dynamique des thèmes sur GPU.

Démarrer en 5 Minutes Explorer l'Architecture

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

Centre de Documentation

Accès Direct aux Guides d'Ingénierie

Explorez des tutoriels pas à pas, des schémas d'architecture, des runbooks opérationnels et le catalogue API complet.

🚀

Démarrage Rapide

Guide pratique en 5 minutes avec exemples de code exécutables, configurations rapides et modèles minimaux.

🏛️

Architecture Système

Explorez le pipeline côté client sans backend, les machines à états et la topologie C4.

⚙️

Guide de Configuration

Découvrez tous les paramètres de schéma, les modes d'affichage, l'i18n et l'image de marque.

🛠️

Opérations & Runbooks

Procédures d'hébergement sur Cloudflare Pages, AWS CloudFront, Vercel et diagnostics en production.

📖

Catalogue API TypeScript

Signatures TypeScript complètes, tableaux détaillés de paramètres, hooks et interfaces limites.

🔄

Flux d'Exécution

Flux complet requête-réponse, routage, assainissement DOM et diagrammes de séquence d'hydratation.

Architecture Technique

Conçu pour la Pérennité & la Vitesse

Six piliers architecturaux fondamentaux qui éliminent la complexité de backend et garantissent la fiabilité à long terme.

01 / RUNTIME CÔTÉ CLIENT

Zéro Backend & Zéro Compilation

Aucun pipeline serveur, aucun processus Node.js et aucune commande de reconstruction. Déposez index.html dans n'importe quel dossier et diffusez statiquement.

DOMPurify • Marked v15 • Routeur SPA

02 / BUNDLE FICHIER UNIQUE

Distribution Autonome en Fichier Unique

Compilé via Vite 6 avec vite-plugin-singlefile. Marked v15, DOMPurify, KaTeX, Prism et Mermaid sont tous intégrés dans un bundle autonome de 4 Mo.

Zéro Modules Node • Portable Hors Ligne

03 / PÉRIMÈTRE DE SÉCURITÉ

Défense en Profondeur

L'isolation automatique des iframes impose allow-presentation tout en bloquant les tentatives d'évasion de cadre. Les protocoles dangereux sont purgés.

DOMPurify Stricte • Invariant Zéro-XSS

04 / AEO & DÉCOUVERTE D'AGENTS

Arborescence Sémantique de Crawl & AEO

L'arbre sémantique intégré permet une indexation instantanée par Googlebot sans SSR, combiné aux microdonnées dynamiques Schema.org TechArticle et llms.txt.

AgentDocsSpec • llms.txt • JSON-LD

05 / MOTEUR DE THÈMES SUR GPU

Thèmes Découplés & 11 Préréglages

Permute les variables CSS sur document.documentElement en moins d'1ms sans rechargement. Supporte les fichiers JSON externes via le dossier themes/.

11 Préréglages • Obsidian • Editorial • Nord

06 / RECHERCHE EN MÉMOIRE

Recherche Instantanée Côté Client (ƒK)

Recherche ultrarapide en mémoire avec MiniSearch. Inclut la recherche floue (fuzzy), la tokenisation automatique, les raccourcis clavier (ƒK ou /) et le filtrage par langue.

MiniSearch • Moins d'une ms • Latence Zéro

Architecture du Cycle de Vie

Pipeline de Rendu Déterministe en 10 Étapes

Comment VertiWiki transforme le Markdown brut en une interface de documentation interactive et sécurisée en quelques millisecondes.

Analyse du Hash & Paramètres de Requête

Résout #/chemin.md ou le paramètre ?page= pour les réécritures de négociation de contenu.

Récupération Asynchrone des Ressources

Télécharge le fichier Markdown via fetch() avec résolution déterministe des sous-dossiers et repli 404.

Analyse du Frontmatter YAML

Extrait les métadonnées d'en-tête, l'auteur, les étiquettes personnalisées et les surcharges de thème/layout.

Hooks de Cycle de Vie beforeParse

Traite les macros personnalisées, y compris les onglets de code (::: tabs), détails repliables et badges.

Compilation Marked v15 & DOMPurify

Compile CommonMark + GFM et applique un assainissement strict Zéro-XSS avec bac à sable d'iframes.

Hooks de Cycle de Vie afterParse

Permet aux extensions d'inspecter ou de modifier le HTML sécurisé avant son injection dans le DOM.

Montage dans le DOM & Résolution de Liens

Injecte le HTML dans #verti-app et réécrit les chemins relatifs (../guide.md → #/guides/guide.md).

Plugins afterRender

Initialise la coloration syntaxique Prism, les formules KaTeX, les diagrammes Mermaid et le zoom d'images.

Table des Matières (TOC) & Scrollspy

Construit l'arborescence des titres et active IntersectionObserver pour le suivi de la section active.

Indexation de Recherche & Microdonnées AEO

Indexe les tokens dans MiniSearch et met à jour les microdonnées Schema.org TechArticle JSON-LD.

Comparaison Technique

Pourquoi les Développeurs Choisissent VertiWiki

Voyez comment VertiWiki se compare aux générateurs de sites statiques classiques et aux wikis traditionnels.

Caractéristique Architecturale	Standard VertiWiki	SSG Traditionnels (Docusaurus, VitePress)	Wikis Classiques (DokuWiki, MediaWiki)
Modèle d'Hébergement	100% Statique (Serveur HTTP, CDN, S3, Git Pages)	Artefact de build statique (Nécessite CI/CD)	Serveur PHP / Node / Base de données
Mise à Jour du Contenu	0s (Actualisation immédiate à l'édition de .md)	30s - 3min (Recompilation CI/CD & déploiement)	Écriture directe en BDD ou verrou de fichier
Moteur de Recherche	MiniSearch côté client (Latence nulle)	Algolia DocSearch ou JSON volumineux	Recherche SQL côté serveur
Diagrammes & Formules	Mermaid & KaTeX natifs côté client	Plugins et transformations au build	Extensions serveur (Mathoid, Graphviz)
Surface d'Attaque	Isolation stricte DOMPurify, zéro vecteur serveur	Risque sur la chaîne de paquets npm au build	Injections SQL, failles PHP
Optimisation IA Autonome	Natif llms.txt + Schema.org JSON-LD	Intégration manuelle requise	Inexistante

Démarrage

Prêt en 3 Étapes Simples

Aucun pipeline de build Node.js complexe et aucune base de données requise.

ÉTAPE 01

Rédigez le Contenu en Markdown

Créez votre fichier index.md, vos sous-dossiers (ex. concepts/) et votre menu dans navigation.md.

mkdir -p my-wiki && touch index.md navigation.md

ÉTAPE 02

Téléchargez le Moteur

Téléchargez le bundle autonome précompilé directement depuis les releases GitHub dans votre dossier racine.

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

ÉTAPE 03

Déployez & Hébergez N'importe Où

Déployez sur GitHub Pages, Cloudflare Pages, S3 ou testez en local avec n'importe quel serveur HTTP statique.

npx serve . # ou python3 -m http.server

Foire Aux Questions

Éclaircissements Techniques

Réponses aux questions architecturales sur l'exécution côté client, la sécurité, l'indexation et les performances.

Comment fonctionne VertiWiki sans compilation sur serveur ? +

VertiWiki s'exécute à 100% dans le navigateur du client. Lorsqu'une page est demandée, il télécharge le fichier Markdown brut via fetch(), extrait le frontmatter YAML, applique les hooks du pipeline, compile avec Marked v15, assainit avec DOMPurify et monte le résultat dans le DOM en moins de 2 millisecondes.

Comment fonctionne la résolution des liens relatifs dans les sous-dossiers ? +

VertiWiki intègre un transformateur automatique de liens (router.transformLinks()) qui calcule les chemins relatifs selon l'emplacement du fichier actif, garantissant que les liens Markdown et les images s'affichent fidèlement quelle que soit la profondeur de l'arborescence.

En quoi l'optimisation AEO aide-t-elle les agents et robots IA ? +

À chaque changement de page, VertiWiki génère automatiquement des microdonnées Schema.org TechArticle et BreadcrumbList en JSON-LD, met à disposition l'index structuré llms.txt conforme à la spécification AgentDocsSpec et propose un bouton dédié de copie Markdown pour les agents IA.

VertiWiki peut-il fonctionner complètement hors ligne ou en réseau isolé ? +

Oui. Toutes les feuilles de style, polices WOFF2, formules KaTeX et bibliothèques Mermaid sont intégrées directement dans le fichier index.html. Avec un serveur statique local (ex. python3 -m http.server), il fonctionne à 100% sans connexion internet.

Comment créer et charger des préréglages de thèmes personnalisés ? +

Créez des fichiers JSON dans le dossier themes/ définissant les variables CSS pour les modes clair et sombre. Enregistrez-les dans config.json sous "customThemes" et ils deviennent immédiatement sélectionnables sans compilation de code.

Comment les moteurs de recherche indexent-ils VertiWiki sans SSR ? +

VertiWiki intègre un Arbre Sémantique de Crawl directement dans le shell HTML initial. Les robots de recherche comme Googlebot découvrent des liens hypertextes classiques vers chaque document dès la première requête HTTP.

Prêt à Découvrir la Documentation Zero-Backend ?

Explorez le portail de documentation VertiWiki directement dans votre navigateur ou inspectez le code source sur GitHub.

Ouvrir la Documentation Dépôt GitHub