À propos

sitelo n’a pas commencé comme un framework. C’est parti de l’envie d’écrire du balisage d’une manière qui semble naturelle en JavaScript — et cela n’a cessé de grandir jusqu’à couvrir tout le chemin, du fichier de page au site livré.

javascript-to-html

Il y a d’abord eu javascript-to-html (aussi connu sous le nom de ht.js) : une façon simple et intuitive de générer du HTML en JavaScript, sans moteur de gabarit complexe ni framework.

Vu à quel point les frameworks complets comme React étaient devenus omniprésents, trouver une solution de gabarits simple qui n’embarque pas tout l’attirail était étonnamment difficile. En se concentrant uniquement sur la transformation de JavaScript en HTML — au fond, des fonctions qui renvoient des chaînes —, ht.js reste léger, facile à utiliser, souple et extensible.

Cette surface réduite lui permet de s’insérer à bien des endroits : directement dans le frontend (façon SPA), dans un build pour créer des sites statiques (SSG), ou même pour du rendu côté serveur (SSR).

Apprendre à Vite à produire du HTML

Cela réglait l’écriture. Le problème suivant était le build : Vite traite les .js / .ts comme des scripts, pas comme des pages. Il fallait une convention où certains modules étaient destinés à devenir du HTML.

L’idée était directe : les fichiers nommés *.ht.js, *.html.js, *.ht.ts et consorts devraient être transformés en HTML plutôt qu’empaquetés comme du JavaScript client. Cette convention est devenue vite-plugin-html-pages — routage par fichiers, chargement de données, ressources et génération statique par-dessus Vite.

sitelo

sitelo réunit Vite et ce plugin en une seule installation et une seule CLI. Vous obtenez une expérience de développement complète et soignée : sitelo pour un serveur en direct, sitelo build pour la production, des valeurs par défaut sensées et le modèle de pages du plugin, sans avoir à assembler vous-même la chaîne d’outils.

La même idée de bout en bout : les pages sont des modules qui renvoient du HTML. sitelo est la couche qui rend cette idée aboutie.

Comment il se compare

Beaucoup de bons outils publient déjà des sites statiques. La niche de sitelo est étroite à dessein : des fonctions JavaScript (ou TypeScript) qui renvoient du HTML, avec l’expérience de développement de Vite, et le moins de framework possible.

OutilModèleÀ choisir quand
siteloFonctions JS/TS → HTML sur ViteVous voulez du HTML issu de JavaScript avec un vrai flux de travail Vite — sans framework à composants
AstroComposants + îlots, compilateur maisonSites de contenu qui veulent des îlots de composants et un écosystème plus vaste
Next.jsApplication React complète (SSR / SSG / ISR)Vous construisez une application dans l’écosystème React
HugoGabarits Go, builds très rapidesTrès gros sites de contenu et vous êtes à l’aise avec l’outillage Go
EleventyLangages de gabarits → HTMLVous voulez des gabarits souples (Nunjucks, Liquid, …) sans framework SPA

Si vous voulez des composants, de l’hydratation et un framework — prenez un framework. Si vous voulez des fichiers HTML issus de fonctions JavaScript avec l’expérience Vite, sitelo est le plus petit outil qui fait tout le travail.

Lire la documentation · GitHub