# Extraits (beta)

{% hint style="warning" %}
La fonctionnalité Snippets n’est plus maintenue dans GitBook et est susceptible d’évoluer. Nous vous recommandons de structurer votre contenu dans un [espace](/docs/documentation/fr/creating-content/content-structure/space.md) à la place.
{% endhint %}

{% hint style="info" %}
Cette fonctionnalité est disponible dans le cadre des forfaits Pro et Enterprise. Pour en savoir plus, [consultez notre page tarifaire](https://www.gitbook.com/pricing).
{% endhint %}

Dans GitBook, vous pouvez capturer des informations non structurées à l’aide de [les intégrations](https://github.com/GitbookIO/public-docs/blob/main/snippets/broken-reference/README.md)et GitBook AI le transformera en un **extrait** — une page d’informations structurée, facile à lire et à assimiler. Vous pouvez également créer des extraits manuellement dans l’application.

GitBook indexera tous vos extraits en même temps que le reste de votre contenu et pourra s’y référer lorsque vous ou votre équipe [recherchez des informations](/docs/documentation/fr/creating-content/searching-your-content.md). Vous pouvez également fusionner des extraits dans des documents ou du contenu existants afin de tout garder à jour.

### Démo du produit

{% embed url="<https://www.youtube.com/watch?v=P-ZRw0Yh_Mc>" %}
Démo du produit Snippets
{% endembed %}

### Créer un extrait

Vous pouvez créer des extraits dans GitBook de différentes manières, selon l’outil que vous utilisez ou l’espace de travail dans lequel vous vous trouvez.

#### Créer un extrait à partir d’un outil tiers

Vous pouvez capturer des extraits à partir d’outils tiers grâce à des intégrations. Selon l’outil que vous utilisez, vous pouvez ajouter des extraits de différentes manières. Pour en savoir plus sur la capture d’extraits dans des outils tiers, consultez [la section des intégrations](https://github.com/GitbookIO/public-docs/blob/main/snippets/broken-reference/README.md).

Chaque extrait que vous ajoutez à votre organisation se retrouvera sur la **Extraits** page, avec des informations à son sujet — comme sa source, son auteur et sa date de création.

#### Créer un extrait manuellement

Vous pouvez créer un extrait manuellement depuis la **Extraits** page, en cliquant sur la **Créer le vôtre** carte. Une page vierge apparaîtra et vous pourrez y ajouter les informations de votre choix.

### Modifier un extrait

Vous pouvez modifier un extrait que vous avez capturé en cliquant dessus pour l’ouvrir depuis la **Extraits** page. Cela ouvrira une vue d’édition, où vous pourrez corriger les informations éventuellement erronées, ou ajouter du contexte supplémentaire pour ce qui pourrait manquer.

### Partager un extrait

Vous pouvez partager un extrait avec d’autres personnes via un lien direct vers l’organisation dans laquelle il se trouve. Lorsque vous consultez un extrait, vous trouverez l’option **Copier le lien** bouton en haut à droite.

### Convertir un extrait en page

Vous pouvez convertir un extrait en page complète dans votre documentation. Pour ce faire, ouvrez un extrait et choisissez **Convertir en page** dans le coin supérieur droit.

Il vous sera demandé de choisir un espace pour votre page — vous pouvez utiliser le menu déroulant pour rechercher un espace ou faire défiler la liste. Lorsque vous sélectionnez un espace, GitBook ajoutera le contenu de l’extrait sous forme de nouvelle page, ou [ouvrir une demande de modification](/docs/documentation/fr/collaboration/change-requests.md) si vous sélectionnez un espace [avec des modifications en direct verrouillées](/docs/documentation/fr/collaboration/live-edits.md).

{% hint style="info" %}
**Remarque :** Lorsque vous convertissez un extrait en page, GitBook archivera automatiquement l’extrait. Si vous avez créé un lien vers l’extrait à l’aide de [un lien intégré](/docs/documentation/fr/creating-content/formatting/inline.md#links) ou [un bloc d’extrait](/docs/documentation/fr/creating-content/blocks/snippets.md), les liens fonctionneront toujours, mais amèneront les lecteurs vers l’extrait d’origine, et non vers la nouvelle page.
{% endhint %}

### Supprimer un extrait

Pour supprimer un extrait, ouvrez-le en cliquant dessus dans la **Extraits** page, puis cliquez sur l’ **Jeter** option dans le menu Action en haut à droite.

{% hint style="warning" %}
Un extrait est supprimé définitivement lorsque vous le jetez.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/extraits/snippets-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
