Modifier Votre Site Jekyll sur GitHub

Ce guide explique comment modifier votre site Jekyll, utilisant le thème “Just the Docs”, directement depuis l’interface de GitHub.

Étape 1 : Accéder au Repository

  1. Connectez-vous à votre compte GitHub.
  2. Naviguez jusqu’au repository de votre site Jekyll.

Étape 2 : Trouver le Fichier à Modifier

  1. Dans le repository, trouvez le dossier qui contient les fichiers de votre site (Dossier /docs).
  2. Cliquez sur le fichier que vous souhaitez modifier. Les fichiers de contenu sont généralement écrits en Markdown (.md).

Étape 3 : Modifier le Fichier

  1. Une fois que vous avez ouvert le fichier, cliquez sur l’icône de crayon (🖉) en haut à droite du fichier pour commencer à éditer.
  2. Effectuez vos modifications dans l’éditeur. Utilisez la syntaxe Markdown pour formater le texte. (Voir syntaxe Markdown).

Étape 4 : Prévisualiser Vos Changements

  1. Descendez en bas de la page de l’éditeur.
  2. Cliquez sur l’onglet Preview changes pour prévisualiser vos modifications.

Étape 5 : Enregistrer les Modifications

  1. Après avoir vérifié et validé vos modifications, descendez en bas de la page.
  2. Entrez un titre de commit décrivant les modifications que vous avez effectuées.
  3. Optionnel : ajoutez une description plus détaillée.
  4. Choisissez de commiter directement dans la branche actuelle ou de créer une nouvelle branche pour une demande de pull (pull request).
  5. Cliquez sur Commit changes.

Étape 6 : Mettre à Jour le Site

Une fois que vous avez commis vos changements, Jekyll va automatiquement reconstruire le site avec les nouvelles modifications. Cela peut prendre quelques minutes. Une fois terminé, vos changements seront visibles sur le site.

Ce guide est destiné à aider les utilisateurs débutants avec GitHub et Jekyll. Pour des modifications plus complexes, il est nécessaire d’utiliser un IDE ou d’autres outils de développement.