Cheatsheet Generatore di Siti Statici Jekyll

Jekyll è un generatore di siti statici orientato ai blog scritto in Ruby alla base di GitHub Pages.

Struttura delle Directory

├── _config.yml      # Configurazione globale del sito
├── _drafts/         # Bozze non pubblicate
├── _includes/       # Frammenti di template riutilizzabili
├── _layouts/        # Wrapper di layout per pagine e post
├── _posts/          # Post pubblicati (YYYY-MM-DD-title.md)
├── _data/           # File di dati JSON/YAML strutturati
├── _site/           # Output HTML statico compilato
└── index.md         # File di ingresso della homepage

YAML Front Matter

---
layout: post
title: "Announcing Version 2.0"
date: 2026-11-08 10:00:00 +0800
categories: news tech
tags: [release, ruby]
published: true
---

Sintassi dei Template Liquid

Output e Variabili

{{ site.title }}
{{ page.title }}
{{ content }}
{{ post.date | date: "%B %d, %Y" }}

Controllo di Flusso e Iterazione

{% if page.comments %}
  {% include comments.html %}
{% endif %}

{% for post in site.posts limit:5 %}
  <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
  <p>{{ post.excerpt }}</p>
{% endfor %}

Filtri Comuni

Riferimento Variabili Globali

• site.posts: Elenco in ordine cronologico inverso di tutti i post.
• site.pages: Elenco di tutte le pagine statiche.
• site.html_pages: Sottoinsieme di site.pages che genera HTML.
• site.data: Dati grezzi caricati dai file _data/*.yml.
• site.time: Timestamp della build corrente.

Riferimenti

• Documentazione Ufficiale di Jekyll
• Riferimento Linguaggio Liquid