Vazhdimi me këtë seri e artikujve se si shkova nga WordPress në Jekyll, Ka ardhur koha të lëmë pas teorinë dhe të kalojmë në praktikë.
Po përshkruaj hapat e konfigurimit në kuptimin që i kam bërë. Skedari i parë për të redaktuar është config.yml. Në këtë gjejmë konfigurimin e paracaktuar të faqes. Secilit post ose faqe të veçantë mund t'i caktohet një konfigurim i ndryshëm. Por, nëse nuk e bëjmë, do të caktohet ai i vendosur në këtë skedar.
Mos harroni se në artikullin e mëparshëm kishim shkarkuar një temë dhe po bazohemi në të për krijimin e faqes sonë.
Zgjatja .yml tregon që dokumenti është shkruar duke përdorur YAML. Kjo gjuhë lejon që hierarkitë midis të dhënave të vendosen në një mënyrë që është e kuptueshme për të dy kompjuterët dhe njerëzit. Jekyll e përdor atë për t'i dhënë qëndrueshmëri përbërësve të ndryshëm të një projekti.
Si të konfiguroni faqen duke përdorur YAML
Një projekt themelor i Jekyll përmban një skedar config.yml që na lejon të përcaktojmë disa parametra.
Këto parametra përfaqësohen në format
Kategoria: ”përmbajtje” Vlen të përmendet se paraprihet nga shenja # ajo është injoruar, kështu që nëse duam që Jekyll të përdorë atë parametër duhet ta heqim atë.
Në skedarin tonë config.yml do të shohim diçka si kjo:
title:
Titulli i faqes
email:
Emaili i faqes
description:
Një përshkrim i objektit të faqes që duhet të shfaqin motorët e kërkimit
baseurl
: Nëse blogu është pjesë e një faqe tjetër dhe i është caktuar një dosje specifike, ajo tregohet këtu
url:
Domeni kryesor i faqes.
Ekzistojnë edhe dy kategori të tjera.
twitter_username
github_username:
Këto dy parametra tregojnë lidhje me llogaritë e përdoruesve të Twitter dhe Github.
Më poshtë do t'i tregoni Jekyll se cilën temë të përdorë dhe cilat shtesa.
Konfiguro.yml në gabimet minimale
NNe do të përdorim një temë me shumë mundësi të tjera dhe, për këtë arsye, kërkon një konfigurim.yml më të plotë. Më praktike është kopjimi dosjen nga projekti i temës dhe ngjiteni në tonën në vend të përmbajtjes së tij. Pasi të jetë bërë kjo, ne editojmë parametrat e mëposhtëm
Mos harroni se projekti ynë shembull ishte një blog kopshtarie.
Gjëja e parë që duhet të bëjmë është të krijojmë temën. Në këtë linjë
# theme : "minimal-mistakes-jekyll
»Ne fshijmë simbolin e numrit" # "
Kjo temë ofron disa variacione. Më pëlqen thirrja Aqua. Ne komentojmë mbi "parazgjedhjen" duke vendosur simbolin #d përpara emrit dhe mos komento "aqua"
Locale tregon gjuhën e faqes në internet në formatin language_VARIANT. Për shembull, pasi jam në Argjentinë është
locale : "es-AR
»
Ju mund të gjeni listën e gjuhëve në kjo faqe
Ne tregojmë titullin e faqes
title : "Blog de jardinería"
Ne zgjedhim një ndarës midis titullit të faqes dhe atij të postimit në mënyrë që të shfaqet saktë në motorët e kërkimit.
title_separator : "-"
Mund të shtojmë një titër
subtitle: “Llevamos la naturaleza a tu computadora”
Ne tregojmë emrin e personit përgjegjës të faqes
name : "Rosendo Margarito Flores"
Ne përfundojmë përshkrimin e faqes për tu shfaqur në motorët e kërkimit dhe në faqen kryesore
description : "Un blog para difundir el auto cultivo de vegetales y flores entre aquellos que no tienen la menor idea de cómo se hace."
Dy parametrat e ardhshëm janë dy njohje të vjetra, por në rend të kundërt.
ENë rastin e parë ne tregojmë domenin e faqes
url: "https: //desdeeljardin.flor"
Supozoni se blogu ynë ishte pjesë e një dyqani farërash. Ne mund të dëshirojmë t'i japim adresën e vet standarde nga lulja / blogu i kopshtit.
Atëherë ne bëjmë
baseurl : "/blog"
Për disa arsye, postimet me imazhe kanë më shumë vizita sesa ato pa. Në rast se nuk u keni caktuar një, ju mund të bëni një shfaqje të paracaktuar duke aktivizuar këtë parametër.
teaser : "/assets/images/500x300.png"
Për të shmangur konfuzionin, unë do të ruaj strukturën origjinale të skedarit të temës. Prandaj, në dosjen tonë të projektit ne duhet të krijojmë një dosje të quajtur pasuri, brenda saj një imazhe të quajtur, dhe brenda saj një pixel 500 × 300 të quajtur 500 × 300.png
Ne gjithashtu mund të zgjedhim logon e faqes. Ne përsërisim procedurën për ta krijuar dhe ruajtur atë në të njëjtat dosje dhe plotësojmë parametrin:
logo : "/assets/images/88x88.png"
Ne mund të zgjedhim një titull të ndryshëm nga faqja që do të shfaqet në krye shfletuesi
masthead_title: “¡Feliz primavera!”
Në artikullin vijues do të vazhdojmë të rishikojmë opsionet e konfigurimit. Por, përfitoj nga rasti të sqaroj se nuk kam ide për kopshtarinë. Prandaj unë nuk jam përgjegjës për atë që thotë blog-u shembull.