> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publier/adaptive-content/adapting-your-content.md).

# Adapter votre contenu

Adaptez votre contenu à différents utilisateurs

Après avoir configuré votre méthode d’authentification, vous pourrez utiliser les données pour adapter le contenu de votre site à différents utilisateurs.

Vous pouvez adapter et personnaliser de nombreuses parties de votre documentation, y compris :

* Masquer ou afficher [pages](/docs/documentation/fr/creer-du-contenu/content-structure/page.md)
* Masquer ou afficher le site [variantes](/docs/documentation/fr/gerer-votre-site/site-structure/variants.md)
* Masquer ou afficher le site [sections](/docs/documentation/fr/gerer-votre-site/site-structure/site-sections.md)
* Masquer ou afficher [liens d’en-tête](/docs/documentation/fr/gerer-votre-site/customization/layout-and-structure.md#header)
* Ajouter du contenu personnalisé à [expressions en ligne](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md)

### Travailler avec l’éditeur de conditions

L’éditeur de conditions est l’endroit où vous définirez les conditions permettant d’afficher ou de masquer une page, une variante ou une section. Après avoir ouvert l’éditeur de conditions, vous pourrez écrire votre condition sous forme d’ [expression](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md) qui sera exécutée à partir des données provenant des visiteurs de votre site.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FNQ8RM1GDU6HUyBKBp2wF%2F22_01_06_condition_editor%402x.png?alt=media&amp;token=137c61cd-52cf-4a7b-95a3-ab60c5992d3f" alt=""><figcaption></figcaption></figure>

#### Exemple

Les données que vous transmettez via vos utilisateurs à GitBook sont associées à un objet appelé `visitor.claims`.

Examinons un exemple si nous voulons écrire une instruction conditionnelle pour **afficher une page uniquement aux utilisateurs qui font partie d’un programme bêta** que vous pourriez définir.

```javascript
visitor.claims.isBetaUser == true
```

L’expression ci-dessus signifie que tout utilisateur correspondant à cette revendication (c’est-à-dire `isBetaUser` est `true` dans la revendication de l’utilisateur), pourra voir et accéder à la page. Tout utilisateur qui ne correspond pas à cette revendication (y compris les visiteurs sans aucune revendication définie) ne pourra pas voir ni accéder à la page.

L’éditeur de conditions intègre également l’autocomplétion, qui suggère des revendications ou des attributs trouvés chez des visiteurs précédents de votre site, vous aidant à élaborer l’instruction conditionnelle pour vos pages, variantes ou sections.

Lorsque vous utilisez l’autocomplétion, vous remarquerez que [les variables](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md#use-variables-in-your-content) sont également disponibles. Vous pouvez combiner les variables que vous avez définies avec les revendications provenant des données utilisateur pour écrire des expressions conditionnelles. Par exemple, vous pourriez :

1. Définir une variable pour la dernière version de votre produit
2. Puis configurer une revendication qui indique quelle version de votre produit est utilisée par un visiteur de votre documentation
3. Enfin, écrire une expression pour n’afficher certaines pages que lorsqu’un utilisateur est sur la dernière version de votre documentation

Vous pouvez écrire de nombreux types d’expressions, tant qu’elles sont rédigées en Javascript valide. Par exemple, vous pouvez combiner plusieurs revendications dans l’éditeur de conditions pour faire correspondre des utilisateurs spécifiques en utilisant l’ `&&` ou `||` opérateur. Vous pouvez en savoir plus sur les opérateurs [ici](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators#binary_logical_operators).

### Cibler les visiteurs humains et les agents IA

Utilisez la propriété intégrée `visitor.type` pour afficher différents contenus aux humains et aux agents IA. Cette propriété a l’une des deux valeurs :

* `human` pour un visiteur humain
* `agent` pour un agent IA

Par exemple, utilisez cette condition pour n’afficher du contenu qu’aux agents IA :

```javascript
visitor.type === "agent"
```

Utilisez la condition suivante pour n’afficher du contenu qu’aux visiteurs humains :

```javascript
visitor.type === "human"
```

### Tester avec des segments

Les segments représentent des données utilisateur fictives que vous pouvez configurer pour tester vos conditions.

Par exemple, vous pourriez configurer un segment représentant un développeur sur votre offre entreprise, ou un utilisateur connecté sur une offre gratuite, puis voir quelles pages seraient visibles pour lui.

[Vous pouvez en savoir plus sur la configuration et l’utilisation des segments ici.](/docs/documentation/fr/publier/adaptive-content/testing-with-segments.md)

### Pages conditionnelles

Pour lancer l’éditeur de conditions d’une page, allez dans le menu d’actions <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> à côté d’une page, puis cliquez sur **Ajouter une condition.** Vous pouvez également lancer l’éditeur de conditions depuis les [options de la page](/docs/documentation/fr/reference/gitbook-ui.md#page-options).

Vous pouvez voir quelles pages de votre section ont des conditions définies si la page comporte une icône de condition de page <picture><source srcset="/files/QtQtLiYwc1oJj119cgUz" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F51vQZhUqnkdsYpyUo1Pj%2Fpage-condition.svg?alt=media&amp;token=31dd334a-5097-4081-915c-db460e610ec6" alt="The Page condition icon in GitBook"></picture> à côté.

### Variantes conditionnelles

Pour lancer l’éditeur de conditions d’une variante, allez dans le menu d’actions <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> à côté d’une variante, puis cliquez sur **Ajouter une condition**.

Vous pouvez voir quelles variantes de votre documentation ont des conditions définies si la variante comporte une icône de condition de page <picture><source srcset="/files/QtQtLiYwc1oJj119cgUz" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F51vQZhUqnkdsYpyUo1Pj%2Fpage-condition.svg?alt=media&amp;token=31dd334a-5097-4081-915c-db460e610ec6" alt="The Page condition icon in GitBook"></picture> à côté.

### Sections conditionnelles

Pour lancer l’éditeur de conditions d’une section, allez dans le menu d’actions <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> à côté d’une section, puis cliquez sur **Ajouter une condition**.

Vous pouvez voir quelles sections de votre documentation ont des conditions définies si la section comporte une icône de condition de page <picture><source srcset="/files/QtQtLiYwc1oJj119cgUz" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F51vQZhUqnkdsYpyUo1Pj%2Fpage-condition.svg?alt=media&amp;token=31dd334a-5097-4081-915c-db460e610ec6" alt="The Page condition icon in GitBook"></picture> à côté.

### Liens d’en-tête de page conditionnels

Pour lancer l’éditeur de conditions d’un lien d’en-tête de page, allez dans le menu d’actions <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> à côté d’un lien d’en-tête, puis cliquez sur **Ajouter une condition**.

Vous pouvez voir quels liens de votre documentation ont des conditions définies si la section comporte une icône de condition de page <picture><source srcset="/files/QtQtLiYwc1oJj119cgUz" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F51vQZhUqnkdsYpyUo1Pj%2Fpage-condition.svg?alt=media&amp;token=31dd334a-5097-4081-915c-db460e610ec6" alt="The Page condition icon in GitBook"></picture> à côté.

### Expressions en ligne

En plus de contrôler la visibilité du contenu, vous pouvez également utiliser des revendications en ligne à l’aide d’ [expressions](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md), tout comme les variables de page et d’espace.

Pour faire référence à une revendication en ligne à l’aide d’une expression, tapez <kbd>/</kbd> dans l’éditeur, puis sélectionnez <picture><source srcset="/files/HArsBmu3qFWO2SuJx7oR" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FyV0YSeHof9IkW4nnHQ4C%2FExpression.svg?alt=media&amp;token=47e912c2-1ff1-4882-825f-5c3c79b4e6c0" alt=""></picture> **Expression**. Les revendications seront accessibles dans l’éditeur d’expressions sous forme de propriétés de `visitor` .

### Travailler avec Git Sync

Les conditions définies dans GitBook sont synchronisées via Git Sync et apparaissent dans les pages Markdown synchronisées. Cela signifie que les blocs et les pages dont la visibilité est soumise à des conditions restent visibles dans votre dépôt synchronisé.

Les données transmises via les revendications ne sont jamais visibles dans Markdown et sont transmises en toute sécurité à GitBook.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/publier/adaptive-content/adapting-your-content.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
