Una de les dificultats que vaig experimentar a l' intentar passar de Worpress a Jekyll fue entendre perquè era cada component i com interactuaven entre si. La solució la vaig trobar quan vaig deixar d'intentar crear el meu blog des de zero i vaig començar a fer enginyeria inversa a un tema desenvolupat per una altra persona. Els avantatges de el codi obert.
Per començar, assumint que vas instal·lar els requisits previs que vam indicar en els articles anteriors, crearem el nostre lloc. L'exemple és un bloc de jardineria.
jekyll new blog_de_jardineria
Si vas a la carpeta vas a veure el següent:
- Una carpeta anomenada _posts.
- Dos arxius amb extensió Markdown
- Una pàgina web.
- Un arxiu de configuració amb extensió .yml de què parlarem extensament en el proper article.
- Un arxiu Gemfile que llista els componetes de el lloc i un altre de el mateix nom però amb extensió .lock que evita que seh facin modificacions involuntàries.
L'estructura de el projecte
A l'igual que qualsevol lloc basat en WordPress, Jekyll també crea una estructura de carpetes on guarda tots els arxius, i ho fa pels mateixos motius. Permetre que l'usuari agrupi els arxius d'una manera ordenada i q ai, a mesura que el projecte creixi, segueixi sent manejable.
La carpeta base la vam crear amb la comanda jekyll new.
Dins d'ella trobem dos tipus de carpetes; les que estan relacionades amb la configuració de l'bloc que s'identifiquen amb un guió davant de el nom (en el nostre cas la carpeta _POST i les que tenen recursos que no s'inclouran com a part de el procés de creació. Per exemple les que contenen imatges.
Carpetes basades en contingut
En aquest grup si emmagatzema contingut destinat als visitants de el lloc
_ post
la carpeta _POST conté totes les entrades de blog. Aquí s'utilitza un format molt específic per a cada un dels arxius que es guarden en ella. El nom de l'arxiu ha d'estar en el format de data-nom d'arxiu - any-mes-data-nombre_archivo_completo.md - i aquesta data de publicació es mostrarà com la data en la qual es va realitzar aquesta publicació al blog de Jekyll. Hem de tenir en compte que encara que la carpeta es digui _ posts, aquí va tot el contingut que veuran els lectors de l'bloc, per exemple el formulari de contacte o les biografies dels autors. Més endavant veurem que és possible assignar diferents dissenys a les pàgines.
_drafts
És l'equivalent a guardar esborrany de WordPress. El seu ús recomanat és per als post que no estan preparats per publicar encara que poden usar-se per almecenar llistes d'idees, dissenys per utilitzar més endavant, etc.
_includes
En aquest espai podem emmagatzemar codi html que es pot reutilitzar en diverses ocasions. Per exemple, en el nostre cas un banner que saludi per l'inici d'una estació depenent de l'hemisferi en el qual estigui l'usuari.
_layouts
Com vam dir més amunt, diferents parts de l'contingut poden necessitar diferents dissenys. Per exemple, per mostrar un video podem quererer que la pàgina sigui a una sola columna, mienras que si es tracta d'un autor convidat necessitaríem una columna perquè es vegi la seva biografia i dades de contacte. En aquesta carpeta s'emmagatzemen els diferents dissenys que utiizará el lloc.
Carpetes d'informació
Aquestes dues carpetes són utilitzades pel lloc per al seu funcionament.
_data
En un bloc unipersonal, l'arxiu de configuració pot emmagatzemar totes les dades necessàries. Però, si tenim un bloc amb molts autors es necessita una altra manera de gestionar la informació. la carpeta _data s'utilitza per emmagatzemar dades en formats JSON o CSV que el lloc pot recuperar d'acord a la interacció amb els usuaris.
_site
la carpeta _site la completa el lloc amb tota la informació disponible a les carpetes anteriors. Aquí trobarem el lloc que pujarem a l'servidor perquè puguin accedir els usuaris. Per descomptat que a l'tractar-se de codi html i css és possible realitzar-li modificacions com a qualsevol altre lloc web.
En el proper article començarem a modificar l'arxiu de configuració.