Chronos

Une seule adresse pour tout documenter

À mesure que les projets s’accumulaient, la documentation s’éparpillait : un README ici, une page de site là. Chronos les réunit sur docs.salks.me. Chaque projet garde sa couleur et son nom de code, et la doc se lit de la même façon de l’un à l’autre.

Ce qu’on y trouve

• Une page d’accueil par projet : présentation, points forts, liens (site, dépôt, Discord, téléchargement) et un sommaire tiré automatiquement de la doc, avec le titre et le premier paragraphe de chaque page.
• La doc elle-même, écrite en Markdown, avec ses encadrés (astuce, attention, danger) et sa barre latérale.
• Les projets Minecraft, présentés dans une grille qu’on filtre par type (mod, plugin, pack, outil), par plateforme ou par recherche. Chaque mod ou plugin a sa propre doc.
• Deux langues, le français et l’anglais, avec un sélecteur dans la barre de navigation. Ce qui n’est pas encore traduit retombe sur le français.

La Pythie

Le bouton en bas à droite ouvre la Pythie, qui répond aux questions à partir de la doc.

Par défaut, elle travaille entièrement dans le navigateur : au moment du build, Chronos génère un index de toutes les sections ; le navigateur le télécharge à la première question et cherche les passages les plus proches, sans accents et en tenant compte des familles de mots. Aucune question ne quitte l’appareil.

En mode IA, la recherche est refaite côté serveur, puis un petit modèle ouvert rédige une réponse courte à partir des seuls passages trouvés, affichés en sources sous la réponse. Si l’IA ne répond pas, la Pythie revient à la recherche locale.

Comment c’est construit

Chronos est un Docusaurus 3 entièrement redessiné aux couleurs de mes vitrines : fond encre, titres en serif, filets fins plutôt que cartes, sombre et clair. Les pages d’accueil sont générées par un plugin à partir d’un seul fichier de données. Le site est servi par un Worker Cloudflare, qui ajoute la route de la Pythie en mode IA.