Créer un blog personnel avec Jekyll pour aller plus loin

Introduction

Créer un blog personnel est une excellente manière de partager vos idées, vos passions ou vos projets. Jekyll est un générateur de sites statiques très populaire qui vous permet de le faire facilement. Il se distingue par sa simplicité et son intégration parfaite avec GitHub Pages. Dans ce tutoriel, nous allons explorer les étapes nécessaires pour mettre en place votre propre blog avec Jekyll.

Étapes (détaillées)

Étape 1 : Installation de Jekyll

Avant de commencer, assurez-vous d’avoir Ruby installé sur votre machine. Vous pouvez vérifier cela en exécutant la commande suivante dans votre terminal :

ruby -v

Si Ruby n’est pas installé, vous pouvez le télécharger depuis le site officiel de Ruby.

Une fois Ruby installé, vous pouvez installer Jekyll et Bundler avec la commande suivante :

gem install jekyll bundler

Étape 2 : Création de votre nouveau site

Pour créer un nouveau blog avec Jekyll, utilisez la commande suivante :

jekyll new mon_blog

Cette commande crée un nouveau dossier appelé mon_blog avec la structure de fichiers de base pour votre blog.

Étape 3 : Accéder à votre dossier

Déplacez-vous dans le dossier de votre nouveau site :

cd mon_blog

Étape 4 : Lancer le serveur local

Pour voir votre site en action, vous pouvez démarrer un serveur local. Exécutez :

bundle exec jekyll serve

Votre blog sera accessible à l’adresse http://localhost:4000.

Étape 5 : Personnaliser votre blog

Ouvrez le fichier _config.yml dans votre éditeur de texte. C’est ici que vous pouvez configurer les informations de votre blog, comme le titre, la description et l’URL.

title: Mon Blog Personnel
description: Un espace pour partager mes idées et mes projets.
url: "http://monurl.com"

Étape 6 : Créer des articles

Pour ajouter un nouvel article, allez dans le dossier _posts et créez un fichier au format suivant : YYYY-MM-DD-nom-de-mon-article.md. Par exemple :

---
layout: post
title: "Mon premier article"
date: 2023-10-01
---
Voici le contenu de mon premier article.

Étape 7 : Ajouter des thèmes

Jekyll propose une variété de thèmes que vous pouvez utiliser. Vous pouvez les explorer sur la page des thèmes Jekyll. Pour installer un thème, ajoutez-le à votre fichier _config.yml sous la clé theme.

theme: minima

Étape 8 : Publier sur GitHub Pages

Pour publier votre blog sur GitHub Pages, créez un nouveau dépôt sur GitHub. Ensuite, utilisez les commandes suivantes pour lier votre projet à ce dépôt :

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/votre_nom_utilisateur/mon_blog.git
git branch -M main
git push -u origin main

Ensuite, activez GitHub Pages dans les paramètres de votre dépôt.

Comparaison avec Hugo et Gatsby

Bien que Jekyll soit un excellent choix, il est intéressant de le comparer à d’autres générateurs de sites statiques comme Hugo et Gatsby.

• Hugo est connu pour sa rapidité et sa simplicité. Il utilise Go comme langage de développement et offre une compilation plus rapide que Jekyll, particulièrement pour les sites de grande taille.

• Gatsby, de son côté, est basé sur React et permet de créer des sites dynamiques avec des fonctionnalités avancées comme le chargement de données à la volée. C’est un excellent choix si vous souhaitez exploiter des API ou intégrer des éléments interactifs.

Dépannage

1. Le serveur ne démarre pas : Assurez-vous que toutes les dépendances sont correctement installées et que vous êtes dans le bon répertoire.

2. Les articles n’apparaissent pas : Vérifiez que vos fichiers dans _posts suivent bien le format de nommage et que les métadonnées YAML sont correctement renseignées.

3. Problèmes de déploiement sur GitHub Pages : Assurez-vous que votre branche est bien configurée pour GitHub Pages dans les paramètres de votre dépôt.

Conclusion

Félicitations ! Vous avez maintenant un blog personnel fonctionnel créé avec Jekyll. Ce générateur de sites statiques est flexible et vous permet de personnaliser votre blog selon vos besoins. N’hésitez pas à explorer les thèmes, les plugins et à partager votre nouveau blog avec le monde. Bonne rédaction !