Dans certains cas il peut être intéressant de configurer sont environnement de développement Jekyll en local (dans son Home) plutôt que d’utiliser une installation centralisée.
Cela doit permettre d’obtenir une meilleure stabilité de l’environnement et tester différentes versions.

Prérequis

La première chose à faire est d’installer les prérequis, ce qui donne avec un environnement Debian :

apt-get install ruby ruby-dev bundler

Configuration de l’environnement

Pour que Jekyll s’installe en local il faut configurer son environnement pour que l’installation des modules Ruby se fasse dans un dossier local et non pas un dossier système.

Dans le fichier $HOME/.bashrc rajouter les lignes :

# Set paths for Ruby gems:
PATH=$HOME/ruby/gems/bin:$PATH
GEM_HOME=$HOME/ruby
GEM_PATH=$HOME/ruby/gems:/usr/lib/ruby/gems/1.8
export PATH GEM_HOME GEM_PATH

Créer un fichier $HOME/.gemrc contenant :

gemhome: $HOME/ruby/gems
gempath:
- $HOME/ruby/gems
- /usr/lib/ruby/gems/1.8

Pour finaliser la configuration locale il faut créer les dossiers : mkdir -p $HOME/ruby/gems/bin.

Pour activer cette configuration on utilise la commande source .bashrc.
Lors d’une prochaine session elle sera activée puisque le fichier $HOME/.basrc est exécuté à chaque ouverture de session.

Pour contrôler que l’environnement est Ok on utilise la commande gem environment.

Installer Jekyll

L’installation de Jekyll se fait avec la commande gem install jekyll.

On contrôle que Jekyll est bien installé dans le dossier local avec la commande which jekyll, elle doit retourner $HOME/ruby/gems/bin/jekyll

Création du site Jekyll

La création d’un site se fait avec la commande jekyll new nom-du-site ce qui créé un dossier nom-du-site dans le répertoire courant.
Il faut finaliser la création su site avec les commandes cd nom-du-site ; bundle install.

La commande bundle install va installer les modules Ruby requis par le projet de site. On vérifiera qu’ils s’installent dans le dossier $HOME/ruby/gems/gems/.

Pour tester le site on utilise la commande jekyll serve, il sera disponible à l’adresse http://localhost:4000. Si on veut accéder au site en développement depuis un autre poste il faudra utiliser la commande jekyll serve --host 0.0.0.0 ce qui le rendra accessible en utilisant l’URL http://<adresse du poste>:4000.