איך כותבים בוויקי הזה

שפת הוויקי - איך הקובץ מגדיר גם תוכן וגם הצגה.

כל דף בוויקי הוא קובץ .md רגיל בריפו. התוכן נכתב במארקדאון, וההצגה נקבעת ברכיבי HTML קצרים עם שמות class ברורים. שמירה לענף main ב-GitHub מפעילה בנייה ב-Cloudflare Pages; כשהבנייה מסתיימת בהצלחה, השינוי עולה לאתר.

כותרת הדף (Front matter)

בראש כל קובץ, בין שני קווים של ---:

---
title: יכולות
order: 2
icon: spark
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>

איפה הכל חי

בדיקה מקומית לפני פרסום

עם Ruby ו-Bundler מותקנים, מריצים מתיקיית הריפו:

bundle install
bundle exec jekyll serve

פותחים את הכתובת שהתוכנה מציגה, עם הנתיב /instinct-guide/. זו תצוגה מקומית, לא פרסום לאינטרנט.