Pagina principale Jekyll - creare siti statici
Post
Cancella

Jekyll - creare siti statici

Jekyll è un “generatore” di siti statici che trasforma il tuo plain text in bellissimi siti Web e blog statici. Può essere utilizzato per un sito di documentazione, un blog, un sito di eventi o qualsiasi altro tipo di sito Web anche per un portfolio se siete in cerca di lavoro. È veloce, sicuro, facile e soprattuto open source. Oggi installeremo e configureremo Jekyll utilizzando il tema Chirpy (attuale tema che state vedendo per questo sito).

Dipendenze da installare

1
2
sudo apt update
sudo apt install ruby-full build-essential zlib1g-dev git

Per evitare che i pacchetti RubyGems installati con user root:

se stai usando bash (di default per molti)

1
2
3
4
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

se stai usando zsh invece:

1
2
3
4
echo '# Install Ruby Gems to ~/gems' >> ~/.zshrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.zshrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Installa Jekyll bundler

1
2
gem install jekyll bundler

Creare un sito sul tema Chirpy

Vista https://github.com/cotes2020/jekyll-theme-chirpy#quick-start

Dopo aver creato il sito su questo template, clona il repository

1
git clone git@<YOUR-USER-NAME>/<YOUR-REPO-NAME>.git

installa le tue dipendenze:

1
2
cd repo-name
bundle

Dopo aver fatto le tue modifiche sul sito, esegui commit e push su git

1
2
3
git add .
git commit -m "alcune modifiche"
git push

Comandi Jekyll

per inizializzare il tuo sito:

1
bundle exec jekyll s

in modalità produzione:

1
JEKYLL_ENV=production bundle exec jekyll b

l’output del tuo sito sarà sulla seguente directory _site

Eseguirlo tramite Docker

Crea un Dockerfile come segue:

1
2
FROM nginx:stable-alpine
COPY _site /usr/share/nginx/html

Eseguilo in modalità production:

1
JEKYLL_ENV=production bundle exec jekyll b

In seguitlo crea la tua immagine:

docker build .

Creare un Post

Naming Conventions

Jekyll usa una naming convention per le pagine e i post

Crea un file sotto _posts con il seguente formato:

ANNO-MESE-GIORNO-titolo.md

Esempio:

2022-08-01-documenti.md
2022-07-05-specifiche-hardware.md

Jekyll può ritardare la visualizzazione dei post che hanno una data futura. Controlla la data e la time zone configurato sul tuo post se non lo vedi apparire dopo una re-build.

una immagine:

1
2
... come mostrato nella immagine qui sotto:
![A screenshot](/assets/screenshot.jpg)

Link di un file:

1
... puoi [download il PDF](/assets/diagram.pdf) qui.

puoi vedere ulteriori regole di formattazione sul sito

Esempi di Markdown

Se hai bisogno di alcuni suggerimenti per il markdown, verifica qui appunti markdown

Questo post è sotto licenza CC BY 4.0 a nome dell'autore.

Certificati SSL Self-Signed How-To

Appunti per comandi network per linux