Projet open source
11ty/buildawesome avatar
11ty/buildawesome

Build Awesome : générateur de site statique en JavaScript

Un générateur de site plus simple. Transforme un répertoire de modèles (de différents types) en HTML.

19 911 étoiles589 forksJavaScriptMIT

En bref

De quoi s’agit-il ?
Build Awesome, distribué sous les paquets npm @awesome.me/buildawesome et @11ty/eleventy, transforme des répertoires de gabarits en HTML. Il supporte HTML, Markdown, JavaScript, Liquid et Nunjucks nativement, avec des extensions pour WebC, Sass, Vue, Svelte, TypeScript et JSX.
À qui s’adresse-t-il ?
Build Awesome convient à ceux qui construisent des sites statiques en JavaScript et qui souhaitent un alternative à Jekyll avec gestion flexible des formats de gabarit. Le projet compte 19800+ étoiles, maintient une feuille de route communautaire basée sur les votes des utilisateurs, et exécute quatre suites de tests distinctes pour assurer la qualité.
Puis-je l’utiliser commercialement ?
Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
Est-il encore maintenu ?
Oui. Les derniers commits datent d’il y a 1 jour.
En quel langage est-il écrit ?
Principalement JavaScript, d’après les statistiques de langage de GitHub.

Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.

ANALYSE OPEN SOURCE APPROFONDIE

Alternative JavaScript à Jekyll pour la génération statique

Build Awesome est un générateur de site statique écrit en JavaScript qui transforme un répertoire de gabarits en HTML. Le projet se présente comme une alternative plus simple à Jekyll, l'outil classique du même genre écrit en Ruby. Le dépôt GitHub 11ty/buildawesome porte 19868 étoiles et 588 forks, signalant une adoption substantielle dans la communauté des développeurs web. Le README indique explicitement que Build Awesome fonctionne avec HTML, Markdown, JavaScript, Liquid et Nunjucks comme formats de gabarit natifs.

L'outil est distribué sous deux paquets npm distincts : @awesome.me/buildawesome et @11ty/eleventy, présentés comme rétrocompatibles l'un avec l'autre. Le README n'explique pas le contexte de ce double nommage ni s'il est temporaire ou définitif. La dernière fusion sur le dépôt date de juillet 2026, indiquant un projet en développement actif.

Formats de gabarit natifs et extensions pour WebC, Sass, Vue

Build Awesome compile nativement HTML, Markdown, JavaScript, Liquid et Nunjucks directement vers HTML sans dépendances externes. Le README énumère WebC, Sass, Vue, Svelte, TypeScript et JSX comme extensions disponibles, mais ne fournit pas de liste complète ni d'instructions d'installation pour chacune.

Un site peut mélanger Markdown pour les billets de blog, Nunjucks pour les gabarits de mise en page, et Vue pour les composants interactifs dans un seul projet. La compilation étape par étape signifie qu'un fichier .vue écrit pour Build Awesome suit le même pipeline que les fichiers .md, sans nécessiter de configuration de transition entre les formats.

Installation via npm avec instructions de démarrage externalisées

L'installation s'effectue par 'npm install @awesome.me/buildawesome --save-dev' ou 'npm install @11ty/eleventy --save-dev'. Après l'installation, le README renvoie vers un guide de démarrage hébergé sur www.11ty.dev/docs/getting-started/ plutôt que de fournir les commandes de construction directement.

Le README du dépôt GitHub ne contient pas les étapes suivantes : aucune commande 'npm run build', aucun aperçu local 'npm run serve'. Quiconque suit le README jusqu'à 'npm install' s'arrête à un point où le projet fonctionnellement complet mais encore non documenté dans ce fichier.

Quatre suites de tests : ava, Node.js, Vitest navigateur, buildbenchmark

Build Awesome exécute ava dans le répertoire 'test/' avec les assertions du framework ava. Une deuxième suite dans 'test_node/' utilise le module 'node:test' intégré, permettant à chaque commit de vérifier que Build Awesome fonctionne avec l'API de test native de Node.js sans dépendance externe.

Vitest en mode navigateur couvre 'packages/browser/test/', validant que les extensions Vue et WebC génèrent du code client exécutable dans les navigateurs. Le dépôt 11ty/buildbenchmark, hébergé séparément, benchmarke les performances entre versions pour détecter les ralentissements. Ces quatre suites s'exécutent dans GitHub Actions, avec les résultats de couverture enregistrés dans 'docs/coverage.md'.

Enhancement Queue : demandes de fonctionnalités triées par votes

Build Awesome publie une Enhancement Queue dans GitHub Discussions où les utilisateurs votent sur les fonctionnalités demandées. Zach Leatherman, l'auteur principal, vérifie régulièrement l'ordre des votes pour guider les travaux futurs.

Les bogues ouverts sur GitHub Issues sont étiquetés 'bug' et triés par nombre de réactions. Un bogue avec 100 réactions remonte généralement au-dessus d'un bogue avec 5 réactions, bien que cela ne garantisse pas un ordre de correction, seulement une visibilité publique. Le README énumère ces deux listes mais reconnaît explicitement qu'elles ne constituent pas des engagements de livraison.

Documentation des plugins externalisée vers www.11ty.dev/docs/plugins/

Le README contient une phrase unique : 'See the official docs on plugins (https://www.11ty.dev/docs/plugins/).' Aucun exemple de plugin, aucun nom de projet utilisant l'extension WebC, aucune note de rupture entre les versions de plugin n'apparaît dans le dépôt.

Un utilisateur qui souhaite intégrer Sass ou JSX consulte donc le site officiel 11ty.dev plutôt que GitHub, ce qui signifie que la documentation de référence réside en dehors du dépôt source. GitHub Issues reste le canal pour rapporter les défaillances d'un plugin, mais les instructions d'installation et d'utilisation proviennent d'ailleurs.

Réseau social décentralisé, Discord, YouTube et Bluesky pour le suivi communautaire

Le README liste cinq canaux : @11ty@neighborhood.11ty.dev sur un réseau social décentralisé, @11ty.dev sur Bluesky, un serveur Discord avec lien d'invitation, une chaîne YouTube (EleventyVideo), et GitHub. Les utilisateurs choisissent le réseau qui leur convient plutôt que d'avoir un seul fil d'annonces.

Le README demande également aux lecteurs de 'star' le dépôt, un signal social visible que GitHub intègre dans le classement de popularité des projets. Annoncer une version majeure signifie potentiellement publier sur cinq plateformes pour atteindre l'ensemble de la communauté.

Licence MIT de 2017 à 2024 attribuée à Zach Leatherman

Build Awesome est fourni sous licence MIT, attribuée à Zach Leatherman (@zachleat) de 2017 à 2024. La licence autorise l'utilisation, copie, modification, fusion, publication, distribution, sous-licence et vente, à condition que les notices de copyright restent incluses. Elle exclut les garanties et limite la responsabilité.

Le projet n'utilise pas d'organisation GitHub mais attribue la licence à un individu, reflétant son origine comme travail personnel devenu populaire. La licence ne couvre pas les garanties de support, les calendriers de maintenance ou les pratiques de sécurité, qui relèvent de négociations externes.

Conclusion éditoriale

Build Awesome convient à ceux qui construisent des sites statiques en JavaScript et qui souhaitent un alternative à Jekyll avec gestion flexible des formats de gabarit. Le projet compte 19800+ étoiles, maintient une feuille de route communautaire basée sur les votes des utilisateurs, et exécute quatre suites de tests distinctes pour assurer la qualité. Avant d'adopter le projet, testez une conversion d'un de vos gabarits existants en utilisant un format de langue supporté.

Sources officielles

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Notes de la communauté

Notes de la communauté