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.
Link file locali
una immagine:
1
2
... come mostrato nella immagine qui sotto:
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