Jekyll sur OpenBSD

Jekyll est un générateur de sites web statiques encore beaucoup utilisé mais qui nécessite sur OpenBSD une installation à partir des gems.

Installation de Jekyll

En ce qui me concerne, j’ai déjà installé ruby, gem et bundler en tant que root. Ainsi je dispose des commandes gem32 et bundle32.

Mais j’ai décidé d’installer Jekyll dans mon répertoire utilisateur.

Avant de commencer ajoutons /home/username/.local/share/gem/ruby/3.2/bin à la variable PATH dans .profile

PATH=$HOME/bin:/bin:/sbin:/usr/bin:/usr/sbin:
/usr/X11R6/bin:/usr/local/bin:
/usr/local/sbin:/usr/local/jdk-1.8.0/bin:
/home/username/.local/share/gem/ruby/3.2/bin

En exécutant la commande:

gem32 install jekyll --user-install

une erreur se produit dans l’installation de dart-sass.

Une solution de secours (vue sur le site https://github.com/jekyll/jekyll/issues/9493) est d’installer au préalable jekyll-sass-converter:

gem32 install jekyll-sass-converter -v 2.2  --user-install

puis d’installer à nouveau Jekyll:

gem32 install jekyll --user-install

Cette fois Jekyll s’est installé et la commande jekyll32 est active.

Mais si nous tentons de créer un blogue avec la commande:

jekyll32 new myblog

nous constatons qu’il manque des gems dont Jekyll dépend.

Exécutons les deux lignes suivantes

bundle32 config set --local path '/home/username/.local/share/gem'

bundle32 install

pour qu’il les rajoute automatiquement.

Création d’un blogue

Lançons la commande:

jekyll32 new yourblog

cd yourblog

bundle32 exec jekyll32 serve

Dans votre navigateur internet, nous pouvons visionner notre blogue en nous connectant à l’adresse http://127.0.0.1:4000

Ajout d’extensions

Nous allons ajouter à notre blogue l’extension jekyll-polyglot. Pour cela éditons le fichier Gemfile et insérons dans le groupe jekyll_plugins une ligne contenant gem "jekyll-polyglot":

group :jekyll_plugins do
  gem "jekyll-polyglot"
end

Exécutons dans le répertoire yourblog les commandes:

bundle32 config set --local path '/home/username/.local/share/gem'
   
bundle32 install

Ensuite, pour que jekyll-polyglot prenne en charge certaines langues comme l’anglais et le français, il suffit d’insérer dans le fichier _config.yml les lignes suivantes:

languages: ["en", "fr"]
default_lang: "en"
exclude_from_localization: ["javascript", "images", "css", "public"]
parallel_localization: true