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, notamment :
Masquer ou afficher les pages
Masquer ou afficher le site les variantes
Masquer ou afficher le site les sections
Masquer ou afficher les liens d’en-tête
Ajouter du contenu personnalisé aux expressions en ligne
Utiliser l’éditeur de conditions
L’éditeur de conditions est l’endroit où vous définirez les conditions d’affichage ou de masquage d’une page, d’une variante ou d’une section. Après avoir ouvert l’éditeur de conditions, vous pourrez écrire votre condition sous forme d’ expression qui sera exécutée sur les données provenant des visiteurs de votre site.
Exemple
Les données que vous transmettez à GitBook via vos utilisateurs sont associées à un objet appelé visitor.claims.
Prenons un exemple si nous voulons écrire une instruction conditionnelle pour n’afficher une page qu’aux utilisateurs qui font partie d’un programme bêta que vous pourriez définir.
L’expression ci-dessus signifie que tout utilisateur qui correspond à cette revendication (c.-à-d. 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, ce qui vous aide à rédiger l’instruction conditionnelle de vos pages, variantes ou sections.
Lorsque vous utilisez l’autocomplétion, vous remarquerez que les variables sont également disponibles à l’utilisation. Vous pouvez combiner les variables que vous avez définies avec des revendications provenant des données utilisateur pour écrire des expressions conditionnelles. Par exemple, vous pourriez :
Définir une variable pour la dernière version de votre produit
Puis configurer une revendication indiquant quelle version de votre produit est utilisée par un visiteur de votre documentation
Enfin, écrire une expression pour n’afficher certaines pages que lorsqu’un utilisateur se trouve sur la dernière version de votre documentation
Vous pouvez écrire de nombreux types d’expressions différents, tant qu’elles sont rédigées en JavaScript valide. Par exemple, vous pouvez combiner plusieurs revendications dans l’éditeur de conditions afin d’identifier des utilisateurs spécifiques en utilisant l’ && ou || opérateur. Vous pouvez en savoir plus sur les opérateurs ici.
Cibler les visiteurs humains et les agents d’IA
Utilisez la propriété intégrée visitor.type pour afficher du contenu différent aux humains et aux agents d’IA. Cette propriété prend l’une des deux valeurs :
humanpour un visiteur humainagentpour un agent d’IA
Par exemple, utilisez cette condition pour afficher du contenu uniquement aux agents d’IA :
Utilisez la condition suivante pour afficher du contenu uniquement aux visiteurs humains :
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 qui représente un développeur sur votre formule entreprise, ou un utilisateur connecté sur une formule gratuite, puis voir quelles pages seraient visibles pour lui.
Pages conditionnelles
Pour lancer l’éditeur de conditions d’une page, rendez-vous dans le menu des actions 
à 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.
Vous pouvez voir quelles pages de votre section ont des conditions définies si elles affichent une icône de condition de page 
à côté.
Variantes conditionnelles
Pour lancer l’éditeur de conditions d’une variante, rendez-vous dans le menu des actions à 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 elles affichent une icône de condition de page à côté.
Sections conditionnelles
Pour lancer l’éditeur de conditions d’une section, rendez-vous dans le menu des actions à 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 elles affichent une icône de condition de page à côté.
Liens conditionnels d’en-tête de page
Pour lancer l’éditeur de conditions d’un lien d’en-tête de page, rendez-vous dans le menu des actions à 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 affiche une icône de condition de page à 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, tout comme les variables de page et d’espace.
Pour référencer une revendication en ligne à l’aide d’une expression, tapez / dans l’éditeur, puis sélectionnez 
Expression. Les revendications seront accessibles dans l’éditeur d’expressions sous forme de propriétés de visitor .
Utiliser 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 conditionnée restent visibles dans votre dépôt synchronisé.
Les données transmises via les revendications ne sont jamais visibles dans Markdown et sont transmises de manière sécurisée à GitBook.
Mis à jour
Ce contenu vous a-t-il été utile ?