Schrek.fr

Table des matières

La taxonomie ou taxinomie est une branche des sciences naturelles qui a pour objet l’étude de la diversité du monde vivant(Wikipedia).

La Taxonomie dans Hugo ou Organiser votre Contenu avec Précision

Dans le CMS statique Hugo, la taxonomie est un outil puissant qui permet de structurer et d’organiser vos contenus en catégories logiques. Inspirée des classifications scientifiques, la taxonomie offre une manière flexible de regrouper des articles selon des critères définis, améliorant ainsi la navigation et le référencement de votre site.

Principe de base

Une taxonomie dans Hugo correspond à un système de classification, comme les catégories (categories) et les étiquettes (tags). Par défaut, Hugo propose ces deux taxonomies principales, mais vous pouvez en créer d’autres pour des besoins spécifiques (par exemple, “auteurs”, “thèmes”, “localisations”).

Dans votre fichier config.toml ou config.yaml, vous pouvez définir vos taxonomies comme suit :

[taxonomies]
  category = "categories"
  tag = "tags"
  humeur = "humeurs"

Utilisation dans les fichiers Markdown

Pour assigner une taxonomie à un contenu, vous devez l’ajouter dans le front matter de vos fichiers Markdown :

---
title: "Introduction à Hugo"
categories: ["Développement", "CMS"]
tags: ["Hugo", "Taxonomie", "Tutoriel"]
humeurs: ["En forme"]
---

Cela associe l’article à des catégories et des étiquettes spécifiques. Hugo génère automatiquement des pages pour chaque terme de la taxonomie, regroupant les contenus associés.

Affichage dans les templates

Pour afficher des taxonomies dans vos pages, Hugo fournit des fonctions dédiées. Par exemple :

<ul>
  {{ range .Params.tags }}
    <li><a href="/tags/{{ . | urlize }}">{{ . }}</a></li>
  {{ end }}
</ul>

Ici, chaque étiquette associée à l’article est affichée avec un lien vers sa page de regroupement.

Avantages de la taxonomie dans Hugo 1. Navigation simplifiée : Les visiteurs peuvent explorer le site par catégories ou étiquettes. 2. SEO optimisé : Chaque terme de taxonomie dispose d’une page dédiée, favorisant l’indexation. 3. Flexibilité : Vous pouvez créer des taxonomies personnalisées adaptées à vos besoins spécifiques.

La taxonomie dans Hugo est bien plus qu’un simple système de classification : elle est un pilier de l’organisation de contenu. Bien utilisée, elle transforme un site statique en un outil dynamique et intuitif, autant pour les utilisateurs que pour les moteurs de recherche.

Personnaliser vos pages Taxonomie

Dans vos themes (à créer s’il n’existe pas):

Mes fichiers:

https://schrek.fr/categories/

taxonomy.html

{{ define "main" }}
<!-- taxonomy.html liste des categories/tags/series -->
	<h2>{{ .Title }}</h2>
	{{ .Content }}
		{{ range .Data.Terms.ByCount }}
		<p class="taxonomy">
		<a href="{{ .Page.RelPermalink }}">{{ .Page.LinkTitle }}</a> ({{ .Count }})
		</p>
	{{ end }}
{{ end }}

term.html

https://schrek.fr/tags/markdown/

{{ define "main" }}
<!-- term.html liste d'une categorie ou d'un tag par année -->
	<h2>{{ .Title }}</h2>
  	{{ .Content }}
		{{ range .Pages.GroupByDate "2006" }}
			<b>{{ .Key}}</b>
			{{ range .Pages  }}
				<p class="taxonomy">
				{{ .Date.Format (default "2006-01-02" .Site.Params.dateFormat) }} : <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
				</p>
		{{ end }}
	<br />
		{{ end }}
{{ end }}

Liens

https://staticmania.com/blog/hugo-taxonomy

https://bacardi55.io/2024/03/06/improving-listing-and-taxonomy-term-pages-with-hugo/

https://digitaldrummerj.me/hugo-view-post-grouped-by-category/


Métadonnées

Posté le: 15.03.2025
Nombre de mots: 487
Temps de lecture: 3 minutes
Cet article fait partie de la série: Hugo