intelligence outils

# Une image qui vit dans le dépôt, à côté du README

# Afficher l'image dans le README (chemin relatif au fichier README)

![Machine d'états if(a==b)](images/machine-etats-parsing.png)

# Un simple lien vers l'image, sans l'afficher

[Voir la machine d'états](images/machine-etats-parsing.png)

# Image cliquable, qui ouvre le fichier en grand

[![Machine d'états finale](images/machine-etats-finale.png)](images/machine-etats-finale.png)

# Avec une taille contrôlée : du HTML, le Markdown pur ne le permet pas

<img src="images/machine-etats-finale.png" alt="Machine d'états finale" width="600">

# Lien absolu : la forme « raw », jamais la page GitHub de l'image

![Machine d'états](https://raw.githubusercontent.com/utilisateur/depot/main/images/machine-etats.png)

# Les trois pièges qui donnent un carré vide

1. Le chemin est relatif au README, pas à la racine du dépôt : images/nom.png, sans barre oblique au début.

2. La casse et les espaces comptent : Images/Mon Fichier.PNG et images/mon-fichier.png sont deux fichiers différents. Minuscules, sans espaces ni accents.

3. L'image doit être commise et poussée : une image seulement sur votre disque donne un carré vide sur GitHub.

# Ranger et pousser une image

mkdir images

git add images/machine-etats-parsing.png README.md

git commit -m "Image de la machine d'états"

git push

# Vérifier avant de remettre

git status

rien en rouge : l'image est versionnée

git ls-files images/

la liste doit nommer votre image

Puis ouvrir le README sur github.com : l'image s'affiche.