Intégrer dans GitBook
Intégrez vos graphiques Embases dans vos docs GitBook via le bloc Embed.
Bloc Embed
Dans un espace GitBook, placez votre curseur à l'endroit souhaité puis tapez « / » pour ouvrir le menu des blocs. Sélectionnez « Embed » dans la liste → collez l'URL de votre graphique Embases dans le champ prévu. GitBook charge l'URL dans un iFrame directement dans votre page de documentation.
https://embases.com/e/VOTRE_TOKENAstuce : Utilisez l'URL directe de l'embed (format /e/TOKEN) et non l'iFrame HTML complet — GitBook gère lui-même l'encapsulation dans un iFrame.
Partage dans les Spaces
Les embeds insérés dans un espace GitBook sont visibles par tous les membres du Space ayant accès à la page concernée. C'est idéal pour les documentations internes : tableaux de bord métier, rapports d'équipe ou suivi de KPIs partagés avec votre organisation.
Les permissions GitBook s'appliquent normalement : un membre sans accès au Space ne verra pas le graphique.
Astuce : Pour des données sensibles, combinez les permissions GitBook avec le mode Privé de l'embed Embases pour un double niveau de contrôle d'accès.
Docs publiées publiquement
Les embeds Embases fonctionnent également dans les documentations GitBook publiées publiquement. Tout visiteur de votre site de documentation pourra voir les graphiques intégrés, sans authentification requise côté GitBook.
Assurez-vous que votre embed Embases est configuré en mode Public si vous souhaitez le rendre visible aux visiteurs anonymes.
Domain Whitelisting
Si le Domain Whitelisting est activé sur votre embed Embases, ajoutez les domaines GitBook à la liste blanche. Ajoutez app.gitbook.com pour les espaces GitBook hébergés par défaut. Si vous avez activé un domaine personnalisé pour votre documentation GitBook, ajoutez également ce domaine.
# Domaine GitBook par défaut
app.gitbook.com
# Domaine personnalisé GitBook
docs.votre-domaine.com