Come installare Jekyll Static Website Generator su Ubuntu 22.04

Jekyll è un generatore di file statici gratuito e open-source scritto in Ruby. È un sistema di gestione dei contenuti semplice e facile da usare, utilizzato per creare un sito web in pochi minuti. Prende il testo scritto nel tuo linguaggio di markup preferito e utilizza layout per creare un sito web statico. Puoi utilizzare le funzionalità integrate di Jekyll per modificare l’aspetto e la sensazione del sito, gli URL, i dati visualizzati sulla pagina e altro ancora. Offre una tonnellata di funzionalità come permalink, categorie, pagine, post, layout personalizzati e molto altro.

In questo tutorial, ti mostreremo come installare Jekyll CMS su Ubuntu 22.04.

Prerequisiti

Un server che esegue Ubuntu 22.04.
Una password di root configurata sul tuo server.

Iniziare

Prima di iniziare, si consiglia di aggiornare il sistema con l’ultima versione stabile. Puoi aggiornarlo con il seguente comando:

apt update -y  
apt upgrade -y

Una volta che il sistema è aggiornato, installa le altre dipendenze necessarie eseguendo il seguente comando:

apt install make build-essential curl git tree -y

Una volta installate tutte le dipendenze, puoi procedere al passaggio successivo.

Installa Ruby

Jekyll è scritto in Ruby, quindi dovrai installarlo nel tuo sistema. Per impostazione predefinita, il pacchetto Ruby è incluso nel repository predefinito di Ubuntu.

Esegui il seguente comando per installare Ruby:

apt install ruby ruby-dev -y

Una volta completata l’installazione, dovrai dire al gestore di pacchetti gem di Ruby di posizionare i gem nella cartella home del nostro utente.

Puoi farlo modificando il file ~/.bashrc:

nano ~/.bashrc

Aggiungi le seguenti righe alla fine del file:

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

Salva e chiudi il file, quindi attiva la variabile d’ambiente con il seguente comando:

source ~/.bashrc

Successivamente, puoi installare Jekyll e bundler utilizzando il comando gem come mostrato di seguito:

gem install jekyll bundler

Una volta completata l’installazione, puoi procedere al passaggio successivo.

Crea un nuovo sito web con Jekyll

A questo punto, Jekyll è installato nel tuo sistema. Ora, esegui il seguente comando per creare un nuovo sito web chiamato jekyll.example.com:

jekyll new jekyll.example.com

Una volta creato il sito web, dovresti ottenere il seguente output:

  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.

Successivamente, elenca tutti i file e le directory creati da Jekyll con il seguente comando:

tree jekyll.example.com

Dovresti ottenere il seguente output:

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

Avvia il server Jekyll

Per prima cosa, naviga nella directory del sito web e aggiungi la dipendenza webrick utilizzando il seguente comando:

cd jekyll.example.com  
bundle add webrick

Successivamente, avvia il server web Jekyll eseguendo il seguente comando:

jekyll serve --host=0.0.0.0

Una volta che il server è avviato correttamente, dovresti ottenere il seguente output:

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.

Accedi al sito web Jekyll

A questo punto, Jekyll è avviato e in ascolto sulla porta 4000. Ora, apri il tuo browser web e digita l’URL http://your-server-ip:4000. Verrai reindirizzato alla pagina predefinita di Jekyll:

Jekyll

Conclusione

Nella guida sopra, hai imparato come installare Jekyll su Ubuntu 22.04. Ora puoi esplorare Jekyll e creare il tuo sito web utilizzando i contenuti generati automaticamente.