07 — Images et pièces jointes

Mettre une image dans un document

1. Téléversez l'image à côté du document : ouvrez le dossier, Ajouter un fichier → Téléverser un fichier.
2. Référencez-la depuis le fichier Markdown :

![Topologie réseau](topologie.png)

Le texte entre crochets est la description affichée si l'image ne peut pas se charger, et lue par les lecteurs d'écran. Écrivez une vraie description, pas « image ».

Où ranger les images

Une organisation prévisible qui marche toujours :

projet/
  readme.md
  assets/
    topologie.png
    baie.jpg

et dans readme.md :

![Topologie réseau](assets/topologie.png)

Nommage — la seule règle à retenir

Utilisez des noms en minuscules et sans espaces pour les dossiers et les fichiers image :

Si un nom contient malgré tout des espaces, écrivez-les %20 dans le lien :

![Topologie](Capture%20ecran.PNG)

Contrôler la taille

Markdown n'a pas d'option de taille : utilisez une simple balise HTML au besoin.

<img src="assets/topologie.png" alt="Topologie réseau" width="600">

Lier un fichier au lieu de l'afficher

Enlevez le point d'exclamation et vous obtenez un lien de téléchargement :

[Fichier Packet Tracer](main.pkt)

Pièces jointes dans les tickets

Pendant la rédaction d'un ticket ou d'un commentaire, glissez un fichier dans la zone de texte. Il est téléversé et le lien inséré pour vous. Utilisez ceci pour les captures d'écran et les journaux qui n'ont pas leur place dans le dépôt lui-même.