אחד הקשיים שחוויתי כאשר נסה לעבור מווורפרס לג'קיל ואני חייב להבין לשם מה נועד כל רכיב וכיצד הם התקשרו זה עם זה. מצאתי את הפתרון כשהפסקתי לנסות ליצור את הבלוג שלי מאפס והתחלתי להנדס לאחור נושא פותח על ידי מישהו אחר. היתרונות של קוד פתוח.
כדי להתחיל, בהנחה שהתקנת את הדרישות המקדימות שהתארנו במאמרים הקודמים, אנו הולכים לבנות את האתר שלנו. הדוגמא היא בלוג גינון.
jekyll new blog_de_jardineria
אם תעבור לתיקיה תראה את הדברים הבאים:
- תיקיה בשם _מוצבים.
- שני קבצים עם סיומת סימון
- דף אינטרנט.
- קובץ תצורה עם סיומת .yml שנדון בהרחבה במאמר הבא.
- קובץ Gemfile המפרט את רכיבי האתר ועוד אחד באותו שם אך עם סיומת .lock המונעת שינויים בשוגג.
מבנה הפרויקט
כמו כל אתר מבוסס וורדפרס, ג'קיל יוצר גם מבנה תיקיות שבו הוא מאחסן את כל הקבצים, והוא עושה זאת מאותן סיבות. אפשר למשתמש לקבץ קבצים בצורה מסודרת וככל שהפרויקט יגדל, יישאר לניהול.
אנו יוצרים את תיקיית הבסיס עם הפקודה jekyll new.
בתוכו אנו מוצאים שני סוגים של תיקיות; אלה שקשורים לתצורת הבלוג ומזוהים עם מקף לפני השם (במקרה שלנו התיקיה _post וכאלה שיש להם משאבים שלא ייכללו כחלק מתהליך היצירה. למשל מכילים תמונות.
תיקיות מבוססות תוכן
בקבוצה זוe מאחסן תוכן המיועד למבקרים באתר
_ הודעה
התיקיה _הודעה מכיל את כל רשומות הבלוג. כאן נעשה שימוש בפורמט ספציפי מאוד עבור כל אחד מהקבצים השמורים בו. שם הקובץ חייב להיות בתבנית שם קובץ תאריך - year-month-date-full_filename.md - ותאריך פרסום זה יוצג כתאריך בו בוצעה פוסט הבלוג של Jekyll. עלינו לזכור שלמרות שהתיקיה נקראת _ פוסטים, הנה כל התוכן שקוראי הבלוג יראו, למשל טופס יצירת הקשר או הביוגרפיות של המחברים. בהמשך נראה שאפשר להקצות עמודים שונים לדפים.
_דַמקָה
זה שווה ערך לשמירת טיוטת וורדפרס. השימוש המומלץ בו הוא לפוסטים שאינם מוכנים לפרסום אם כי באמצעותם ניתן לאחסן רשימות רעיונות, עיצובים לשימוש מאוחר יותר וכו '.
_ כולל
במרחב זה אנו יכולים לאחסן קוד HTML שניתן לעשות בו שימוש חוזר מספר פעמים. לדוגמא, במקרה שלנו כרזה המברכת את תחילת העונה בהתאם לחצי הכדור בו נמצא המשתמש.
_ פריסות
כפי שאמרנו לעיל, חלקים שונים של התוכן עשויים להזדקק לפריסות שונות. לדוגמא, כדי להציג סרטון אנו עשויים שנרצה שהעמוד יהיה טור בודד, ואילו אם הוא מחבר אורח נצטרך טור כדי להציג את הביוגרפיה שלהם ואת פרטי הקשר. העיצובים השונים בהם ישתמש האתר מאוחסנים בתיקיה זו.
תיקיות מידע
שתי התיקיות האלה משמשים את האתר להפעלתו.
_ נתונים
בבלוג של איש אחד, קובץ התצורה יכול לאחסן את כל הנתונים הדרושים. אבל אם יש לנו בלוג עם מחברים רבים, יש צורך בדרך אחרת לנהל את המידע. התיקיה _ נתונים הוא משמש לאחסון נתונים בפורמטים JSON או CSV שהאתר יכול לאחזר בהתאם לאינטראקציה עם המשתמשים.
_אם אתה
התיקיה _אם אתה האתר משלים אותו עם כל המידע הקיים בתיקיות הקודמות. כאן נמצא את האתר אותו נעלה לשרת כדי שמשתמשים יוכלו לגשת אליו. כמובן, מכיוון שמדובר בקוד html ו- css, ניתן לבצע בו שינויים כמו כל אתר אחר.
במאמר הבא נתחיל לשנות את קובץ התצורה.