Instructions pas à pas pour placer un flipbook interactif dans une page Confluence avec la macro Iframe : autoriser le domaine, dimensionner le cadre, gérer les différences entre Cloud et Data Center et corriger les cadres vides, avec des tableaux comparatifs et des exemples concrets d’équipes.
Votre équipe a importé le guide des employés dans Confluence sous forme de PDF, et personne ne l’ouvre. La pièce jointe se trouve tout en bas de la page, elle se télécharge au lieu de s’afficher, et la version que les gens lisent date toujours d’il y a trois trimestres. Il existe une meilleure solution : transformez le PDF en flipbook à effet de feuilletage avec Flipbooks AI et affichez-le directement dans la page grâce à la macro Iframe de Confluence. Les lecteurs tournent les pages sans quitter le wiki, et vous ne mettez le document à jour qu’une seule fois.
Cet article vous guide dans toute la configuration, de l’autorisation du domaine au dimensionnement du cadre, et détaille les erreurs qui affichent une case vide au lieu d’un flipbook.
Les wikis excellent pour le texte et peinent avec les longs documents soignés. Les chartes de marque, les catalogues produits, les dossiers d’intégration et les rapports trimestriels sont créés dans des outils de conception puis exportés en PDF. Les joindre comme pièces jointes pose trois problèmes :
Un flipbook règle les trois problèmes. Il s’affiche dans le navigateur, s’ouvre à la bonne page, s’adapte aux téléphones et vit à une seule URL. Lorsque vous remplacez le fichier source, chaque page qui l’intègre affiche la nouvelle version.
💡 Astuce : Si votre wiki est la référence unique de votre équipe, intégrez le flipbook sur la page que les gens consultent déjà, et non sur une page « Documents » que personne ne visite.
Un iframe est une fenêtre ouverte sur une autre page web. La macro Iframe de Confluence prend une URL et affiche cette page dans un rectangle de votre page wiki. Pour un flipbook, l’URL est le lien public ou protégé par mot de passe généré par votre plateforme de flipbooks.
| Cas d’usage | Espace wiki type | Pourquoi un flipbook aide |
|---|---|---|
| Guide des employés | RH | Un document à feuilleter, toujours à jour |
| Catalogue produits | Aide à la vente | Les commerciaux parcourent sans télécharger |
| Manuel de formation | Intégration | Les nouveaux arrivants lisent dans l’ordre, sur tout appareil |
| Rapport annuel | Direction | La mise en page soignée reste intacte |
| Dossier de presse | Marketing | Les journalistes prévisualisent avant de télécharger |
C’est là que la plupart des guides passent les détails sous silence, et là que la plupart des gens bloquent. Atlassian propose Confluence sous deux formes principales, qui gèrent les iframes différemment.
| Fonctionnalité | Confluence Data Center / Server | Confluence Cloud |
|---|---|---|
| Macro Iframe intégrée | Oui, sous Insérer, Autres macros | Non proposée comme macro standard |
| Contrôle du domaine | Liste d’autorisation de l’administrateur | Géré par l’application ou la prise en charge des Smart Links |
| Solution de contournement habituelle | Aucune nécessaire | Application d’iframe du Marketplace, ou le Smart Link d’intégration |
| Validation par l’administrateur | Requise pour les nouveaux domaines | Requise pour installer une application |
⚠️ Attention : Atlassian modifie régulièrement son éditeur et son catalogue de macros. Vérifiez votre propre instance avant de promettre à un collègue un chemin de menu précis. Les étapes ci-dessous décrivent la macro Iframe standard disponible sur Data Center et Server, ainsi que les approches équivalentes pour Cloud.
La macro intégrée suffit. Vous ajoutez le domaine du flipbook à la liste d’autorisation, puis vous insérez la macro et collez le lien.
Vous disposez de deux solutions pratiques. D’abord, une application du Marketplace qui fournit une macro de type iframe, installée par un administrateur du site. Ensuite, coller le lien du flipbook seul sur une ligne et choisir l’option d’affichage intégré d’un Smart Link, lorsque le domaine est pris en charge. Si votre administrateur n’autorise ni l’une ni l’autre, une carte de lien qui ouvre le flipbook dans un nouvel onglet fait office de solution de repli.
Avant de toucher à Confluence, il vous faut un contenu qui mérite d’être intégré. Voici la version courte du processus sur Flipbooks AI.
La page Intégrer un flipbook sur un site web détaille les options d’intégration.
Confluence ne chargera pas un site externe dans un iframe tant qu’un administrateur ne l’a pas approuvé. Oublier cette étape est la première cause de cadre vide.
✅ Bonne pratique : Autorisez le motif le plus étroit qui fonctionne. Autoriser un seul hôte de flipbook précis est plus sûr que d’autoriser un domaine de premier niveau entier.
Un iframe charge la page de quelqu’un d’autre avec votre page comme page parente. Les administrateurs veulent savoir précisément quelles sources externes sont approuvées. C’est une bonne habitude, pas un obstacle. Demandez-la une fois, documentez le domaine approuvé sur une page wiki pour votre équipe, et les intégrations suivantes ne demanderont qu’un clic.
Passons au cœur du sujet. Ouvrez la page Confluence où le flipbook doit apparaître et passez en mode édition.
La lecture avec effet de feuilletage est plus confortable dans un cadre large. Un flipbook affiche deux pages côte à côte sur un ordinateur de bureau, donc une boîte haute et étroite comprime la double page.
| Mise en page du wiki | Largeur suggérée | Hauteur suggérée | Remarques |
|---|---|---|---|
| Page pleine largeur | 100 % | 700 px | Idéal pour les catalogues et les rapports |
| Page standard | 100 % | 600 px | Valeur par défaut sûre pour les guides |
| Mise en page en deux colonnes | 100 % | 520 px | Affichage d’une page sur colonnes étroites |
| Widget de barre latérale | 100 % | 400 px | À réserver aux aperçus de couverture |
Régler la largeur à 100 % permet au cadre de remplir la zone de contenu de la page, quel que soit l’écran. Les largeurs fixes en pixels paraissent correctes sur votre écran et cassent sur un ordinateur portable. Utilisez des pourcentages pour la largeur et une valeur en pixels pour la hauteur.
💡 Astuce : Ouvrez la page publiée sur un téléphone avant de l’annoncer. Si le flipbook paraît à l’étroit, augmentez un peu la hauteur plutôt que de réduire la largeur.
Une responsable RH exporte le guide des employés en PDF, le convertit et l’intègre en haut de la page « Nouvel arrivant, commencez ici ». Les nouveaux employés le parcourent à leur rythme. Lorsque la politique de congés change, les RH remplacent le fichier source et la page reste à jour sans modification. Si le guide est interne, un Manuel de formation en flipbook protégé par mot de passe le garde privé.
Un responsable de l’aide à la vente intègre le Catalogue produits actuel sur la page d’accueil de l’espace de l’équipe. Les commerciaux l’ouvrent avant leurs appels, partagent le même lien avec leurs clients et ne demandent plus jamais « quelle version est la dernière ? ».
Une équipe financière publie le Rapport annuel sous forme de flipbook, l’intègre dans un espace direction et consulte les statistiques pour voir quelles sections sont lues.
| Méthode | Expérience de lecture | Maintenance | Idéal pour |
|---|---|---|---|
| Pièce jointe PDF | Téléchargement ou petit aperçu | Réimportation à chaque modification | Fichiers rarement lus |
| Page recréée dans Confluence | Entièrement native | Lourde, la mise en page est perdue | Contenus textuels courts |
| Flipbook en iframe | Feuilletage, dans la page | Un seul lien source | Documents soignés |
| Carte de lien vers le flipbook | S’ouvre dans un nouvel onglet | Un seul lien source | Cloud sans prise en charge des iframes |
Un problème surviendra au moins une fois. Voici la liste de contrôle, classée selon la fréquence de chaque cause.
C’est normal lorsque la protection est activée. Communiquez le mot de passe dans votre message d’accueil, ou choisissez un réglage de lien adapté à l’espace. Les autorisations du wiki déterminent qui voit la page, tandis que le mot de passe du flipbook détermine qui lit le document. Utiliser les deux est une combinaison solide pour les contenus sensibles.
| Symptôme | Cause probable | Solution |
|---|---|---|
| Case grise vide | Domaine non autorisé | Ajouter le domaine dans la liste d’autorisation |
| « Connexion refusée » | L’hôte bloque l’affichage en cadre | Utiliser le lien d’intégration officiel de la plateforme |
| Pages rognées | Cadre trop petit | Augmenter la hauteur, régler la largeur à 100 % |
| Fonctionne sur ordinateur uniquement | Largeur fixe en pixels | Passer à une largeur en pourcentage |
| Demande de mot de passe en boucle | Le navigateur bloque les cookies dans les cadres | Autoriser les cookies pour le domaine du flipbook |
⚠️ Avertissement : Certains navigateurs d’entreprise bloquent par défaut les cookies tiers. Si un flipbook protégé par mot de passe continue de demander le mot de passe dans le cadre, testez dans un autre navigateur avant de mettre en cause la configuration.
Un iframe charge une seconde page, donc chaque intégration ajoute un peu de poids. Placez un flipbook par section, et non dix sur une même page. Si vous en avez besoin de plusieurs, utilisez la macro Développer de Confluence pour que le cadre ne se charge qu’à l’ouverture par le lecteur, ou donnez à chaque flipbook sa propre page et reliez-les entre elles.
Avec l’offre Professional, les statistiques montrent quelles pages sont lues et pendant combien de temps. Un guide où tout le monde s’arrête à la page six indique que le chapitre suivant doit être réécrit. Consultez les offres tarifaires pour voir ce que contient chaque niveau.
Un flipbook intégré n’est utile que si les gens peuvent réellement le lire. Quelques petites décisions font une grande différence.
Les lecteurs d’écran annoncent les iframes par leur titre. Si votre macro ou votre application propose un champ titre, utilisez une formule descriptive comme « Flipbook du guide des employés » plutôt que de le laisser vide. Associez le cadre à un lien texte classique juste au-dessus, pour que quiconque ne peut pas utiliser la visionneuse intégrée puisse ouvrir le document directement.
Ajoutez une phrase sous le cadre, par exemple « Vous préférez un affichage plein écran ? Ouvrez le flipbook dans un nouvel onglet. » Cela aide dans deux situations : un lecteur dont le navigateur verrouillé bloque les cadres, et un lecteur qui veut simplement la plus grande vue possible. Un lien direct vous offre aussi une solution de secours lorsqu’un administrateur retire un domaine de la liste d’autorisation.
Les pages wiki se lisent sur téléphone bien plus souvent que la plupart des équipes ne l’admettent. Comme la mise en page du flipbook est adaptative, elle passe à un affichage d’une seule page sur les écrans étroits. Ouvrez la page publiée sur un téléphone et vérifiez trois points : le cadre tient dans la largeur, les pages se tournent d’un glissement du doigt, et la page ne bloque pas le défilement. Si le cadre bloque le défilement, réduisez la hauteur pour qu’une partie de la page reste visible au-dessus et en dessous.
| Vérification | Pourquoi c’est important |
|---|---|
| Lien texte descriptif au-dessus du cadre | Offre un chemin de secours |
| Largeur réglée à 100 % | Évite le défilement horizontal |
| Hauteur testée sur ordinateur portable et téléphone | Empêche les pages rognées |
| Mot de passe communiqué au public | Évite les questions au support |
| Fichier source clairement nommé | Facilite les mises à jour plus tard |
Intégrer est facile. Maintenir un wiki en bonne santé l’est moins, car les documents vieillissent. Une petite routine évite les intégrations obsolètes.
Les équipes qui publient des contenus publics, comme un dossier de presse ou un catalogue numérique, en tirent le plus grand profit, puisque le même lien sert au wiki, au site web et aux campagnes par e-mail. Parcourez le répertoire complet des outils de flipbook pour trouver un modèle adapté à votre type de document.
Vous avez maintenant toute la recette : créez le flipbook, autorisez le domaine, insérez la macro Iframe, dimensionnez-la intelligemment et testez-la sur un téléphone. L’ensemble prend environ quinze minutes une fois le domaine approuvé par votre administrateur, et remplace un tas de pièces jointes PDF obsolètes par un seul document vivant.
Prêt à essayer ? Créez votre premier flipbook gratuitement sur Flipbooks AI, parcourez les outils et modèles pour choisir une mise en page de départ, et comparez les offres tarifaires lorsque vous avez besoin de statistiques, de génération de prospects ou de flipbooks illimités. Lorsque vous êtes prêt à publier, la page Intégrer un flipbook sur un site web réunit toutes les options d’intégration au même endroit.
Choisissez votre langue
