[🛠] Ajouter des images à un blog GitHub Pages

✨ Résumé de GPT 　

Guide pour ajouter des images à un blog GitHub Pages.

Je voulais ajouter des images à mon blog GitHub Pages, mais plusieurs questions sont apparues.

• J’avais oublié comment faire.

• Je me suis souvenu qu’il existait une limite de 1 Go par dépôt.
  • Modifié le 2025.1.13
    • 1 Go est une recommandation, pas une limite obligatoire.
    • Si le dépôt dépasse 5 Go, GitHub peut envoyer un e-mail.
    • Aucune limite totale distincte n’est clairement indiquée.
    • Un fichier unique est limité à 100 Mo. (Git LFS peut résoudre ce point.)
    • Si le dépôt grossit, les vitesses de clone et de push risquent fortement d’être affectées.
• Je me suis souvenu qu’utiliser un hébergement d’images externe était aussi une option.

… Alors, à notre époque, quelle est la bonne manière de faire ?

✨ Clic ✨

Le texte ci-dessous a été rédigé en m’appuyant sur une réponse de GPT-4o.

1. Méthode générale : utiliser le dossier assets/images

On enregistre les images dans le dossier assets/images du projet de blog, puis on crée les liens correspondants.

Exemple

• Chemin d’enregistrement de l’image :

  assets/images/example.jpg
  

• Utilisation dans un article :

  ![Description de l'image](/assets/images/example.jpg)
  

Cette méthode est simple, mais elle peut poser problème si la taille du dépôt atteint la recommandation de 1 Go.

---

2. Que faire en cas de dépassement de capacité

1) Hébergement d’images externe

Utiliser un service externe au lieu du dépôt GitHub.

• Imgur : téléverser l’image, puis utiliser son URL.

  ![Description de l'image](https://i.imgur.com/example.jpg)
  

• Google Photos/Dropbox : utiliser des liens de stockage cloud.

---

2) Créer un dépôt d’images indépendant

Créer un dépôt GitHub Pages séparé uniquement pour gérer les images.

1. Créer un nouveau dépôt. (ex. : blog-images)
2. Téléverser et pousser les images.

3. Utiliser le lien de l’image :

   ![Description de l'image](https://username.github.io/blog-images/example.jpg)
   

---

3. Préparer les changements d’URL

On peut réduire la charge de modification des liens en définissant un chemin d’image par défaut dans _config.yml.

1. Ajouter ceci dans _config.yml :

   image_baseurl: "/assets/images"
   

2. Lors de la rédaction d’un article :

   ![Description de l'image](/example.jpg)
   

3. Si le dépôt d’images change, modifier seulement image_baseurl :

   image_baseurl: "https://username.github.io/blog-images"
   

---

4. Conclusion

Pour l’instant, il vaut mieux enregistrer les images dans le dossier assets/images. Si la capacité devient un problème, on pourra introduire un hébergement externe ou un dépôt dédié aux images.