Ajouter des médias
Importez, gérez et intégrez des images et autres ressources multimédias dans vos pages de documentation via le gestionnaire de fichiers de l'éditeur.
- Images : PNG, JPG, JPEG, GIF, WebP (max 20 Mo)
- Vidéos : MP4, WebM (max 20 Mo)
- Polices : TrueType (TTF), WOFF, WOFF2
- Autres : PDF, ICO (favicons)
Glissez-déposez des éléments multimédias depuis votre ordinateur ou le gestionnaire de ressources dans une page. En mode visuel, l’image ou la vidéo est insérée directement dans le contenu. En mode Markdown, l’éditeur insère le chemin à l’emplacement de votre curseur. Les images sont enregistrées à la racine de votre dossier images/, et les vidéos à la racine de votre dossier videos/.
Tapez /image pour ouvrir le menu d’images ou /video pour ouvrir le menu de vidéos. Importez un nouveau média ou sélectionnez un fichier existant.
Tapez /embed et collez une URL YouTube, Loom ou Vimeo. L’éditeur détecte le fournisseur et génère automatiquement l’iframe. Dans le menu slash, les recherches youtube, yt, loom et vimeo font également apparaître la commande Embed.
Pour les autres contenus intégrés, tapez /embed, puis activez Intégration manuelle pour écrire du HTML personnalisé.
Utilisez l’explorateur de fichiers dans la barre latérale pour téléverser ou rechercher des fichiers. Faites glisser des fichiers et déposez-les dans un dossier pour organiser les ressources multimédias.
Après avoir inséré une image en mode visuel, survolez-la pour afficher une barre d’outils avec des options de mise en forme.
- Aperçu clair/sombre : basculez entre le mode clair et le mode sombre pour voir l’apparence de l’image dans chaque thème.
- Alignement : choisissez un alignement de l’image : gauche, centré, droite ou pleine largeur.
- Frame : entourez l’image d’un composant
<Frame>pour ajouter une bordure et un arrière-plan. - Paramètres : remplacez l’image ou mettez à jour son texte alternatif.
Cliquez sur le bouton + dans l’explorateur de fichiers pour créer un nouveau dossier. Faites glisser et déposez des fichiers et des dossiers dans l’arborescence pour les réorganiser.
Survolez une ressource et cliquez sur le bouton ... pour renommer le fichier ou mettre à jour son texte alternatif.
Survolez une ressource, puis cliquez sur le bouton pour la supprimer.
- Utilisez des noms explicites : Nommez clairement vos fichiers, par exemple
api-dashboard-light.pngplutôt queimg1.png. - Ajoutez un texte alternatif (alt) : Fournissez un texte alternatif descriptif pour l’accessibilité et le SEO.
- Organisez à l’aide de dossiers : Regroupez les ressources associées, comme les variantes en mode clair et sombre ou pour une fonctionnalité ou une section spécifique.
- Utilisez des formats adaptés : PNG pour les graphiques avec transparence, JPG pour les photos, SVG pour les icônes et les logos (vous ne pouvez pas téléverser de fichiers SVG via l’éditeur, mais vous pouvez les ajouter à votre référentiel via Git).