Comment construire un site statique très rapide avec Hugo
Hugo est un générateur de site statique (SSG) écrit en go (alias golang), un langage de programmation compilé haute performance qui est souvent utilisé pour développer des applications et des services d’arrière – plan. Aujourd’hui, Hugo peut générer la plupart des sites Web en quelques secondes <1 ms per pagina). Questo spiega perché Hugo si autodefinisce "il framework più veloce al mondo per la creazione di siti Web". In questo articolo, daremo un'occhiata alla storia di Hugo, cosa lo rende così veloce e come puoi iniziare a creare il tuo sito statico Hugo. Cos'è Hugo? E perché è popolare?
En tant que constructeur de site Web statique, Hugo utilise des fichiers de contenu à prix réduit, les exécute à travers des modèles de thème et génère des fichiers HTML qui peuvent être facilement distribués en ligne, et très rapidement. En 2021, il y a des dizaines, voire des centaines, de générateurs statiques. Chaque générateur de site statique a son propre charme. Jekyll est populaire parmi les développeurs Ruby et bien qu’il ne soit pas aussi rapide que les autres options, il a été l’un des premiers générateurs de site statique largement utilisés. Gatsby est un autre SSG populaire pour le développement de sites distribués statiquement avec des caractéristiques dynamiques.
Alors, avec tant de SSG, quelle est la différence avec Hugo? Hugo s’appelle \
Hugo est exécutable
Contrairement à Jekyll, Gatsby et d’autres SSG qui ont besoin d’un gestionnaire de paquets pour installer les dépendances, il est autonome. Cela signifie que vous pouvez télécharger et utiliser Hugo immédiatement sans vous soucier des dépendances logicielles. Dans la terminologie SSG de Hugo, il est facile de créer un modèle, et le terme « modèle » fait référence au processus d’ajout de substituants à une page HTML pour insérer du contenu dynamique. Pour accéder au titre de la page, vous pouvez utiliser la variable {title}}. Par conséquent, dans les modèles HTML Hugo, vous verrez généralement que {title}} est inclus dans l’étiquette H1 comme suit:
– Non.
Au moment de la compilation, Hugo récupère automatiquement le titre dans le fichier de contenu et l’insère entre les deux balises
. Hugo a une variété de variables de modèle intégrées, et vous pouvez même écrire des fonctions personnalisées pour traiter les données au moment de la compilation. Hugo crée des modèles en utilisant la Bibliothèque html \/ Templates et text \/ Templates intégrée à go. Cela aide à réduire les frais généraux de l’application, car Hugo n’a pas besoin d’installer des bibliothèques tierces pour créer des modèles. Voici un exemple de modèle d’index de page d’accueil. Html à partir du thème ananke populaire. Comme vous pouvez le voir, il ressemble à un fichier HTML standard avec un code de modèle supplémentaire:
À déterminer: obtenir le code à partir de: https:\/\/github.com\/theNewDynamic\/gohugo-theme-ananke Comment installer Hugo Hugo est un exécutable compilé, ce qui signifie que vous n’avez pas à télécharger et gérer de nombreuses dépendances pour commencer. Il s’applique à Mac OS, Windows et Linux. Important: les instructions d’installation suivantes nécessitent un gestionnaire de paquets qui téléchargera l’exécutable Hugo pour vous. Si vous préférez construire un logo à partir de la source du logo, consultez la documentation officielle du logo. Comment installer les méthodes d’installation mac os et Linux recommandées par Hugo sur mac os et Linux doit être fait maison
Divers nouveaux modules de support Hugo: vous permet de créer du nouveau contenu pour le site du serveur Hugo – démarrer le serveur de développement local de la version Hugo: afficher la version actuelle du CLI Hugo a également des drapeaux pour spécifier des options supplémentaires pour certaines commandes. Pour voir la liste complète des drapeaux Hugo (il y en a beaucoup), il est recommandé d’utiliser la commande d’aide Hugo pour afficher une liste de tous les drapeaux disponibles.
Les profils Hugo prennent en charge trois formats: YAML, toml et json. De même, le fichier de configuration de Hugo est config. Yml, configuration. Configuration toml. Json, vous pouvez le trouver dans le répertoire principal du projet Hugo. Profil de Hugo. Voici à quoi ressemble un profil Hugo typique au format YAML: defaultcontentlanguage: en Subject: – kinsta Static site contentdir: content layoutdir: Layouts Publisher: public paginate: 5title: kinsta Static Site Description: \
Il existe des dizaines d’options de configuration pour Hugo, qui peuvent être explorées dans la documentation officielle d’Hugo. Si vous devez modifier la configuration globale lors du développement d’un site Hugo, vous devrez peut – être modifier ce profil. Comment créer un site Hugo maintenant que nous avons expliqué comment installer et utiliser le CLI de Hugo et les bases du profil de Hugo, créons un nouveau site Hugo. Pour créer un site Hugo, utilisez la commande suivante (n’hésitez pas à changer mon site Hugo en autre chose si vous le souhaitez): nouveau site Hugo mon site Hugo
Créer un nouveau site Web Hugo.
Ensuite, allez dans le dossier du site et vous verrez les fichiers et dossiers suivants: fichiers de configuration. Toml, archetypes folder, content folder, Layout folder, theme folder, Data folder, and Static folder. Vérifions rapidement ce que sont ces fichiers et dossiers. Profil. Hugo toml comme indiqué ci – dessus, le profil principal de Hugo contient les paramètres globaux du site. Dossier des archétypes Hugo le dossier des archétypes est utilisé pour stocker des modèles de contenu au format markdown. Les prototypes sont particulièrement utiles si votre site a plusieurs formats de contenu. Avec le prototype Hugo, vous pouvez créer des modèles pour chaque type de contenu sur votre site. Cela vous permet de pré – compiler le fichier de réduction de prix généré en utilisant tous les paramètres de configuration nécessaires. Par exemple, si vous avez un type de contenu podcast pour voir des épisodes dans un podcast, vous pouvez créer un nouveau prototype dans le prototype \/ Podcast. MD, qui se lit comme suit: – – – titre: \
Pour les messages généralement ouverts, vous pouvez utiliser le dossier contenu pour organiser davantage le contenu des messages. Hugo traite chaque Répertoire de haut niveau dans un dossier de contenu comme une section de contenu. Le contenu de Hugo est en partie similaire au type de post personnalisé dans WordPress. Par exemple, si votre site contient des messages, des pages et des podcasts, votre dossier de contenu contiendra des répertoires de messages, de pages et de podcasts qui contiennent des fichiers de contenu pour ces différents types de messages. Dossier de mise en page Hugo le dossier de mise en page contient des fichiers HTML qui définissent la structure du site. Dans certains cas, vous pouvez voir que le site Hugo n’a pas de dossier de mise en page parce qu’il n’a pas besoin d’être dans le Répertoire racine du projet, mais peut être dans le dossier sujet. Comme pour les thèmes WordPress qui utilisent PHP pour créer des modèles, les modèles Hugo se composent de HTML de base et d’autres modèles dynamiques basés sur les bibliothèques html \/ Templates et text \/ Templates intégrées de golang. Vous trouverez dans le dossier Layouts les différents fichiers de modèles HTML nécessaires pour générer les balises HTML du site. Dossiers de sujets Hugo pour les sites Web qui préfèrent stocker des fichiers et des ressources de modèles de façon plus autonome, Hugo prend en charge les dossiers de sujets. Les thèmes Hugo sont similaires aux thèmes WordPress, ils sont stockés dans le catalogue des thèmes et contiennent tous les modèles nécessaires au travail du thème. Bien que certains utilisateurs de Hugo aiment enregistrer des fichiers liés au thème dans le répertoire principal du projet, il est plus facile de les gérer et de les partager en les stockant dans des dossiers de thème. Dossier de données Hugo le dossier de données Hugo est utilisé pour stocker d’autres données (formats json, YAML ou toml) nécessaires pour générer une page sur le site. Les fichiers de données sont utiles pour les grands ensembles de données parce que
Pour faciliter le développement, vous pouvez décorer avec un serveur Web intégré, ce qui signifie que vous n’avez pas besoin d’installer un serveur Web tiers, comme nginx ou Apache, juste pour voir votre site localement. Pour démarrer le serveur Web de Hugo, lancez la commande suivante dans le répertoire principal du projet: Hugo Server – D Hugo va créer la page du site Web et http:\/\/localhost:1313\/ – Oui. Hugo local development server. Si vous visitez une URL dans un navigateur Web, vous devriez voir le site Hugo avec le thème Hyde: Le site Web d’Hugo présente le thème Hyde. Par défaut, le serveur de développement local de Hugo vérifie les modifications et reconstruit automatiquement le site. Comme Hugo est construit très rapidement, les mises à jour du site peuvent être vues presque en temps réel, ce qui est rare dans le monde des générateurs de site statiques. Pour le prouver, nous avons créé le premier post sur Hugo. Comment ajouter du contenu au site Web d’hugo ajouter du contenu au site Web d’hugo est très différent des CMS complets comme WordPress ou ghost. Pour Hugo, il n’y a pas de couche CMS intégrée pour gérer votre contenu. Vous devriez plutôt gérer et organiser ce que vous jugez approprié. En d’autres termes, il n’y a pas de gestion « correcte » claire du contenu dans Hugo. Dans cette section, nous partagerons une façon d’ajouter et de gérer du contenu, mais à mesure que vous vous Familiarisez avec Hugo, vous pouvez changer le contenu à volonté. La section contenu d’Hugo dans Hugo, le premier outil d’organisation de contenu que vous pouvez utiliser est la section contenu. La partie Contenu du Hugo est similaire au type de post WordPress: Vous pouvez l’utiliser non seulement comme filtre de contenu, mais aussi comme identificateur lors de la création d’un thème personnalisé. Par exemple, si vous avez un dossier dans la section contenu du blog, vous pouvez l’utiliser pour stocker tous les billets de blog et
Optimiser les modèles de page spécifiques pour les messages de blog seulement. Comment ajouter un billet à Hugo en gardant cela à l’esprit, nous avons créé une section de contenu pour le billet de blog et ajouté un peu de contenu. Créez un nouveau dossier appelé post dans le dossier contenu du projet: C’est la section contenu. En créant le dossier 2021, nous avons créé un autre niveau d’organisation dans le dossier post. À ce stade, votre catalogue de contenu devrait ressembler à ceci: Catalogue de contenu Hugo. Maintenant, créons le premier post. Comme nous l’avons mentionné précédemment, Hugo prend en charge les réductions de prix et les fichiers HTML pour le contenu. En général, il est préférable de s’en tenir aux fichiers de balisage, car ils sont plus faciles à écrire, à formater et à lire. Dans le dossier content \/ posts \/ 2021, créez un nouveau fichier qui se termine par. MD (TAG file extension). Vous pouvez nommer des fichiers comme vous voulez, mais il est recommandé d’utiliser la syntaxe AAAA – MM – JJ – a – Sample – post pour nommer des fichiers de contenu Hugo. Docteur en médecine. En plus de créer manuellement des fichiers de contenu, vous pouvez utiliser le CLI de Hugo pour créer de nouveaux messages en utilisant la commande suivante (assurez – vous d’exécuter la commande à partir du Répertoire du projet): Hugo New posts \/ 2021 \/ 2021 – 08 – 30 – a – Sample – post. MD Notez qu’il manque un dossier de contenu dans le chemin ci – dessus. Ceci est dû au fait que Hugo suppose que tous les fichiers de contenu seront transférés dans le dossier de contenu par défaut. Si vous ouvrez un fichier de contenu nouvellement créé, vous devriez voir les lignes de métadonnées suivantes en haut du document: – titre: \
Pages – regardons comment personnaliser un site, comment changer le titre et la description, comment ajouter une page « À propos » au menu de la barre latérale, comment changer le format des liens permanents, et comment supprimer une page d’un flux de messages. Comment modifier le titre et la description d’un site Web la façon exacte de modifier le titre et la description d’un site Web dépend de la configuration du site et \/ ou du sujet de l’activité. Pour les sujets Hyde, vous pouvez modifier le titre et la description du site dans le fichier de configuration Hugo (config.toml). Nous le savons parce que le Code de sujet suivant présente la barre latérale: – Oui.
Bien que vous puissiez ajouter ce code HTML directement au fichier de contenu de l’étiquette, il est préférable de créer un raccourci pour voir n’importe quelle image dans le dossier de téléchargement. De cette façon, si vous devez mettre à jour l’étiquette IMG, vous pouvez modifier le modèle de code court sans changer chaque instance de l’étiquette img. Pour créer un modèle de code court, créez un nouveau fichier dans \/ Layouts \/ shortcode \/ img. HTML contenant: } Dans le modèle de code court, {.get \
Fichiers dans le dossier de projet original dans le nouveau dossier de dépôt github. Assurez – vous de supprimer le dossier public car il n’est pas nécessaire de le télécharger sur github. Copiez le projet dans le dossier du dépôt github. Si vous retournez à l’application github, vous devriez maintenant voir la liste des fichiers modifiés. Pour télécharger le dépôt sur github, ajoutez un résumé, cliquez sur COMMIT TO main, puis cliquez sur publish repository dans le coin supérieur droit. Soumettre le dépôt et le télécharger sur github. Par défaut, l’option keep this code Private est sélectionnée. Si vous voulez que votre code soit open source et accessible au public, n’hésitez pas à le décocher. Enfin, cliquez à nouveau sur publier le dépôt. Publier le dépôt github. Maintenant, si vous allez à github, vous devriez être en mesure de voir votre dépôt en ligne comme suit: Le dépôt de projets Hugo sur github. Comment lier github Repo à netlify si vous n’avez pas de compte netlify, inscrivez – vous ici. Pour lier le dépôt github à netlify, dans le tableau de bord netlify, cliquez sur nouveau site à partir de GIT. Nouveau site pour git sur netlify. Sous déploiement continu, sélectionnez l’option github. Sélectionnez github pour un déploiement continu. Ensuite, utilisez la boîte de recherche pour trouver le dépôt de projets Hugo. Trouvez le dépôt du projet Hugo. Ensuite, spécifiez les paramètres pour un déploiement continu. Comme netlify peut détecter les configurations de Hugo, les paramètres par défaut devraient fonctionner correctement pour les déploiements de base. Au fur et à mesure que vous vous Familiarisez avec Hugo, vous pouvez approfondir les variables d’environnement, les commandes de construction personnalisées, et plus encore. Actuellement, définir la commande Build à Hugo et le répertoire public à public vous permettra de déployer un site Hugo simple. Après avoir spécifié la commande Build et le répertoire public, cliquez sur deploy site. Publier le site Web d’Hugo sur netlify. Comme Hugo est un générateur de site statique rapide, il ne faut que quelques secondes pour déployer un site de base. Une fois que vous
Il existe des dizaines d’options de configuration pour Hugo, qui peuvent être explorées dans la documentation officielle d’Hugo. Si vous devez modifier la configuration globale lors du développement d’un site Hugo, vous devrez peut – être modifier ce profil. Comment créer un site Hugo maintenant que nous avons expliqué comment installer et utiliser le CLI de Hugo et les bases du profil de Hugo, créons un nouveau site Hugo. Pour créer un site Hugo, utilisez la commande suivante (n’hésitez pas à changer mon site Hugo en autre chose si vous le souhaitez): nouveau site Hugo mon site Hugo
Ensuite, allez dans le dossier du site et vous verrez les fichiers et dossiers suivants: fichiers de configuration. Toml, archetypes folder, content folder, Layout folder, theme folder, Data folder, and Static folder. Vérifions rapidement ce que sont ces fichiers et dossiers. Profil. Hugo toml comme indiqué ci – dessus, le profil principal de Hugo contient les paramètres globaux du site. Dossier des archétypes Hugo le dossier des archétypes est utilisé pour stocker des modèles de contenu au format markdown. Les prototypes sont particulièrement utiles si votre site a plusieurs formats de contenu. Avec le prototype Hugo, vous pouvez créer des modèles pour chaque type de contenu sur votre site. Cela vous permet de pré – compiler le fichier de réduction de prix généré en utilisant tous les paramètres de configuration nécessaires. Par exemple, si vous avez un type de contenu podcast pour voir des épisodes dans un podcast, vous pouvez créer un nouveau prototype dans le prototype \/ Podcast. MD, qui se lit comme suit: – – – titre: \
Pour les messages généralement ouverts, vous pouvez utiliser le dossier contenu pour organiser davantage le contenu des messages. Hugo traite chaque Répertoire de haut niveau dans un dossier de contenu comme une section de contenu. Le contenu de Hugo est en partie similaire au type de post personnalisé dans WordPress. Par exemple, si votre site contient des messages, des pages et des podcasts, votre dossier de contenu contiendra des répertoires de messages, de pages et de podcasts qui contiennent des fichiers de contenu pour ces différents types de messages. Dossier de mise en page Hugo le dossier de mise en page contient des fichiers HTML qui définissent la structure du site. Dans certains cas, vous pouvez voir que le site Hugo n’a pas de dossier de mise en page parce qu’il n’a pas besoin d’être dans le Répertoire racine du projet, mais peut être dans le dossier sujet. Comme pour les thèmes WordPress qui utilisent PHP pour créer des modèles, les modèles Hugo se composent de HTML de base et d’autres modèles dynamiques basés sur les bibliothèques html \/ Templates et text \/ Templates intégrées de golang. Vous trouverez dans le dossier Layouts les différents fichiers de modèles HTML nécessaires pour générer les balises HTML du site. Dossiers de sujets Hugo pour les sites Web qui préfèrent stocker des fichiers et des ressources de modèles de façon plus autonome, Hugo prend en charge les dossiers de sujets. Les thèmes Hugo sont similaires aux thèmes WordPress, ils sont stockés dans le catalogue des thèmes et contiennent tous les modèles nécessaires au travail du thème. Bien que certains utilisateurs de Hugo aiment enregistrer des fichiers liés au thème dans le répertoire principal du projet, il est plus facile de les gérer et de les partager en les stockant dans des dossiers de thème. Dossier de données Hugo le dossier de données Hugo est utilisé pour stocker d’autres données (formats json, YAML ou toml) nécessaires pour générer une page sur le site. Les fichiers de données sont utiles pour les grands ensembles de données parce que
Pour faciliter le développement, vous pouvez décorer avec un serveur Web intégré, ce qui signifie que vous n’avez pas besoin d’installer un serveur Web tiers, comme nginx ou Apache, juste pour voir votre site localement. Pour démarrer le serveur Web de Hugo, lancez la commande suivante dans le répertoire principal du projet: Hugo Server – D Hugo va créer la page du site Web et http:\/\/localhost:1313\/ – Oui. Hugo local development server. Si vous visitez une URL dans un navigateur Web, vous devriez voir le site Hugo avec le thème Hyde:
Optimiser les modèles de page spécifiques pour les messages de blog seulement. Comment ajouter un billet à Hugo en gardant cela à l’esprit, nous avons créé une section de contenu pour le billet de blog et ajouté un peu de contenu. Créez un nouveau dossier appelé post dans le dossier contenu du projet: C’est la section contenu. En créant le dossier 2021, nous avons créé un autre niveau d’organisation dans le dossier post. À ce stade, votre catalogue de contenu devrait ressembler à ceci:
Pages – regardons comment personnaliser un site, comment changer le titre et la description, comment ajouter une page « À propos » au menu de la barre latérale, comment changer le format des liens permanents, et comment supprimer une page d’un flux de messages.
Bien que vous puissiez ajouter ce code HTML directement au fichier de contenu de l’étiquette, il est préférable de créer un raccourci pour voir n’importe quelle image dans le dossier de téléchargement. De cette façon, si vous devez mettre à jour l’étiquette IMG, vous pouvez modifier le modèle de code court sans changer chaque instance de l’étiquette img. Pour créer un modèle de code court, créez un nouveau fichier dans \/ Layouts \/ shortcode \/ img. HTML contenant: } Dans le modèle de code court, {.get \
Fichiers dans le dossier de projet original dans le nouveau dossier de dépôt github. Assurez – vous de supprimer le dossier public car il n’est pas nécessaire de le télécharger sur github. Copiez le projet dans le dossier du dépôt github. Si vous retournez à l’application github, vous devriez maintenant voir la liste des fichiers modifiés. Pour télécharger le dépôt sur github, ajoutez un résumé, cliquez sur COMMIT TO main, puis cliquez sur publish repository dans le coin supérieur droit. Soumettre le dépôt et le télécharger sur github. Par défaut, l’option keep this code Private est sélectionnée. Si vous voulez que votre code soit open source et accessible au public, n’hésitez pas à le décocher. Enfin, cliquez à nouveau sur publier le dépôt. Publier le dépôt github. Maintenant, si vous allez à github, vous devriez être en mesure de voir votre dépôt en ligne comme suit: