En un apunt anterior sobre Jekyll vam veure com instal·lar Jekyll tant al servidor com a l'ordinador personal. En aquest article s'explicarà l'estructura bàsica d'aquesta plataforma, així com la jerarquia de directoris.
_includes
En aquest directori es troben tots els fitxers HTML en què es basa la nostra pàgina. Per exemple, si la nostra pàgina té un avís que es mostra per acceptar la política de galetes, aquest html aniria en aquest directori amb el fitxer JavaScript (si el necessités).
En aquesta carpeta també és habitual trobar elements comuns a totes les pàgines del nostre web. Per exemple, la capçalera i el peu de pàgina (anomenats header.html i footer.html per defecte).
_layouts
S'hi troben els diferents esquemes de cada pàgina que compon el nostre web. Per exemple, si el nostre web té una pàgina principal (tots en tenen) i diverses pàgines per a apunts d'un blog, és lògic crear una plantilla html que sigui comuna per a tots els apunts i després llegir els continguts de diferents fitxers de text (en els quals sempre és més fàcil redactar que en html) en format MarkDown(.md).
_posts
En aquest directori s'agrupen els diferents articles o subpàgines que té un web. Això és molt útil en un blog, per exemple, com s'ha descrit abans. Cada entrada correspon a un fitxer .md, que per convenció té el nom següent: AAAA-MM-DD-nombre-del-articulo.md , on AAAA-MM-DD és la data de redacció en format anglès.
Dins de cada fitxer .md, se sol començar amb una capçalera perquè es mostri en l'html i afegeixi funcionalitat a la pàgina, com ara crear etiquetes: Aquí, layout fa referència a la plantilla definida prèviament a _layouts; title és el títol, description la seva descripció, modified la data que es mostra als visitants en format anglosaxó, category la categoria principal i tags les etiquetes.
—layout: post (lo habremos definido en _layouts)title: ¡Hola Mundo! (título) description: “Este es el primer artículo de una serie de 100” (descripción del mismo) modified: 2017-08-14 (fecha que se mostrará a los visitantes, formato anglosajón)category: linux (categoría principal)tags: [Arch, linux, OpenSource, LXDE] (etiquetas)—
_site
Aquesta carpeta la crea automàticament jekyll i no és recomanable modificar-la; qualsevol canvi que vulguem fer el podem retocar al directori arrel del nostre projecte.
_drafts
Similar a posts, però només per a esborranys (articles no públics).
Directori arrel
En aquest directori (fora de totes les carpetes esmentades) es poden crear més fitxers o subpàgines, entre els quals els següents són obligatoris:
- index.html
És la pàgina principal del nostre programa. És normal que faci servir diferents components de layouts i que així el projecte estigui més ben organitzat. - _config.yml
Aquest fitxer és el més crític i fonamental de la nostra pàgina. Sense aquest fitxer, el nostre web no funcionarà; és el que administra les diferents subpàgines i conté tota la informació de configuració. També podem afegir-hi totes les constants que podem fer servir al llarg de totes les subpàgines, per exemple, l'id de Google Analytics.
Les etiquetes més habituals són:
layout: post (lo habremos definido en _layouts)
title: ¡Hola Mundo! (título)
description: "Este es el primer artículo de una serie de 100" (descripción del mismo)
modified: 2017-08-14 (fecha que se mostrará a los visitantes, formato anglosajón)
category: linux (categoría principal)
tags: [Arch, linux, OpenSource, LXDE] (etiquetas)És habitual veure moltes més etiquetes, però això ja dependrà del tema amb què treballem.
David Población Criado, estudiant d'Enginyeria Informàtica i Estadística a la Universitat de Valladolid.