Activer votre site, puis l'éditer sans rien installer
Modifier son site Jekyll depuis l'interface GitHub
Activer la publication GitHub Pages de votre site, puis modifier une page directement depuis le navigateur, sans configurer Git ni Jekyll en local.
Pré-requis :
Logiciels :
Machines/Outils :
Les libellés de boutons ci-dessous correspondent à l’interface actuelle de GitHub.
Le template configure déjà le nécessaire, mais GitHub doit être explicitement autorisé à publier votre site — sans ça, docs/ reste un simple dossier de fichiers, jamais un site en ligne. À faire une fois pour toutes, dès la création de votre repo.
Sur votre repo, Settings (onglet en haut), puis Pages dans le menu de gauche. Sous Build and deployment > Source, choisissez GitHub Actions (pas « Deploy from a branch »).
Onglet Actions de votre repo : un workflow se lance automatiquement. Attendez la coche verte ✅ (comptez 1 à 2 minutes) — si elle est rouge ❌, ouvrez le run pour voir l’erreur. Une fois vert, votre site est en ligne à l’adresse indiquée dans Settings > Pages.
Sur la page d’accueil de votre repo, la carte About (à droite) est vide par défaut. Cliquez sur l’icône d’engrenage ⚙️ à côté de son titre : cochez Use your GitHub Pages website (le lien de votre site apparaît alors dans cette carte, visible par n’importe qui arrivant sur le repo), et profitez-en pour remplir le champ Description avec la phrase qui résume votre projet.
Toujours dans Settings > General, tout en bas : Social preview. Uploadez une image (1280×640px recommandé) — c’est ce qui s’affiche en aperçu quand le lien de votre repo est partagé (Discord, réseaux sociaux…). La même image que celle utilisée en tête de votre README fonctionne très bien ici.
Le dossier docs/ de votre repo est un site Jekyll, hébergé par GitHub
Pages. Pas besoin d’installer quoi que ce soit pour modifier une page : le
navigateur suffit. Pratique pour une correction rapide, ou pour commencer
avant d’installer Ruby en local (voir le tutoriel suivant).
Sur GitHub.com, naviguez dans le dossier docs/ de votre repo jusqu’au fichier .md à modifier (par exemple docs/objectifs.md).
Cliquez sur l’icône crayon (✏️) en haut à droite du fichier affiché. L’éditeur Markdown de GitHub s’ouvre.
Modifiez le texte. Utilisez l’onglet Preview en haut de l’éditeur pour vérifier le rendu avant de valider — voir Syntaxe Markdown si besoin.
En bas de la page : un champ pour le titre du commit (résumé court), un champ optionnel pour la description. Choisissez Commit directly to the main branch pour une modification simple, ou Create a new branch and start a pull request si vous voulez une relecture — voir Utiliser les Pull Requests. Cliquez sur Commit changes.
Après un commit sur main, GitHub Pages reconstruit le site
automatiquement — comptez 1 à 2 minutes. Onglet Actions de votre repo
pour suivre la progression du build en direct.
Pratique pour une modification ponctuelle, mais vous ne voyez pas le rendu final avant publication (l’onglet Preview de GitHub n’applique pas le thème du site). Pour des changements plus lourds, construire le site en local (tutoriel suivant) permet de vérifier avant de publier.
| Symptôme | Cause probable | Solution |
|---|---|---|
| Pas d’icône crayon visible | Vous n’avez pas les droits d’écriture sur le repo | Vérifiez que vous êtes bien collaborateur du repo |
| Le site ne se met pas à jour après le commit | Le build GitHub Actions a échoué | Onglet Actions, ouvrez le run en échec pour voir l’erreur (souvent une erreur de syntaxe dans le front matter) |
| La mise en page semble cassée après modification | Front matter YAML mal formé (indentation, guillemets) | Comparez avec une autre page qui fonctionne |
Modifiez une ligne de votre documentation directement depuis GitHub.com, prévisualisez, committez, et vérifiez dans l’onglet Actions que le site s’est reconstruit sans erreur.