Referință rapidă

Fișă de Referință Generator Site-uri Statice Jekyll

Ghid complet pentru Jekyll: structura directoarelor, antet YAML Front Matter, etichete și filtre Liquid, variabile, colecții și configurare GitHub Pages.

· Publicat

Jekyll este un generator de site-uri statice orientat spre bloguri, scris în Ruby, care stă la baza GitHub Pages.

Structura Directoarelor

├── _config.yml      # Configurația globală a site-ului
├── _drafts/         # Articole ciornă nepublicate
├── _includes/       # Fragmente de șabloane reutilizabile
├── _layouts/        # Machete de layout pentru pagini și articole
├── _posts/          # Articole publicate (YYYY-MM-DD-title.md)
├── _data/           # Fișiere structurate de date JSON/YAML
├── _site/           # Rezultatul HTML static generat
└── index.md         # Fișierul de pornire al paginii principale

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
---

Sintaxa Șabloanelor Liquid

Afișare și Variabile

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

Controlul Fluxului și Iterație

{% 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 %}

Filtre Frecvente

Filtru Descriere Exemplu
date: "%Y-%m-%d" Formatează marcajul de timp {{ page.date | date: "%Y" }}
truncate: 100 Trunchează textul cu puncte de suspensie {{ post.content | truncate: 100 }}
strip_html Elimină tot marcajul HTML {{ post.content | strip_html }}
jsonify Serializează datele în șir JSON {{ site.data.authors | jsonify }}
markdownify Convertește Markdown în HTML {{ text | markdownify }}

Referință Variabile Globale

  • site.posts: Lista invers cronologică a tuturor articolelor.
  • site.pages: Lista tuturor paginilor statice.
  • site.html_pages: Submulțimea site.pages care produce HTML.
  • site.data: Date brute încărcate din fișierele _data/*.yml.
  • site.time: Marcajul de timp curent al construcției.

Referințe

Subiecte conexe