Aller au contenu
  1. Documentation/

Séries

Sommaire
Documentation - Cet article fait partie d'une série.
Partie 11: Cet article

Blowfish propose une fonctionnalité permettant de regrouper un ensemble d’articles sous une “série”. Placer un article dans une série affichera les autres articles de la série sur chaque page individuelle et permettra une navigation rapide entre eux. Vous pouvez voir un exemple ci-dessus.

Créer une taxonomie
#

La première étape pour activer les séries est de créer la taxonomie series. Pour ce faire, ajoutez simplement la taxonomie series à votre liste de taxonomies dans hugo.toml.

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

Marquer les articles
#

Ensuite, vous devez simplement marquer chaque article en utilisant le paramètre series et series_order. Le paramètre series sera l’identifiant et le nom de la série dans laquelle vous placez l’article (même si la variable est un tableau, nous recommandons de garder chaque article dans une seule série). Et series_order définit l’ordre de cet article dans la série. Dans l’exemple ci-dessous, l’article est le numéro 11 dans la série Documentation.

series: ["Documentation"]
series_order: 11

Comportement des séries
#

Marquer un article comme faisant partie d’une série affichera automatiquement le module de série comme vous pouvez le voir sur cette page par exemple. Vous pouvez choisir si ce module démarre ouvert ou non en utilisant la variable globale article.seriesOpened dans params.toml ou le paramètre front matter seriesOpened pour spécifier une valeur différente au niveau de l’article.

Documentation - Cet article fait partie d'une série.
Partie 11: Cet article

Articles connexes