Aller au contenu principal

Ajouter un article sur le blog

Bienvenue sur l’espace collaboratif d'Estudiantinerie !
Ce guide explique étape par étape comment publier un nouvel article de blog en utilisant uniquement l’interface web de GitHub.

✍️ Étapes pour Publier un Article​

1. Connectez-vous à GitHub​

2. Créez une Nouvelle Branche​

  1. Depuis la page d’accueil du dépôt, cliquez sur le menu déroulant des branches.
  2. Saisissez un nom de branche, par exemple :
    • blog/ajout-article-mon-sujet
  3. Cliquez sur Create branch: blog/ajout-article-mon-sujet from main.

3. Créez le Dossier de l’Article​

  1. Naviguez dans le dépôt vers : 
    /blog/
  2. Cliquez sur Add file > Create new file.
  3. Dans le champ du nom de fichier, saisissez : 
    blog/2025-05-17-journee-des-folklores/index.md
  4. Rédigez votre article dans index.md.

Si votre article ne contient pas d'image, vous pouvez directement créer le fichier sans dossier avec le bon nommage :

2025-05-17-journee-des-folklores.md

📂 Structure du Dossier​

/blog/2025-05-17-journee-des-folklores/
├── index.md
├── affiche.png
└── photo-evenement.jpg
  • index.md : Contient le contenu de l’article.
  • Les images associées sont placées dans le même dossier.

4. Utilisez le Format Markdown Correct​

✅ Exemple Minimal :​

---
title: "Journée des Folklores"
authors: [thibautLabouret]
tags: [faluche, évènement]
---

C'est avec un grand plaisir que nous avons organisé la **Journée des Folklores** !

![Affiche de l'événement](./affiche.webp)

> "Une belle réussite !" – Le Président

💡 Les images sont référencées avec ./ car elles se trouvent dans le même dossier que l’article.

📚 Pour aller plus loin :​

5. Ajouter des Images​

  1. Depuis le dossier de votre article, cliquez sur Add file > Upload files.
  2. Téléversez les images directement dans ce dossier.
  3. Exemple de lien d’image dans l’article :
![Description](./photo-evenement.jpg)

6. Proposez la Modification (Pull Request)​

  1. Une fois votre travail terminé, cliquez sur Propose new file ou Commit changes.
  2. Créez une Pull Request en suivant les instructions.
  3. Rédigez un message clair, par exemple : 
    Ajout de l’article sur la Journée des Folklores du 17 mai 2025

➡️ Une vérification automatique sera lancée pour garantir que le site peut être généré sans erreur.

✅ Bonnes Pratiques​

  • Utilisez cette structure dossier + index.md pour tous les articles comportant des images.
  • Restez concis et utilisez des titres et sous-titres pour structurer votre contenu.
  • Préférez des formats d’image légers comme .webp ou .jpg.
  • Consultez les articles existants dans /blog/ pour vous inspirer.

📖 Liens Utiles​

💡 Astuce : Vous pouvez prévisualiser le rendu de votre article dans l’éditeur de GitHub en cliquant sur l’onglet Preview.