ממשיכים עם הסדרה הזו מאמרים על איך עברתי מ- WordPress ל- Jekyll, הגיע הזמן להשאיר את התיאוריה ולעבור לתרגול.
אני מתאר את שלבי התצורה במובן שעשיתי אותם. הקובץ הראשון שנערך הוא config.yml. בכך אנו מוצאים את תצורת ברירת המחדל של האתר. לכל פוסט או עמוד מסוים ניתן להקצות תצורה שונה. אך במקרה שלא, הקצה בקובץ זה יוקצה.
זכרו שבמאמר הקודם הורדנו נושא ואנחנו מתבססים על כך ליצירת האתר שלנו.
התוסף .yml מציין שהמסמך נכתב באמצעות YAML. שפה זו מאפשרת לקבוע היררכיות בין נתונים בצורה מובנת הן למחשבים והן לבני האדם. ג'קיל משתמשת בו בכדי לתת עקביות לרכיבים השונים של הפרויקט.
כיצד להגדיר את התצורה של האתר באמצעות YAML
פרויקט בסיסי של Jekyll כולל קובץ config.yml המאפשר לנו להגדיר כמה פרמטרים.
פרמטרים אלה מיוצגים בפורמט
קטגוריה: "תוכן" ראוי להזכיר כי לפניו השלט # זה מתעלם, אז אם אנחנו רוצים שג'קיל תשתמש בפרמטר הזה עלינו להסיר אותו.
בקובץ config.yml שלנו נראה משהו כזה:
title: כותרת האתר
email: דוא"ל האתר
description: תיאור של אובייקט האתר להצגת מנועי החיפוש
baseurl: אם הבלוג הוא חלק מאתר אחר ותיקיה ספציפית מוקצית לו, הוא מצוין כאן
url: התחום העיקרי של האתר.
ישנן גם שתי קטגוריות אחרות.
twitter_username
github_username:
שני פרמטרים אלה מציגים קישורים לחשבונות המשתמשים בטוויטר וב- Github.
להלן תגיד לג'קיל באיזה נושא להשתמש ובאילו תוספות.
Config.yml בטעויות מינימליות
Nאנו הולכים להשתמש בערכת נושא עם אפשרויות רבות נוספות ולכן נדרש config.yml מלא יותר. הכי פרקטי הוא להעתיק את הקובץ מפרויקט הנושא והדבק אותו בתוכנו במקום בתוכנו. לאחר שהדבר נעשה אנו עורכים את הפרמטרים הבאים
זכרו שפרויקט הדוגמה שלנו היה בלוג גינון.
הדבר הראשון שעלינו לעשות הוא לבסס את הנושא. בשורה זו
# theme : "minimal-mistakes-jekyll»אנו מוחקים את סמל הספרה" # "
נושא זה מציע מספר וריאציות. אני אוהב את השיחה אקווה. אנו מגיבים על "ברירת מחדל" על ידי הצבת הסמל #d לפני השם ואי התגובה "אקווה
אזור מציין את שפת האתר בפורמט language_VARIANT. למשל, מכיוון שאני בארגנטינה זה כך
locale : "es-AR»
תוכל למצוא את רשימת השפות ב esta página
אנו מציינים את כותרת האתר
title : "Blog de jardinería"
אנו בוחרים מפריד בין כותרת האתר לזו של ההודעה כך שהוא מוצג כראוי במנועי החיפוש.
title_separator : "-"
אנחנו יכולים להוסיף כותרת משנה
subtitle: “Llevamos la naturaleza a tu computadora”
אנו מציינים את שם האחראי על האתר
name : "Rosendo Margarito Flores"
אנו משלימים את תיאור האתר להצגה במנועי חיפוש ובדף הבית
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."
שני הפרמטרים הבאים הם שני מכרים ותיקים, אך בסדר הפוך.
Eבמקרה הראשון אנו מציינים את תחום האתר
url: «https: //desdeeljardin.flor»
נניח שהבלוג שלנו היה חלק מחנות זרעים. אולי נרצה להקצות לו כתובת סטנדרטית משלה מפרח הגן / הבלוג.
ואז אנחנו עושים זאת
baseurl : "/blog"
משום מה, בפוסטים עם תמונות יש יותר ביקורים מאלה שבלעדיה. במקרה שלא הקציתם להם אחד כזה, תוכלו לבצע תצוגת ברירת מחדל על ידי הפעלת פרמטר זה.
teaser : "/assets/images/500x300.png"
כדי למנוע בלבול, אני אשמור על מבנה הקובץ המקורי של הנושא. לכן, בתיקיית הפרויקט שלנו עלינו ליצור תיקייה הנקראת נכסים, בתוכה תמונות שנקראות, ובתוכה 500 × 300 פיקסלים הנקראים 500 × 300.png
אנו יכולים גם לבחור את לוגו האתר. אנו חוזרים על הליך יצירתו ושמירתו באותן תיקיות והשלמת הפרמטר:
logo : "/assets/images/88x88.png"
אנו יכולים לבחור כותרת שונה מהאתר שיוצג בחלקו העליון דפדפן
masthead_title: “¡Feliz primavera!”
במאמר הבא נמשיך לבחון את אפשרויות התצורה. אבל אני מנצל את ההזדמנות להבהיר שאין לי מושג לגבי גינון. לכן אני לא אחראי למה שאומר בבלוג הדוגמה.