Comment installer le générateur de site Web statique Jekyll sur Ubuntu 22.04

Jekyll est un générateur de fichiers statiques gratuit et open-source écrit en Ruby. C’est un système de gestion de contenu simple et facile à utiliser qui permet de créer un site Web en quelques minutes. Il prend du texte écrit dans votre langage de balisage préféré et utilise des mises en page pour créer un site Web statique. Vous pouvez utiliser les fonctionnalités intégrées de Jekyll pour ajuster l’apparence du site, les URL, les données affichées sur la page, et plus encore. Il offre une multitude de fonctionnalités telles que des permaliens, des catégories, des pages, des articles, des mises en page personnalisées, et bien d’autres.

Dans ce tutoriel, nous allons vous montrer comment installer Jekyll CMS sur Ubuntu 22.04.

Prérequis

• Un serveur exécutant Ubuntu 22.04.
• Un mot de passe root configuré sur votre serveur.

Prise en main

Avant de commencer, il est recommandé de mettre à jour votre système avec la dernière version stable. Vous pouvez le mettre à jour avec la commande suivante :

apt update -y  
apt upgrade -y

Une fois votre système à jour, installez les autres dépendances requises en exécutant la commande suivante :

apt install make build-essential curl git tree -y

Une fois toutes les dépendances installées, vous pouvez passer à l’étape suivante.

Installer Ruby

Jekyll est écrit en Ruby, vous devrez donc l’installer sur votre système. Par défaut, le paquet Ruby est inclus dans le dépôt par défaut d’Ubuntu.

Exécutez la commande suivante pour installer Ruby :

apt install ruby ruby-dev -y

Une fois l’installation terminée, vous devrez indiquer au gestionnaire de paquets gem de Ruby de placer les gems dans le dossier personnel de notre utilisateur.

Vous pouvez le faire en modifiant le fichier ~/.bashrc :

nano ~/.bashrc

Ajoutez les lignes suivantes à la fin du fichier :

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Enregistrez et fermez le fichier, puis activez la variable d’environnement avec la commande suivante :

source ~/.bashrc

Ensuite, vous pouvez installer Jekyll et bundler en utilisant la commande gem comme indiqué ci-dessous :

gem install jekyll bundler

Une fois l’installation terminée, vous pouvez passer à l’étape suivante.

Créer un nouveau site Web avec Jekyll

À ce stade, Jekyll est installé sur votre système. Maintenant, exécutez la commande suivante pour créer un nouveau site Web nommé jekyll.example.com :

jekyll new jekyll.example.com

Une fois le site Web créé, vous devriez obtenir la sortie suivante :

  Bundler: Using jekyll 4.2.2
  Bundler: Fetching jekyll-seo-tag 2.8.0
  Bundler: Fetching jekyll-feed 0.16.0
  Bundler: Installing jekyll-feed 0.16.0
  Bundler: Installing jekyll-seo-tag 2.8.0
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 7 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
  Bundler: installing your bundle as root will break this application for all non-root
  Bundler: users on this machine.
New jekyll site installed in /root/jekyll.example.com. 

Ensuite, vous listez tous les fichiers et répertoires créés par Jekyll avec la commande suivante :

tree jekyll.example.com

Vous devriez obtenir la sortie suivante :

jekyll.example.com
??? 404.html
??? about.markdown
??? _config.yml
??? Gemfile
??? Gemfile.lock
??? index.markdown
??? _posts
    ??? 2022-09-25-welcome-to-jekyll.markdown

1 directory, 7 files

Démarrer le serveur Jekyll

Tout d’abord, naviguez vers le répertoire du site Web et ajoutez la dépendance webrick en utilisant la commande suivante :

cd jekyll.example.com  
bundle add webrick

Ensuite, démarrez le serveur Web Jekyll en exécutant la commande suivante :

jekyll serve --host=0.0.0.0

Une fois le serveur démarré avec succès, vous devriez obtenir la sortie suivante :

Configuration file: /root/jekyll.example.com/_config.yml
            Source: /root/jekyll.example.com
       Destination: /root/jekyll.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.375 seconds.
 Auto-regeneration: enabled for '/root/jekyll.example.com'
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

Accéder au site Web Jekyll

À ce stade, Jekyll est démarré et écoute sur le port 4000. Maintenant, ouvrez votre navigateur Web et tapez l’URL http://your-server-ip:4000. Vous serez redirigé vers la page par défaut de Jekyll :

Conclusion

Dans le guide ci-dessus, vous avez appris comment installer Jekyll sur Ubuntu 22.04. Vous pouvez maintenant explorer Jekyll et créer votre propre site Web en utilisant le contenu généré automatiquement.