l’outil de commande Hugo new pour créer site, thème et contenu

Le framework Hugo fournit un outil de commande très utile afin d’automatiser la création de contenu. En réalité, cet outil n’est pas indispensable, car vous pourriez créer un site, un thème ou même un article en créant les bons dossiers et les bons fichiers. Seulement ce travail manuel est assez long et chronophage. Voilà pourquoi la commande Hugo est très utilisée, car elle permet de créer un site de base pour le framework Hugo avec toute l’architecture des dossiers et des fichiers créé pour vous. Même chose pour la création des thèmes. Pour les articles cela permet de préremplir les métadonnées des articles comme la date de création, le champ titre un champ de catégorie, etc.

Cette commande doit être lancée dans le répertoire courant du site web géré par Hugo ou dans le répertoire que vous désirez pour créer un site web gérer par le framework Hugo. la fameuse commande ressemble à ceci :

hugo new [element]  

Ce que j’ai noté entre crochés : [élement] représente l’élément à générer que vous pouvez trouvez-ci dessous.

Génération de site

Hugo new site nom_du_site  

Cette commande permet de générer un site web de base avec l’architecture des dossiers utiles pour le bon fonctionnement du framework Hugo. Vous devrez modifier « nom_du_site » par le nom du dossier représentant votre projet (attention aux espaces et au caractère spéciaux).

Une fois le site généré, n’oubliez pas de vous rendre dans le dossier créé. Sinon en cas d’utilisation de la commande Hugo, vous ne serez pas au bon endroit pour générer votre contenu ou réaliser d’autre action.

cd nom_du_site/  

Génération de contenu

hugo new posts/mon-article.md  

Cette commande créer un fichier dans le répertoire « content/posts » de votre site courant (vérifiez bien que vous vous trouvez dans le répertoire de votre site avant de créer un contenu).

La génération d’article par Hugo vous assiste en créant lui-même les méta données de votre article comme la date de création, le titre, etc.

Pour ajouter un automatisme de création de métadonnées lors de l’utilisation de cette commande, il faudra vous référer au dossier archétype. Le dossier archétype peut contenir des modèles de création d’articles utilisés lors de l’appel à la commande Hugo new mon-articles.md

Génération de thème

hugo new theme nom_du_theme  

Cette commande doit être utilisée dans le dossier de votre site web géré par Hugo. Elle génère un dossier « nom_du_theme » dans le dossier « themes » de votre site avec toute l’architecture nécessaire au bon fonctionnement d’un thème sous Hugo.