Utilisation des archetypes avec le framework Hugo

L’archétype est un outil optionnel utilisé uniquement dans la génération de contenu à l’aide de l’outil de commande Hugo cli.

À quoi servent les archétypes ?

Les archétypes sont des modèles de page prédéfinis afin de faciliter la création de pages comme des articles ou des pages simples. Les archétypes permettent de précompléter les informations du front matter (les métadonnées comme la date de création, catégorie, titre) mais aussi la structure du contenu de la page créé en ligne de commande.

L’utilisation des archétypes n’est pas obligatoire. Elle permet simplement de gagner du temps dans la création de contenu. On pourrait faire le parallèle entre des modèles enregistrés de projet (lettre, CV, emploi du temps) dans des logiciels d’édition de documents

Fonctionnement.

Quand vous entrez la commande suivante afin de créer un contenu :

hugo new  

Hugo va rechercher l’archétype correspondant au contenu produit. Il faut savoir que la création de contenu est réalisée dans le dossier content/. De ce fait, quand un article est créé dans le dossier content/posts, le fichier archétype/posts.md sera utilisé lors de la création.

Si le fichier archétype posts.md n’existe pas ou si le contenu est créé à la racine de content, alors le fichier archétype default.md sera choisi.

Exemple de correspondance

Contenu	archetype
content/	archétype/default.md
content/posts	archétype/posts.md
content/film	archétype/film.md

Exemple d’utilisation

 Création du fichier : archétype/posts.md

---  
title = "{{ replace .Name "-" " " | title }}"  
date = {{ .Date }}  
draft = true  
---

Contenu de l'article ici.  

Ce fichier archétype sera utilisé lors de la commande suivante de création de contenu :

hugo new posts/mon-article  

Le rendu final de l’article crée dans content/posts/mon-article.md :

---  
title = "Mon Article"  
date = 2022-03-10T00:00:00+01:00  
draft = true  
---

Contenu de l'article ici.