Intégrer dans BookStack

Intégrez vos graphiques Embases dans vos pages BookStack via un bloc HTML personnalisé.

Bloc HTML

Dans l'éditeur visuel BookStack (WYSIWYG), cliquez sur « Insérer » dans la barre d'outils → sélectionnez « HTML personnalisé ». Une fenêtre s'ouvre : collez le code iFrame Embases complet et validez. Le graphique s'affiche dans la page.

Si vous utilisez l'éditeur Markdown de BookStack, collez directement le tag `<iframe>` dans votre contenu — BookStack autorise le HTML brut dans les pages Markdown.

<iframe
  src="https://embases.com/e/VOTRE_TOKEN"
  width="100%"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

Astuce : BookStack peut restreindre certaines balises HTML selon la configuration de l'administrateur. Si l'iFrame n'apparaît pas, demandez à votre admin d'autoriser la balise iframe dans les paramètres de contenu autorisé.

Organisation : Livres et Chapitres

BookStack organise le contenu en une hiérarchie claire : Étagères (Shelves) → Livres (Books) → Chapitres (Chapters) → Pages. Les embeds Embases fonctionnent dans toutes les Pages, quel que soit leur niveau dans la hiérarchie.

Vous pouvez intégrer des graphiques dans des pages autonomes ou dans des pages appartenant à un chapitre structuré. La mise en page de la page BookStack s'adapte automatiquement à la largeur de l'iFrame.

Permissions

Les embeds Embases respectent les permissions BookStack. Un utilisateur sans accès en lecture à la page ne verra pas le graphique : la page elle-même est inaccessible, donc l'iFrame ne se charge pas.

Pour les lecteurs ayant accès à la page, l'embed se charge normalement. Si votre embed Embases est en mode Privé, les utilisateurs devront également disposer du lien privé valide pour voir les données.

Astuce : Pour une documentation accessible à tous sans connexion BookStack, configurez votre instance avec l'accès public activé et utilisez un embed Embases en mode Public.

Domain Whitelisting

Si le Domain Whitelisting est activé sur votre embed Embases, ajoutez votre domaine BookStack self-hosted à la liste blanche. BookStack est généralement déployé sur un domaine ou sous-domaine propre à votre organisation.

# Domaine BookStack self-hosted
votre-bookstack.com

Étapes suivantes