crée un blog de randonnée avec hugo (golang)
- User
crée un blog de randonnée avec hugo (golang)
- Assistant
Créer un blog de randonnée avec Hugo (un générateur de site statique construit en GoLang) est une excellente idée car Hugo est rapide, flexible et facile à utiliser. Voici un guide étape par étape pour vous aider à démarrer :
Prérequis :
- Installer Hugo : Assurez-vous d'avoir Hugo installé sur votre machine. Vous pouvez suivre les instructions sur le site officiel.
- Git : Il est souvent utile d’utiliser Git pour gérer votre code source.
- Text Editor : Un éditeur de texte de votre choix, comme VS Code, Sublime Text, ou même Vim.
Étape 1 : Créer un nouveau site Hugo
Ouvrez votre terminal et exécutez la commande suivante pour créer un nouveau site Hugo :
hugo new site mon-blog-de-randonnee cd mon-blog-de-randonneeÉtape 2 : Choisir et installer un thème
Hugo offre une large variété de thèmes que vous pouvez utiliser. Rendez-vous sur le dépôt des thèmes Hugo et choisissez-en un qui vous plaît.
Pour cet exemple, utilisons le thème Beautiful Hugo. Suivez les instructions d'installation :
git init git submodule add https://github.com/halogenica/beautifulhugo.git themes/beautifulhugoEnsuite, configurez Hugo pour utiliser ce thème. Ouvrez
config.tomlet ajoutez :theme = "beautifulhugo"Étape 3 : Configurer votre site
Éditez le fichier
config.tomlpour personnaliser votre blog. Voici un exemple de base :baseURL = "http://example.org/" languageCode = "fr-fr" title = "Mon Blog de Randonnée" theme = "beautifulhugo"Vous pouvez ajouter plus d'options de configuration comme le menu, les réseaux sociaux, etc. en fonction des options offertes par le thème.
Étape 4 : Créer des contenus
Créez un nouveau post en utilisant le modèle par défaut :
hugo new posts/ma-premiere-randonnee.mdOuvrez le fichier créé dans
content/posts/ma-premiere-randonnee.mdet modifiez-le avec votre contenu :--- title: "Ma Première Randonnée" date: 2023-10-01T10:00:00Z draft: true --- Aujourd'hui, je vais partager avec vous mon expérience de randonnée à travers les bois...Remarque : Changez
draft: trueendraft: falselorsque vous êtes prêt à publier l'article.Étape 5 : Prévisualiser votre site
Vous pouvez prévisualiser votre site localement avant de le déployer :
hugo serverOuvrez http://localhost:1313 dans votre navigateur pour voir votre blog.
Étape 6 : Générer les fichiers statiques
Lorsque vous êtes prêt à déployer votre blog, générez les fichiers statiques avec :
hugoLes fichiers générés se trouvent dans le dossier
public/. Vous pouvez ensuite les déployer sur n’importe quel service d’hébergement de sites statiques, comme GitHub Pages, Netlify, Vercel, etc.Étape 7 : Déployer votre site (Optionnel)
Pour déployer votre site sur Netlify, par exemple :
- Connectez-vous à Netlify et créez un nouveau site.
- Connectez Netlify à votre dépôt GitHub contenant votre site Hugo.
- Configurez les paramètres de déploiement et spécifiez le répertoire public (
public/) comme le répertoire de publication.
Et voilà ! Vous devriez maintenant avoir un blog de randonnée entièrement fonctionnel utilisant Hugo.
Ressources supplémentaires
N'hésitez pas à personnaliser davantage votre blog et à ajouter de nouvelles pages, fonctionnalités et styles. Bonne randonnée blogistique ! 🚶♂️🏞️
- User
continu
- Assistant
Bien sûr, poursuivons avec des étapes supplémentaires pour affiner et améliorer votre blog de randonnée Hugo :
Étape 8 : Personnaliser et étendre votre site
8.1 Personnaliser l'apparence
Pour personnaliser l’apparence de votre site, explorez les fichiers de thème situés dans le dossier
themes/beautifulhugo. Vous pouvez apporter des modifications aux fichiers HTML et CSS pour adapter le thème à vos goûts.Exemple de personnalisation du fichier CSS : Modifiez ou ajoutez vos propres styles dans un fichier CSS. Par exemple, créez un fichier
static/css/custom.csset ajoutez votre CSS personnalisé.Puis, incluez-le dans le fichier de modèle principal du thème, généralement situé dans
themes/beautifulhugo/layouts/_default/baseof.htmlou similaire.<link rel="stylesheet" href="{{ "css/custom.css" | relURL }}">8.2 Configurer le Menu
Ajoutez un menu navigable dans votre
config.toml:[menu] [[menu.main]] identifier = "about" name = "À propos" url = "/about/" weight = 1 [[menu.main]] identifier = "contact" name = "Contact" url = "/contact/" weight = 28.3 Créer des Pages Personnalisées
Créez des pages personnalisées telles que "À propos" et "Contact". Par exemple :
hugo new about.md hugo new contact.mdModifiez les fichiers créés dans
content/:content/about.md:--- title: "À propos" date: 2023-10-01T10:00:00Z draft: false --- Bienvenue sur mon blog de randonnée. Je suis passionné par ...content/contact.md:--- title: "Contact" date: 2023-10-01T10:00:00Z draft: false --- Si vous avez des questions, vous pouvez me contacter à ...8.4 Ajouter des Widgets et des Plugins
Pour ajouter des fonctionnalités supplémentaires comme une galerie de photos ou des cartes de randonnée, vous pouvez inclure des plugins ou des widgets en utilisant des courts-circuits Hugo (shortcodes) ou en modifiant les modèles de votre thème.
Par exemple, pour ajouter une carte interactive de randonnée, vous pouvez utiliser un shortcode comme ça dans votre post :
{{< map src="link_to_your_map" >}}Pour activer ce shortcode, vous aurez besoin de créer un fichier
layouts/shortcodes/map.htmlavec le contenu suivant :<iframe width="600" height="450" src="{{ .Get "src" }}" frameborder="0" allowfullscreen></iframe>8.5 SEO et Performance
Assurez-vous que votre site est optimisé pour les moteurs de recherche (SEO). Vous pouvez ajouter les balises meta nécessaires dans
config.toml:[params] description = "Un blog de randonnée inspirant" keywords = "randonnée, nature, aventure, blog"Et dans vos templates, vous pouvez inclure des balises SEO :
<meta name="description" content="{{ .Site.Params.description }}"> <meta name="keywords" content="{{ .Site.Params.keywords }}">Étape 9 : Automatiser et Améliorer votre Workflow
9.1 Utiliser une CI/CD (Intégration Continue / Déploiement Continu)
Utilisez des services comme GitHub Actions pour automatiser le déploiement de votre site à chaque fois que vous poussez des changements sur votre dépôt Git.
Créez un fichier
.github/workflows/hugo.ymldans votre dépôt avec le contenu suivant :name: Deploy Hugo site to GitHub Pages on: push: branches: - main # Branche principale de déploiement jobs: build: runs-on: ubuntu-20.04 steps: - name: Checkout uses: actions/checkout@v2 - name: Install Hugo uses: peaceiris/actions-hugo@v2 with: hugo-version: '0.87.0' - name: Build run: hugo --minify - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./public9.2 Analytics et Matrice d'Analyses
Ajoutez Google Analytics ou tout autre service d'analyse pour suivre les visiteurs de votre site.
Modifiez
config.tomlpour inclure votre ID de suivi Google Analytics :[params] googleAnalytics = "UA-XXXXXXXX-X"9.3 Optimisations de l'Image et Performance
Utilisez des outils comme ImgBot pour optimiser les images ajoutées à votre site et garantir des temps de chargement rapides. Vous pouvez également ajouter une tâche de compression d'images dans votre pipeline CI/CD.
Conclusion
En suivant ces étapes, vous aurez un blog de randonnée Hugo attrayant, fonctionnel et bien optimisé pour vos lecteurs. Continuez à ajouter des fonctionnalités et à améliorer votre site pour offrir une expérience utilisateur incroyable. Profitez de la création de contenu et des randonnées !
N'hésitez pas à revenir avec des questions spécifiques ou des besoins d'approfondissement sur certaines sections. Bonne chance et bonne création ! 🌲🏞️
- User
je veux des tags avec des boutons avec des angles arrondis pour mes posts
- Assistant
Ajouter des tags avec des boutons arrondis à vos posts est une excellente idée pour améliorer la navigation et la présentation de votre blog de randonnée. Voici un guide sur la façon de le faire en utilisant Hugo :
Étape 1 : Ajouter des tags à vos posts
Tout d'abord, assurez-vous que vos posts incluent des tags dans leurs métadonnées. Par exemple :
content/posts/ma-premiere-randonnee.md:--- title: "Ma Première Randonnée" date: 2023-10-01T10:00:00Z draft: false tags: ["forêt", "aventure", "sentier"] --- Aujourd'hui, je vais partager avec vous mon expérience de randonnée à travers les bois...Étape 2 : Modifier les templates pour afficher les tags
Ensuite, modifiez les templates de votre thème pour afficher les tags comme des boutons avec des angles arrondis. Ouvrez le fichier de template utilisé pour afficher les articles de blog. Cela pourrait être
themes/beautifulhugo/layouts/_default/single.htmlou un autre fichier similaire.Recherchez l'endroit où les tags sont affichés ou, si ce n’est pas déjà dans le template, ajoutez-le. Vous pouvez ajouter ce code après le contenu de l'article pour afficher les tags :
{{ if .Params.tags }} <div class="tags"> {{ range .Params.tags }} <a href="/tags/{{ . | urlize }}" class="tag-button">{{ . }}</a> {{ end }} </div> {{ end }}Étape 3 : Style des tags avec du CSS
Créez ou modifiez un fichier CSS pour ajouter des styles personnalisés aux boutons de tags. Ouvrez
static/css/custom.csset ajoutez :/* CSS pour les boutons de tags */ .tags { margin-top: 20px; } .tag-button { display: inline-block; padding: 5px 10px; margin: 5px; font-size: 14px; color: #ffffff; background-color: #0275d8; border-radius: 12px; text-decoration: none; transition: background-color 0.3s; } .tag-button:hover { background-color: #025aa5; }N'oubliez pas d’inclure
custom.cssdans votre template principal si cela n’est pas encore fait. Par exemple, dansthemes/beautifulhugo/layouts/_default/baseof.html:<head> <!-- Autres balises meta et liens --> <link rel="stylesheet" href="{{ "css/custom.css" | relURL }}"> </head>Conclusion
En suivant ces étapes, vous aurez des tags stylisés comme des boutons avec des angles arrondis sur vos posts, ajoutant une touche élégante et améliorant l'expérience utilisateur.
Voici à quoi pourrait ressembler le fichier final édité pour un post :
content/posts/ma-premiere-randonnee.md:--- title: "Ma Première Randonnée" date: 2023-10-01T10:00:00Z draft: false tags: ["forêt", "aventure", "sentier"] --- Aujourd'hui, je vais partager avec vous mon expérience de randonnée à travers les bois... <!-- Ajout des tags comme décrit dans le template -->Et votre template
themes/beautifulhugo/layouts/_default/single.html:<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>{{ .Title }}</title> <link rel="stylesheet" href="{{ "css/custom.css" | relURL }}"> <!-- Autres liens et balises meta --> </head> <body> <article> <header> <h1>{{ .Title }}</h1> <p>Publié le {{ .Date | dateFormat "2 January 2006" }}</p> </header> <div class="content"> {{ .Content }} </div> {{ if .Params.tags }} <div class="tags"> {{ range .Params.tags }} <a href="/tags/{{ . | urlize }}" class="tag-button">{{ . }}</a> {{ end }} </div> {{ end }} </article> </body> </html>Vous devriez maintenant voir vos tags stylisés comme des boutons arrondis sur votre blog de randonnée Hugo. Vous pouvez ajuster les styles css selon vos préférences. Bonne personnalisation ! 🌲🏔️
- User
continuer
- Assistant
Bien sûr, allons plus loin pour améliorer votre blog de randonnée avec des fonctionnalités et des optimisations supplémentaires.
Étape 4 : Créer une Page de Liste de Tags
Il est utile d'avoir une page dédiée à lister tous les tags disponibles, de façon à ce que les visiteurs puissent explorer les articles par thème. Pour cela, nous allons :
- Créer une nouvelle taxonomie pour les tags.
- Configurer une mise en page pour la liste des tags.
- Créer une page qui affiche tous les articles d'un tag particulier.
4.1 Définir les Taxonomies
Ouvrez votre
config.tomlet ajoutez une section pour les taxonomies si elle n'est pas déjà présente :[taxonomies] tag = "tags"Cela permet à Hugo de comprendre que "tags" est une taxonomie que nous voulons utiliser.
4.2 Créer des Templates de Taxonomies
Créez un template pour la liste de tous les tags. Créez un fichier
layouts/tags/list.html:<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Tags</title> <link rel="stylesheet" href="{{ "css/custom.css" | relURL }}"> </head> <body> <h1>Tags</h1> <ul class="tags-list"> {{ range .Data.Terms.Alphabetical }} <li><a href="{{ .Page.RelPermalink }}" class="tag-button">{{ .Page.Title }}</a> ({{ .Count }})</li> {{ end }} </ul> </body> </html>Et un template pour afficher les posts associés à un tag spécifique, créez
layouts/_default/terms.html:<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Tags</title> <link rel="stylesheet" href="{{ "css/custom.css" | relURL }}"> </head> <body> <h1>Articles avec le tag "{{ .Title }}"</h1> {{ range .Pages }} <article> <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2> <p>{{ .Summary }}</p> </article> {{ end }} </body> </html>4.3 (Optionnel) Personnaliser les Styles CSS pour les Tags
Ajoutez éventuellement plus de styles spécifiques pour vos listes de tags. Par exemple, dans
static/css/custom.css:/* CSS pour la liste des tags */ .tags-list { list-style-type: none; padding: 0; } .tags-list li { display: inline-block; margin: 0 5px 5px 0; }Étape 5 : Pagination pour les Listes de Posts
Pour améliorer la navigation sur votre blog, surtout si vous avez beaucoup d'articles, vous voudrez peut-être ajouter de la pagination.
5.1 Configurer la Pagination dans
config.toml[pagination] perPage = 5Cela définit que vous voulez afficher 5 articles par page.
5.2 Ajouter la Pagination au Template
Modifiez votre template de liste de posts pour inclure la pagination. Par exemple, si vous avez un fichier
layouts/_default/list.html, ajoutez-y :<section> {{ range .Paginator.Pages }} <article> <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2> <p>{{ .Summary }}</p> </article> {{ end }} </section> {{ if .Paginator.HasPrev }} <a href="{{ .Paginator.Prev.URL }}">Précédent</a> {{ end }} {{ if .Paginator.HasNext }} <a href="{{ .Paginator.Next.URL }}">Suivant</a> {{ end }}Étape 6 : Optimiser les Performances et le SEO
6.1 Optimiser les Images
Vous pouvez minimiser la taille des images pour améliorer les temps de chargement. Utilisez un outil comme ImageMagick pour compresser les images, ou des outils en ligne comme TinyPNG.
6.2 Activer les Shortcodes pour le SEO
Utilisez des shortcodes pour insérer des metatags et des éléments utiles pour le SEO. Par exemple, créez un shortcode pour les balises meta :
Créez
layouts/shortcodes/meta.html:<meta name="description" content="{{ .Get "description" }}"> <meta name="keywords" content="{{ .Get "keywords" }}">Puis, utilisez ce shortcode dans votre
head:{{< meta description="Un blog de randonnée inspirant" keywords="randonnée, nature, aventure, blog" >}}Conclusion
En suivant ces étapes, vous transformerez votre blog de randonnée en un site riche de fonctionnalités, bien conçu et performant. Vous pouvez encore approfondir la personnalisation et l'amélioration en fonction de vos besoins spécifiques. Continuez à expérimenter et à explorer la flexibilité de Hugo pour rendre votre blog unique et captivant. Bonne randonnée et bon blogging ! 🥾🌄