CONTENT MANAGEMENT GESTION DE CONTENU

Taxonomies

Qu’est-ce Qu’une Taxonomie ?

Hugo prend en charge les groupages de contenu définis par l’utilisateur appelés taxonomies. Les taxonomies sont les classifications des relations logiques entre les contenus.

Définitions

Taxonomie
une catégorisation qui peut être utilisée pour classifier du contenu
Terme
une clé dans la taxonomie
Valeur
un morceau de contenu assigné à un terme

Exemple de Taxonomie : Site Web Cinéma

Supposons que nous produisons un site web sur le cinéma. Vous pourriez vouloir inclure les taxonomies suivantes :

  • Acteurs
  • Réalisateurs
  • Studios
  • Genre
  • Années
  • Prix

Puis, pour chacun des films, vous devriez spécifier les termes pour chacune de ces taxonomies (par ex., dans le front matter de chacun de vos fichiers de contenu de film). À partir de ces termes, Hugo créerait automatiquement les pages pour chaque Acteur, Réalisateur, Studio, Genre, Année, et Prix, avec chacun d’eux listant tous les Films qui correpondent à ces Acteur, Réalisateur, Studio, Genre, Année et Prix spécifiques.

Organisation de la Taxonomie Cinéma

Pour continuer avec l’exemple d’un site de cinéma, ce qui suit démontre les relations de contenu en partant de la perspective de la taxonomie :

Acteur                    <- Taxonomie
    Bruce Willis         <- Terme
        The Six Sense    <- Contenu
        Unbreakable      <- Contenu
        Moonrise Kingdom <- Contenu
    Samuel L. Jackson    <- Terme
        Unbreakable      <- Contenu
        The Avengers     <- Contenu
        xXx              <- Contenu

De la peerspective du contenu, les relations apparaissent différemment, même si les données et étiquettes utilisées sont les mêmes :

Unbreakable                 <- Contenu
    Acteurs                 <- Taxonomie
        Bruce Willis        <- Terme
        Samuel L. Jackson   <- Terme
    Réalisateur             <- Taxonomie
        M. Night Shyamalan  <- Terme
    ...
Moonrise Kingdom            <- Contenu
    Acteurs                 <- Taxonomie
        Bruce Willis        <- Terme
        Bill Murray         <- Terme
    Réalisateur             <- Taxonomie
        Wes Anderson        <- Terme
    ...

Valeurs par Défaut de la Taxonomie Hugo

Hugo supporte nativement les taxonomies.

Sans ajouter une seule ligne à votre fichier de configuration du site, Hugo créera automatiquement les taxonomies pour les tags et categories. Si vous ne voulez pas que Hugo crée quelque taxonomie, régler disableKinds dans la configuration de votre suite comme suit :

disableKinds = ["taxonomy","taxonomyTerm"]

Destinations par Défaut

Lorsque les taxonomies sont utilisées —et les modèles de taxonomie sont fournis— Hugo créera automatiquement une page répertoriant tous les termes de la taxonomie et les pages individuelles avec des listes de contenu associées à chaque terme. Par exemple, une taxonomie categories déclarée dans votre configuration et utilisée dans votre front matter de contenu créera les pages suivantes :

Configurer les Taxonomies

Les taxonomies doivent être définies dans la configurationd de votre site web avant de pouvoir être utilisées sur l’ensemble du site. Vous devez fournir à la fois les étiquettes au singulier et au pluriel des étiquettes pour chaque taxonomie. Par exemple, singular key = "plural value" pour TOML et singular key: "plural value" pour YAML.

Exemple : Configuration Taxonomie TOML

[taxonomies]
  tag = "tags"
  category = "categories"
  series = "series"

Exemple : Configuration Taxonomie YAML

taxonomies:
  tag: "tags"
  category: "categories"
  series: "series"

Préserver les Valeurs de Taxonomie

Par défaut, les noms de taxonomie sont normalisés.

Par conséquent, si vous avez un terme de taxonomie avec des caractères spéciaux tels que Gérard Depardieu au lieu de Gerard Depardieu, régler la valeur de preserveTaxonomyNames sur true dans votre configuration de site. Hugo préservera alors les caractères spéciaux dans les valeurs de taxonomie mais titrera encore les valeurs pour les titres et les normalisera dans les URLs.

Notez que si vous utilisez preserveTaxonomyNames et avez l’intention de construire manuellement les URLs vers la page archive, vous devrez passer les valeurs de taxonomie à travers la [fonction de modèle urlize][].

Ajouter des Taxonomies au Contenu

Une fois qu’une taxonomie est définie au niveau du site, n’importe quel contenu peut lui être attribué, indépendamment du type de contenu ou de la section de contenu.

L’affectation de contenu à une taxonomie se fait dans le front matter. Créez simplement une variable avec le nom plural de la taxonomie et attribuez tous les termes que vous souhaitez appliquer à l’instance du type de contenu.

Exemple : Front Matter TOML avec Taxonomies

+++
title = "Hugo: A fast and flexible static site generator"
tags = [ "Development", "Go", "fast", "Blogging" ]
categories = [ "Development" ]
series = [ "Go Web Dev" ]
slug = "hugo"
project_url = "https://github.com/gohugoio/hugo"
+++

Exemple : Front Matter YAML avec Taxonomies

---
title: "Hugo: A fast and flexible static site generator"
#tags: ["Development", "Go", "fast", "Blogging"]
categories: ["Development"]
categories: ["Go Web Dev"]
slug: "hugo"
project_url: "https://github.com/gohugoio/hugo"
---

Exemple : Front Matter JSON avec Taxonomies

{
    "title": "Hugo: A fast and flexible static site generator",
    "tags": [
        "Development",
        "Go",
        "fast",
        "Blogging"
    ],
    "categories" : [
        "Development"
    ],
    "series" : [
        "Go Web Dev"
    ],
    "slug": "hugo",
    "project_url": "https://github.com/gohugoio/hugo"
}

Ordre des Taxonomies

Un fichier de contenu peut affecter du poids pour chacune de ses taxonomies associées. Le poids taxonomique peut être utilisé pour trier ou commander du contenu dans modèles de liste de taxonomie et il est déclaré dans le front matter du fichier de contenu. La convention pour déclarer le poids taxonomique est taxonomyname_weight.

Les exemples suivants de TOML et YAML montrent un contenu qui a un poids de 22, qui peut être utilisé à des fins de tri lors du rendu des pages attribuées aux valeurs “a”, “b” et “c” de la taxonomie “tags” . On lui a également attribué le poids de 44 lors du rendu de la page de catégorie «d».

Exemple : TOML weight Taxonomique

+++
title = "foo"
tags = [ "a", "b", "c" ]
tags_weight = 22
categories = ["d"]
categories_weight = 44
+++

Exemple : YAML weight Taxonomique

---
title: foo
#tags: [ "a", "b", "c" ]
tags_weight: 22
categories: ["d"]
categories_weight: 44
---

En utilisant le poids taxonomique, le même contenu peut apparaître dans différentes positions dans différentes taxonomies.

La page “Taxonomies” a été mise à jour le
Améliorez cette page