# Balises

Vous pouvez utiliser des étiquettes pour regrouper du contenu مرتبط, indiquer les états de publication, signaler du contenu obsolète, ou de toute autre manière qui aide vos lecteurs à parcourir votre documentation.

{% hint style="info" %}
**Remarque :** Les étiquettes sont actuellement en bêta, car nous envisageons d’ajouter davantage de fonctionnalités — notamment la fonction de recherche et la prise en charge des couleurs. Si vous souhaitez voir des fonctionnalités spécifiques pour les étiquettes, veuillez [nous le faire savoir dans notre communauté GitHub](https://github.com/GitbookIO/community)!
{% endhint %}

## Étiqueter une page

Ouvrez la page, puis ouvrez **Options de page** — accessible en survolant le titre de la page — et ajoutez une ou plusieurs étiquettes. Vous pouvez faire glisser les étiquettes pour modifier l’ordre dans lequel elles apparaissent sur la page.

### Afficher ou masquer les étiquettes sur une page

Par défaut, les étiquettes seront affichées en haut de la page. Pour masquer les étiquettes d’une page tout en conservant les métadonnées associées :

* Ouvrir **Options de page**
* Désactivez **Afficher les étiquettes sur la page** pour conserver les étiquettes uniquement comme métadonnées

### Afficher une étiquette dans la table des matières

Pour chaque page, vous pouvez choisir une étiquette à afficher dans la [table des matières](https://gitbook.com/docs/creating-content/content-structure/page#table-of-contents) — comme vous pouvez le voir avec cette page. Pour choisir quelle étiquette s’affiche :

* Ouvrir **Options de page**
* Sous **Étiquettes**, utilisez le **Afficher dans la table des matières** menu déroulant pour choisir votre étiquette.

## Étiqueter un bloc de mise à jour

Chaque [bloc de mise à jour](https://gitbook.com/docs/documentation/fr/creating-content/blocks/updates) individuel peut également avoir ses propres étiquettes.

Pour ajouter une étiquette à un bloc de mise à jour, accédez à la mise à jour et cliquez sur **Ajouter une étiquette** sous la date. Vous pouvez ensuite utiliser le sélecteur d’étiquettes pour ajouter, supprimer ou réorganiser les étiquettes.

## Gérer les étiquettes dans la Bibliothèque

Pour afficher, créer et gérer les étiquettes de votre espace, ouvrez le **Bibliothèque** dans [table des matières](https://gitbook.com/docs/documentation/fr/creating-content/content-structure/page/..#table-of-contents) et choisissez **Étiquettes**.

Chaque étiquette a :

* Un **label** — ce que les lecteurs voient
* Un **slug** — un identifiant stable
* Un **icon** ou **emoji**

## Étiquettes en Markdown

Si vous utilisez Git Sync, les étiquettes apparaissent dans le frontmatter de la page.

```yaml
---
description: "Les étiquettes sont des libellés réutilisables que vous pouvez ajouter aux pages et aux blocs de mise à jour — cette page vous explique comment créer, ajouter et gérer des étiquettes"
tags:
  - actualités
  - expérience
  - étiquette : bêta
    principal : true
  - pro
---
```

Utilisez une chaîne de caractères pour une étiquette standard.

Utiliser `principal : true` sur une étiquette pour en faire l’étiquette principale de la page. GitBook peut afficher cette étiquette dans la table des matières.

GitBook conserve l’ordre des étiquettes de la liste.