מהו דפי GitHub?

הושלמה

כאן, אנו דנים בתהליך היצירה והתחזוקה של אתר אינטרנט של דפי GitHub.

דפי GitHub הם אתרים סטטיים המתארחים ישירות מתוך מאגר GitHub, אך הם יותר מאוסף של קבצים סטטיים בלבד. על-ידי שימוש בטכנולוגיות ליצירת אתרים כגון Jekyll ו- Liquid, המפתחים מגדירים תבניות דינאמיות המעובדות לאתרי אינטרנט סטטיים. בכל פעם שאתה מבצע שינוי בענף המקור המשויך לאתר, האתר נוצר מחדש באמצעות העדכונים האחרונים ומתפרסם באופן אוטומטי בכתובת ה- URL של היעד.

קבל מידע נוסף מקורות פרסום עבור אתרי דפי GitHub.

הפעלת דפי GitHub

השלב הראשון בשימוש בדפים של GitHub הוא להפוך אותו לזמין מהכרטיסיה 'הגדרות ' שלך. באפשרותך לבחור להשתמש בענף main, או לציין את docs התיקיה בתוכה. אם תרצה להפוך דפי GitHub ללא זמינים, תוכל לעשות זאת כאן.

בחירת ערכת נושא עם Jekyll

ג'קיל הוא מחולל האתרים הסטטי ש- GitHub משתמש בו כדי לבנות את אתר האינטרנט שלך מתוך התוכן של המאגר שלך. בנוסף לאספקת נוחות תוכן נהדרת, היא תואמת גם למוסכמות עיצוב סטנדרטיות. תתקניזציה זו של סגנון מאפשרת עבור ערכות נושא ניתנות להחלפה, שניתן לבחור מתוך GitHub או התצורה.

GitHub מספק ערכות נושא שונות. ישנו גם מערך של ערכות נושא מסחריות וערכות נושא של קוד פתוח הזמינות בקהילת ג'קיל.

קבל מידע נוסף על ערכות נושא של Jekyll.

שימוש בחומר הקדמי של YAML

המונח החזיתי מטה-נתונים של YAML שמכינים מראש את התוכן של קובץ. עבור Jekyll, מטה-נתונים אלה כוללים הוראות מחולל המציינים את סגנון הפריסה של דף Markdown (post, pageוכן הלאה). הוא עשוי לכלול גם מטה-נתונים של דף, כגון כותרת המסמך או משתני תוכן דף, כגון מחבר של רשומת בלוג.

הדוגמה הבאה משתמשת בפריסת post הקודמת. הדוגמה מניחה שקיים קובץ _layouts/post.html המגדיר את ה- HTML של הגורם המכיל. ניתן לציע אפשרויות פריסה אחרות על-ידי הוספת קבצי ה- HTML המתאימים _layouts התיקיה.

---
layout: post
title: This is set as the document title.
---

This is visible body content, which might use Markdown, HTML, and Liquid templating.

קבל מידע נוסף חזיתי.

התאמה אישית של האתר שלך

לאחר שהאתר שלך פועל ופועלים, באפשרותך להתאים אישית את הפרטים אודות האתר שלך באמצעות _config.yml. קובץ זה כולל כמעט את כל אפשרויות התצורה ברחבי האתר, כולל מטה-נתונים של אתר, תפריטי ניווט, צבעי ערכת נושא, אפשרויות מהדר ועוד.

קבל מידע נוסף על _config.yml תצורת.

יצירה ועריכה של תוכן

יצירה ועריכה של דפים באתר שלך פועלים בהתאם לחוויה הסטנדרטית של GitHub. הקבצים שבהם אתה משתמש עבור אתר האינטרנט של דפי GitHub נהנים מכל היתרונות של קבצים אחרים במאגר GitHub. באפשרותך לערוך אותם באמצעות כל הכלים, ליצור ולמזג הסתעפויות, ולקשר לבעיות או לבקשות משיכה.

בנוסף ל- Markdown ול- HTML, Jekyll תומך בתחביר Liquid תבנית זו. Liquid מאפשר למשתמשים להוסיף באופן דינאמי משתנים ומבנות זרימת לוגיקה בסיסיות לתוך קבצי התוכן שלהם. לאחר ההידור, המוצר הסופי הוא HTML סטנדרטי.

הדוגמה הבאה מציגה שילוב של לולאה for והוספה משתנה.

<ul>
  {% for post in site.posts %}
    <li>
      <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
      {{ post.excerpt }}
    </li>
  {% endfor %}
</ul>

קבל מידע נוסף שפת התבנית של Liquid.

עבודה עם רשומות בלוג

למרות שלא היה מסד נתונים לעבוד איתו, ג'קיל עדיין תומך ברעיון של כתיבת בלוג באמצעות מוסכמה ספציפית: _posts/2020-06-25-blog-post-name.md. כפי שניתן להסיק, כל רשומות הבלוג מאוחסנות בתיקיה '_posts' ולהשתמש במוסכמות התאריך והשימוש בשם, כפי שמוצג. במהלך ההידור, Jekyll מעבד את הקבצים בתיקיה זו כדי להפיק רשימה של רשומות בלוג HTML.

הדוגמה הבאה מדגימה את המבנה של רשומת בלוג פשוטה. הוא כולל מטה-נתונים עבור subtitle, tagsו- comments. ייתכן שערכת הנושא שתבחר לא תתמוך במטה-נתונים אלה.

---
layout: post
title: Blog post title rendered by theme
subtitle: Blog post subtitle rendered by theme
tags: welcoming
comments: true
---

This is the first line of rendered content in the post.

קבל מידע נוסף הוספת תוכן לאתר דפי GitHub באמצעות Jekyll.