ZenithDocs

ZenithDocs transforme un dossier de fichiers Markdown et MDX en un site de documentation rapide. Un fichier de configuration et quelques pages suffisent : aucun projet Astro n’est nécessaire, et une seule commande crée le site, avec son thème et ses dépendances.

Le moteur embarque tout ce qu’on attend d’une documentation moderne : recherche plein texte, internationalisation avec repli pour les pages non traduites, versioning, pages de référence générées depuis une spécification OpenAPI, llms.txt pour les outils d’IA, et une image Open Graph générée pour chaque page.

La documentation du projet est elle-même construite avec ZenithDocs, et démontre chaque fonctionnalité au fil des pages, jusqu’à un générateur de thème interactif.

Architecture

Chaque page est prérendue en HTML et CSS. La sidebar, le sommaire, les accordéons et les arborescences de fichiers fonctionnent sans JavaScript, grâce à l’API Popover notamment ; le peu de code envoyé au navigateur est réservé aux interactions qui en ont vraiment besoin, et la recherche Pagefind n’est chargée qu’à son ouverture.

Le Markdown passe par le pipeline Sätteri écrit en Rust, et le code est coloré au build par Shiki. Les styles reposent sur les tokens Lumos et les couches CSS, pour que le CSS d’un projet l’emporte toujours ; cinq thèmes, sept paires de polices, des surcharges de composants et des slots complètent la personnalisation. Le site se déploie sur n’importe quel hébergeur statique, ou dans une image Docker d’environ 30 Mo.