TechDocsCove ^fr   ↩︎

# Démarrer avec Hugo, générateur de sites statiques (SSG)

Hugo est un générateur de sites statiques (SSG) populaire qui simplifie la création de sites web. Voici un guide minimal sur l’utilisation de Hugo :

Installation

1. Téléchargement de Hugo : Visitez la page des versions de Hugo et téléchargez la version appropriée pour votre système d’exploitation.

2. Installation de Hugo : Suivez les instructions d’installation pour votre système d’exploitation. Par exemple, sous Linux, extrayez le fichier téléchargé et déplacez le binaire vers un répertoire dans le PATH de votre système.

Création d’un nouveau site

1. Initialiser le site : Ouvrez votre terminal et accédez à l’emplacement désiré. Exécutez hugo new site <nomdusite> pour créer un nouveau site Hugo.

2. Choisir un thème : Parcourez la galerie de thèmes de Hugo et choisissez un thème qui vous plaît. Ajoutez-le à votre site en suivant les instructions d’installation du thème.

Ajout de contenu

1. Créer du contenu : Utilisez hugo new <type-de-contenu>/<nom-du-contenu>.<extension> pour générer de nouveaux fichiers de contenu comme des articles ou des pages.

2. Éditer le contenu : Ouvrez les fichiers de contenu dans un éditeur de texte et ajoutez votre contenu en utilisant Markdown ou un autre format pris en charge.

Personnalisation

1. Configuration : Personnalisez la configuration de votre site en modifiant le fichier config.toml dans le répertoire racine. Définissez des paramètres de base comme le titre du site, la langue et d’autres préférences.

2. Mise en page personnalisée : Pour une personnalisation avancée, créez ou modifiez des modèles dans le répertoire layouts pour changer l’apparence de votre site.

Construction et Prévisualisation

1. Construire le site : Exécutez hugo dans le terminal depuis le répertoire de votre site. Hugo générera les fichiers de votre site statique dans le répertoire public.

2. Prévisualisation : Utilisez hugo server -D pour démarrer un serveur local et visualiser votre site dans un navigateur web à l’adresse http://localhost:1313. Le drapeau -D inclut le contenu marqué comme brouillon.

Déploiement

1. Choisir un hébergement : Sélectionnez un fournisseur d’hébergement pour votre site statique. Parmi les options populaires, on retrouve Netlify, GitHub Pages ou AWS S3.

2. Télécharger les fichiers : Téléchargez le contenu du répertoire public généré par Hugo sur le fournisseur d’hébergement choisi pour mettre votre site en ligne.

La simplicité et la rapidité de Hugo en font un excellent choix pour créer facilement des sites web statiques.

Créé le: déc. 29, 2023