Voici comment installer SiteFab, créer un nouveau site et le compiler en moins de 30 secondes :
# install the main package
pip install sitefab
spacy download en_core_web_sm
pip install -U spacy-lookups-data
# clone the site template as base
git clone https://github.com/ebursztein/sitefab-template.git mysite/
# clone the plugins in your site directory
git clone https://github.com/ebursztein/sitefab-plugins.git mysite/plugins
# generate your shiny new site
sitefab -c mysite/config/sitefab.yaml generate
Et voilà ! vous savez que vous avez un site entièrement fonctionnel qui peut être compilé statiquement. Comme prochaine étape, vous devez ajouter votre contenu, personnaliser les modèles HTML et modifier la configuration des plugins à votre guise !
Voici quelques-unes des fonctionnalités clés de haut niveau qui font de SiteFab le générateur statique de choix pour les sites Web modernes :
<picture>
, des versions webp pour les navigateurs qui le prennent en charge, une vignette figée pour le chargement. et des vignettes recadrées pour les aperçus.Outre ses caractéristiques techniques, ce qui différencie SiteFab des autres générateurs de sites, ce sont ses principes directeurs :
Configuration sur convention : chaque comportement est explicitement spécifié. Il n'y a pas de fichiers ou de répertoires spéciaux. SiteFab ne fait que ce que dit la configuration du site. Rien de plus, rien de moins.
Indépendant du contenu : il n'existe qu'un seul type de contenu appelé publication. SiteFab ne fait aucune hypothèse sur le contenu stocké dans les fichiers .md. Son travail consiste à appliquer la configuration spécifiée dans le frontmatter pour restituer les fichiers spécifiques et garantir que les plugins activés sont correctement exécutés.
Atomicité : chaque élément de contenu est autonome en ayant sa propre configuration dans son frontmatter, y compris le modèle à utiliser. Cela permet d'accueillir à la fois des sites complexes avec une configuration par page et des sites très simples qui réutilisent le même modèle encore et encore.
Orthogonalité : La configuration du site, les plugins et la configuration des plugins sont indépendants du moteur principal, vous pouvez donc utiliser autant de configurations et de plugins modifiés que vous le souhaitez. De plus, vous pouvez les vérifier avec le contenu de votre site pour avoir une construction reproductible, des restaurations sécurisées et une version simultanée du pipeline de construction (par exemple alpha contre stable).
Voici quelques alternatives populaires si SiteFab n’est pas ce que vous recherchez :
Jekyll : le site généré le plus populaire, écrit en Ruby
.
Hugo : Un générateur de site populaire, écrit en Go
et axé sur la vitesse.
Pelican : Un autre générateur de site écrit en Python
.