כל דף בוויקי הוא קובץ .md רגיל בריפו. התוכן נכתב במארקדאון, וההצגה נקבעת ברכיבי HTML קצרים עם שמות class ברורים. שמירה לענף main ב-GitHub מפעילה בנייה ב-Cloudflare Pages; כשהבנייה מסתיימת בהצלחה, השינוי עולה לאתר.
כותרת הדף (Front matter)
בראש כל קובץ, בין שני קווים של ---:
---
title: יכולות
order: 2
icon: spark
subtitle: משפט משנה קצר
---
- title - שם הדף: מופיע בכותרת הגדולה ובתפריט העליון.
- order - מיקום בתפריט (1 = בית). דף חדש עם order משתלב אוטומטית.
- icon - אייקון ליד הכותרת:
home,spark,plug,shield,scale,chat,rocket,edit. - subtitle - משפט משנה מתחת לכותרת (אופציונלי).
טקסט ורשימות
מארקדאון רגיל: ## כותרת משנה, - תבליט, 1. רשימה ממוספרת, | טבלה, ** הדגשה. כותרת עם עוגן ישיר: <h2 id="about" class="reveal">כותרת</h2>.
אפקטים והצגה - הרכיבים
עוטפים קטע ב-div עם class, וזה כל הסיפור:
| רכיב | מה הוא עושה |
|---|---|
class="reveal" |
הקטע נכנס בעדינות בגלילה |
class="lead" |
פסקת פתיחה גדולה |
class="cards" |
רשימת <li> שהופכת לכרטיסים מרחפים |
class="note" |
תיבת הערה שקטה |
class="warn" |
תיבת אזהרה |
class="tablewrap" |
טבלה עם גלילה נוחה במובייל |
class="demo-chat" |
המחשת שיחה מונפשת (ראו למטה) |
class="demo-approval" |
כרטיס אישור תשלום להמחשה |
class="timeline" |
ציר זמן שנצייר בגלילה |
המחשות אינטראקטיביות
הדמיון בין הרכיב לתוצאה אחד לאחד - מה שכתוב זה מה שמוצג:
<div class="demo-chat">
<div class="chat-flow">
<div class="msg user">תזכיר לי להתקשר לאמא</div>
<div class="msg bot">נרשם ✅</div>
</div>
</div>
msg user- בועה שלי (ירוקה),msg bot- בועה של העוזר.- ההקלדה, הניגון החוזר והכניסות מתווספות לבד על ידי קובץ ה-JS של האתר.
- כדי להוסיף דף: יוצרים קובץ
.mdחדש עם front matter, והוא מצטרף לתפריט לבד.
איפה הכל חי
- התבנית המשותפת:
_layouts/default.html. - העיצוב והאנימציות:
assets/css/wiki.css. - האינטראקציה:
assets/js/wiki.js. - שמירה לענף
mainמפעילה בנייה ועדכון אוטומטיים ב-Cloudflare Pages. השינוי מופיע אחרי בנייה מוצלחת. - קוד המקור נשמר בריפו פרטי. האתר עצמו פתוח לכל מי שיש לו את הכתובת.
בדיקה מקומית לפני פרסום
עם Ruby ו-Bundler מותקנים, מריצים מתיקיית הריפו:
bundle install
bundle exec jekyll serve
פותחים את הכתובת שהתוכנה מציגה, עם הנתיב /instinct-guide/. זו תצוגה מקומית, לא פרסום לאינטרנט.