Come installare Jekyll Static Website Generator su Ubuntu 22.04

Questo tutorial esiste per queste versioni del sistema operativo

Ubuntu 22.04 (Jammy Jellyfish)
Ubuntu 18.04 (Bionic Beaver)

Su questa pagina

Prerequisiti
Per iniziare
Installa Ruby
Crea un nuovo sito web con Jekyll
Avvia Jekyll Server
Accedi al sito web di Jekyll
Conclusione

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 i layout per creare un sito Web statico. Puoi utilizzare le funzionalità integrate di Jekylls per modificare l'aspetto del sito, gli URL, i dati visualizzati sulla pagina e altro ancora. Offre tantissime 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 tuo sistema è aggiornato, installa le altre dipendenze richieste 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 Rubino

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 le gemme nella cartella home del nostro utente.

Puoi farlo modificando il file ~/.bashrc:

nano ~/.bashrc

Aggiungere le seguenti righe alla fine del file:

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

Salvare e chiudere il file, quindi attivare la variabile d'ambiente con il seguente comando:

source ~/.bashrc

Successivamente, puoi installare Jekyll e bundler usando 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 denominato 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, elenchi 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 Jekyll Server

Innanzitutto, vai alla 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 si avvia 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 di 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:

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.