Vous pouvez intégrer n’importe quelle vidéo de Loom directement dans vos articles en utilisant le code d’intégration généré par Loom. Contrairement à certaines plateformes, Loom propose un code d’intégration prêt à utiliser qui fonctionne sur les trois éditeurs Document360 sans modification d’URL requise.
Quand utiliser les embeds Loom
- Enregistrements d’écran et walkthroughs : intégrez un enregistrement Loom à côté d’une procédure pour offrir aux lecteurs une démonstration visuelle sans quitter l’article.
- Communication asynchrone en équipe : intégrez des vidéos Loom dans des articles internes de la base de connaissances pour partager le contexte, les annonces ou les explications sous forme de vidéo.
- Remplacer les explications longues : pour des workflows d’interface complexes, une vidéo intégrée de Loom peut communiquer en quelques secondes ce qui prendrait plusieurs paragraphes à décrire.
Petite référence
Loom génère le code d’intégration pour vous. L’exemple ci-dessous montre à quoi ressemble un code embed typique de Loom ; le tien contiendra ton propre ID vidéo.
<div style="position: relative; padding-bottom: 41.66666666666667%; height: 0;">
<iframe src="https://www.loom.com/embed/982aa03ae70544ddaf5e390722edf9d2"
frameborder="0"
webkitallowfullscreen
mozallowfullscreen
allowfullscreen
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;">
</iframe>
</div>
Le padding-bottom pourcentage contrôle le format du conteneur vidéo. Loom règle cela automatiquement en fonction de la taille que vous choisissez.
Comment intégrer une vidéo Loom
Obtenez le code d’intégration auprès de Loom
- Allez sur Loom et ouvrez la vidéo que vous souhaitez intégrer.
- Cliquez sur Partager > Intégrer.
- Sélectionnez la case Taille fixe et choisissez la taille de la vidéo souhaitée.
- Cliquez sur Copier, intégrer le code.
Collez le code d’intégration dans Document360
L’étape suivante dépend de l’éditeur que vous utilisez :
| Rédacteur en chef | Étapes |
|---|---|
| Éditeur Markdown | Collez le code d’intégration copié directement dans l’éditeur à l’emplacement souhaité. |
| Éditeur WYSIWYG | Cliquez sur Insérer la vidéo > Code intégré. Collez le code et cliquez sur Insérer. |
| Éditeur WYSIWYG avancé | Cliquez sur Insérer > Vidéo > Intégrer le code. Collez le code et cliquez sur Ajouter et intégrer. |
La vidéo Loom est désormais intégrée à votre article.
Exemple
Code d’intégration :
<div style="position: relative; padding-bottom: 41.66666666666667%; height: 0;">
<iframe src="https://www.loom.com/embed/982aa03ae70544ddaf5e390722edf9d2"
frameborder="0"
webkitallowfullscreen
mozallowfullscreen
allowfullscreen
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;">
</iframe>
</div>
Sortie :
Portée et couverture
| Objet | Détails |
|---|---|
| Source du code intégré | Généré par Loom, aucune modification manuelle de l’URL n’est nécessaire |
| Options de taille | Taille fixe (sélectionnée dans Loom) ou réactive (par défaut) |
| Support des éditeurs | Markdown, WYSIWYG et Advanced WYSIWYG, les étapes varient selon les éditeurs |
| Format d’image | Contrôlé par le padding-bottom pourcentage dans le code d’intégration |
Meilleures pratiques
- Utilisez Taille fixe pour une mise en page prévisible : l’option Taille fixe dans Loom définit des dimensions explicites dans le code d’intégration, ce qui produit un résultat cohérent à travers les navigateurs. Le réflexe par défaut remplit la largeur du conteneur, qui peut varier selon la mise en page de votre article.
- Vérifiez les paramètres de confidentialité vidéo avant d’intégrer : les vidéos Loom peuvent être définies en mode privé, public ou uniquement pour espace de travail. Une vidéo privée ne sera pas visionnée par les lecteurs en dehors de votre espace de travail Loom. Assurez-vous que la vidéo est réglée sur public ou au niveau de partage approprié avant l’intégration.
- Privilégiez le flux d’intégration avancé WYSIWYG plutôt que de coller du HTML brut : utiliser le code Insert > Video > Embed maintient le bloc vidéo correctement structuré dans l’éditeur. Coller du HTML brut directement peut fonctionner mais peut être plus difficile à modifier ou à déplacer plus tard.
- Ajoutez une brève description au-dessus ou en dessous de l’intégration : les lecteurs utilisant des technologies d’assistance ou des paramètres restrictifs du navigateur peuvent ne pas pouvoir visionner les vidéos intégrées. Un résumé d’une phrase de ce que la vidéo couvre garantit que le contenu est accessible à tous les lecteurs.
- Gardez les enregistrements Loom concis : les vidéos intégrées trop longues réduisent les chances que les lecteurs les regardent. Pour les articles de base de connaissances, visez des vidéos de moins de 3 minutes et utilisez chapitres ou horodatages dans l’enregistrement Loom si le contenu est complexe.