Adapter votre contenu

Personnalisez votre contenu pour 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 vos documents, y compris :

• Masquer ou afficher pages

• Masquer ou afficher le site variantes

• Masquer ou afficher le site sections

• Masquer ou afficher liens d'en-tête

• Ajouter du contenu personnalisé à expressions en ligne

Travailler avec l'éditeur de conditions

L'éditeur de conditions est l'endroit où vous définirez les conditions pour afficher ou 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 qui s'exécutera sur les données provenant des visiteurs de votre site.

Exemple

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

Voyons 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.

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 ne correspondant pas à cette revendication (y compris les visiteurs sans aucune revendication définie), ne pourra pas voir ou accéder à la page.

L'éditeur de conditions est également doté d'une fonction d'autocomplétion intégrée, qui suggère les revendications ou attributs trouvés chez les visiteurs précédents de votre site, vous aidant à rédiger l'instruction conditionnelle pour vos pages, variantes ou sections.

En utilisant l'autocomplétion, vous remarquerez que les variables sont également disponibles. Vous pouvez combiner les variables que vous avez définies avec les revendications issues 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. Ensuite, configurer une revendication qui indique quelle version de votre produit est utilisée par un visiteur de vos documents

3. Enfin, écrire une expression pour n'afficher certaines pages que lorsqu'un utilisateur est sur la dernière version de vos documents

Vous pouvez écrire de nombreux types d'expressions différentes, tant qu'elles sont écrites en Javascript valide. Par exemple, vous pouvez combiner plusieurs revendications dans l'éditeur de conditions pour cibler des utilisateurs spécifiques en utilisant l'opérateur && ou || . Vous pouvez en savoir plus sur les opérateurs ici.

Tester avec des segments

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

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

Vous pouvez en savoir plus sur la configuration et l'utilisation des segments ici.

Pages conditionnelles

Pour lancer l'éditeur de conditions pour une page, allez dans le menu d'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 espace ont des conditions définies si la page a une icône de condition de page à côté.

Variantes conditionnelles

Pour lancer l'éditeur de conditions pour une variante, allez dans le menu d'actions à côté d'une variante, puis cliquez sur Ajouter une condition.

Vous pouvez voir quelles variantes de vos documents ont des conditions définies si la variante a une icône de condition de page à côté.

Sections conditionnelles

Pour lancer l'éditeur de conditions pour une section, allez dans le menu d'actions à côté d'une section, puis cliquez sur Ajouter une condition.

Vous pouvez voir quelles sections de vos documents ont des conditions définies si la section a une icône de condition de page à côté.

Liens d'en-tête de page conditionnels

Pour lancer l'éditeur de conditions pour un lien d'en-tête de page, allez dans le menu d'actions à côté d'un lien d'en-tête, puis cliquez sur Ajouter une condition.

Vous pouvez voir quels liens de vos documents ont des conditions définies si la section a 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 les revendications en ligne à l'aide des 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 en tant que 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 pages avec des conditions de visibilité restent visibles dans votre dépôt synchronisé.

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