Guide pratique : Mise en place d’un environnement de développement Jekyll
Ce guide explique comment configurer un environnement de développement pour un site Jekyll sur Windows, en tenant compte des spécificités de cet OS et des éventuels problèmes liés aux dépendances.
1. Pré-requis
Avant de commencer, assurez-vous d’avoir installé :
- Ruby :
Téléchargez Ruby avec DevKit depuis rubyinstaller.org.- Choisissez la version 3.2.x (recommandée pour Jekyll).
- Pendant l’installation, activez l’option pour configurer MSYS2.
-
Node.js (optionnel, pour certains plugins) :
Installez la version LTS depuis nodejs.org. -
Git :
Téléchargez et installez depuis git-scm.com. - Navigateur web :
Pour prévisualiser le site (par défaut, disponible àhttp://localhost:4000
).
2. Configuration initiale
a. Installer Ruby et vérifier les outils
-
Installer Ruby avec DevKit.
Pendant l’installation, suivez les instructions pour configurer MSYS2. - Mettre à jour RubyGems et Bundler :
gem update --system gem install bundler
- Vérifier les outils de développement (Windows) :
Assurez-vous que les outils nécessaires sont installés avec MSYS2 :ridk install ridk exec pacman -Syu ridk exec pacman -S --needed base-devel mingw-w64-x86_64-toolchain
3. Créer un nouveau site Jekyll
a. Installation de Jekyll
Installez Jekyll globalement :
gem install jekyll
b. Créer un nouveau projet
Générez un nouveau site Jekyll :
jekyll new mon-site
cd mon-site
c. Installer les dépendances du projet
bundle install
d. Démarrer le serveur Jekyll
Lancez le serveur de développement :
bundle exec jekyll serve
Visitez le site dans votre navigateur à http://localhost:4000.
4. Travailler sur un site existant
a. Récupérer le dépôt
Clonez le dépôt de votre site :
git clone https://github.com/votre-utilisateur/votre-repo.git
cd votre-repo
b. Installer les dépendances
Assurez-vous d’avoir le fichier Gemfile
et exécutez :
bundle install
c. Résolution des problèmes courants
- Erreur avec
wdm
sous Windows :
Si vous rencontrez des erreurs liées àwdm
, commentez cette ligne dans leGemfile
:# gem "wdm", "~> 0.1.1", platforms: [:mingw, :x64_mingw, :mswin]
Relancez l’installation :
bundle install
- Dépendances obsolètes ou en conflit :
Si une erreur persiste, essayez :bundle update
5. Notes et astuces importantes
a. Contexte Windows
- Compatibilité des gems :
Certains gems nécessitent des compilations natives (ex. :ffi
,wdm
). Assurez-vous que MSYS2 est correctement installé. - Pas de
wdm
? : Utilisez cette commande pour éviter les problèmes de rechargement automatique :bundle exec jekyll serve --no-watch
b. Verrouiller les versions
Pour éviter les conflits futurs, utilisez des versions précises dans votre Gemfile
. Par exemple :
gem "jekyll", "~> 4.3.4"
gem "minima", "~> 2.5.2"
c. Résolution des warnings Sass
Vous pouvez migrer vos fichiers Sass pour remplacer les règles @import
par @use
:
- Remplacez :
@import "minima";
- Par :
@use "minima";
6. Ressources supplémentaires
En suivant ce guide, vous devriez pouvoir configurer un environnement fonctionnel pour travailler avec Jekyll, même sur Windows. En cas de problème, les logs d’erreur sont souvent très utiles pour identifier et résoudre les conflits. 😊