Structure de Dossier

Échafaudage de Nouveau Site

Le lancement du générateur hugo new site à partir de la ligne de commande créera une structure de dossier avec les éléments suivants :

.
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── static
└── themes

Explication de la Structure du Dossier

Ce qui suit est un survol de chacun des dossiers avec les liens vers leurs sections respectives dans la documentation Hugo.

archetypes

Vous pouvez créer de nouveaux fichiers de contenu dans Hugo en utilisant la commande hugo new. Par défaut, hugo créera de nouveaux fichiers de contenu avec au moins date,title (déduits du nom du fichier) et draft = true. Cela permet d’économiser du temps et favorise la cohérence des sites utilisant plusieurs types de contenu. Vous pouvez aussi créer vos propres archétypes avec des champs personnalisés de front matter pré-configurés.

config.toml

Chaque projet Hugo devrait avoir un fichier de configuration à la racine au format TOML, YAML ou JSON. De nombreux sites peuvent nécessiter peu ou pas de configuration, mais Hugo est livré avec un grand nombre de directives de configuration pour des instructions plus détaillées sur la façon dont vous voulez que Hugo construise votre site web.

content

Tout le contenu de votre site web vivra dans ce dossier. Chaque dossier au plus haut niveau dans Hugo est considéré comme une section de contenu. Par ex., si votre site a trois sections principales —blog, articles, et tutoriels—vous aurez trois dossiers sur content/blog, content/articles, and content/tutoriels. Hugo utilise les sections pour assigner des types de contenus par défaut.

data

Ce répertoire est utilisé pour stocker des fichiers de configuration pouvant être utilisés par Hugo lors de la génération de votre site. Vous pouvez écrire ces fichiers au format YAML, JSON ou TOML. En plus des fichiers que vous ajoutez à ce dossier, vous pouvez également créer modèles de données qui extraient du contenu dynamique.

layouts

Stocke les modèles sous la forme de fichiers .html qui spécifient comment les vues de votre contenu seront rendues dans un site web statique. Les modèles incluent des pages de listes, votre page d’accueil, des modèles de taxonomie, des partiels, des modèles de page unique, et plus encore.

static

stocke tout le contenu statique pour votre futur site : images, CSS, JavaScript, etc. Lorsque Hugo construit votre site, tous les actifs de votre dossier statique sont copiés tels quels. Un bon exemple d’utilisation du dossier static est la vérification de la propriété du site sur la Console de Recherche Google, où vous voulez que Hugo copie un fichier HTML complet sans modifier son contenu.