המיני Web App (סקירה)
מה נותן?
צפייה ועריכה – תצוגת קוד עם הדגשת תחביר, עריכה עם CodeMirror
הרצת קוד (Playground) – הרצת Python דרך API עם מגבלות ואבטחה (הרצת קוד (Code Execution Playground))
ספריית סניפטים – גלריית קטעי קוד קצרים עם חיפוש, סינון וקרדיט מחבר (ספריית סניפטים (Web))
תצוגת Markdown מתקדמת – GFM, Mermaid, KaTeX, Task Lists אינטראקטיביות
ארגון מתקדם: - סימניות (Bookmarks) – סימון נקודות חשובות בקוד - אוספים (Collections) – ארגון קבצים לפי נושאים - פתקים דביקים (Sticky Notes) – הערות ויזואליות על הקוד - מועדפים (Favorites)
פעולות מרובות – בחירה מרובה וביצוע פעולות על מספר קבצים
שיתוף – קישור ציבורי לשיתופים פנימיים (זמני או קבוע)
עמודי סטטוס – מעקב זמינות ותקינות
דשבורד חדש
פיד אחרון – מקבץ את כל הפעילות האחרונה (קבצים, גיבויים, תזכורות), עם אפשרות הרחבה במובייל ובדסקטופ.
הגדרות פוש – מצב המנויים, תזכורות ממתינות, והיסטוריית השליחה האחרונה/הבאה. כל פתק מוצג בשם שלו, ובלי שם — בשורה הראשונה שלו (השם של פתק בשורה אחת: פונקציה אחת לפוש, לפעמון ולדשבורד).
פתקים אחרונים – הפתקים שעודכנו לאחרונה. לכל פתק השם שלו, שהוא גם קישור לפתק, ואיפה הוא יושב — לוח, קובץ או קובץ בריפו. פתקים מהארכיון אינם מופיעים בו (”פתקים אחרונים“ בדשבורד).
כל הכרטיסיות חולקות Layout רספונסיבי: במובייל מוצגת עמודה אחת, ובדסקטופ שני טורים (היסטוריה + כרטיסי מצב).
אייקוני שפה אחידים
כל קובץ בדשבורד מקבל שדה
languageשמחושב בצד השרת: קודם נלקחת השפה שנשמרה במסד הנתונים; אם היא ריקה משתמשים בזיהוי לפי שם הקובץ (resolve_file_language).קבצי
.envוכל וריאציה שמתחילה ב-.env(למשל.env.local) מסומנים תמיד כ-env.האייקונים זהים בכל הרכיבים – פיד אחרון, כרטיס ”קבצים אחרונים“, ספריית קבצים ותצוגת קובץ בודד. כך אין הבדל בין כרטיסיית הדשבורד לרשימות אחרות.
fallback: אם לא מזוהה שפה משויכת, הקובץ מקבל את אייקון ה-
textיחד עם הטקסט ”text“.
מאוגוסט 2026 האייקונים אינם אמוג’ים אלא 28 אייקונים מצוירים (SVG) בסגנון אחיד, שנשלפים מספרייט אחד. המבנה המלא, הגדלים, אופן ההוספה והמלכודות מתועדים בנפרד: אייקוני שפות התכנות.
הנחיות לסוכני AI
הנתונים ב-API (למשל
/dashboardאו/files) כוללים את אותו שדהlanguageוהאייקון לא דורש חישוב נוסף.אל תסתמכו על האייקון או על האמוג’י כדי לזהות שפה – הסתמכו על השדה הטקסטואלי
languageאוprogramming_languageכדי להחליט על פעולה.שדה
iconבתגובות ה-JSON עדיין מחזיר אמוג’י, לתאימות לאחור. הוא אינו מה שמוצג למשתמש ברשימות הקבצים.
כתובת והרשאות
כתובת הבסיס:
WEBAPP_URL, דרךwebapp_url.py— הקורא היחיד שלו, בלי ברירת מחדל. ראו את השורה שלו ב-משתני סביבה - רפרנס.הרשאות בסיסיות לקריאה; אין חשיפה של נתונים רגישים.
הגדרות ENV
WEBAPP_URL– נדרש לכל קישור מלא ל-WebApp, כולל קישורי שיתוף. בתוך בקשה ל-WebApp, בלעדיו, הקישורים נבנים מהכתובת שהבקשה הגיעה אליה.לאחר merge, האתר מתעדכן אוטומטית ב-Read the Docs (בהתאם לקונפיגורציה).
קישורים ותמונות מסך
דפי שיתוף:
/share/<share_id>.בעת קריאה ל-
POST /api/share/<file_id>ניתן לציין{"type": "permanent"}כדי לקבל קישור קבוע, או להשאיר ברירת מחדל לקישור זמני, שתוקפוPUBLIC_SHARE_TTL_DAYSימים (משתני סביבה - רפרנס). מודאל השיתוף מציג את המשך הזה ליד הכפתור ”קישור זמני“.השיתוף שומר את התוכן המלא של הגרסה ששותפה, והעמוד הציבורי מציג את כולה. זה צילום של הרגע: עריכה או מחיקה של הקובץ אחר כך אינן משנות את הקישור. שיתוף שנוצר בבוט (“📱 קישור פנימי“) נשמר באותה צורה, ונקרא באותו מסלול.
בעמוד השיתוף, בתצוגת הקוד, יש רק פעולות שיש להן נתיב ציבורי: ”העתק קוד“, ”הורד“ (
/share/<share_id>/download, שפתוח לכל שיתוף שיש בו תוכן), ובקובץ Markdown גם ”תצוגת Markdown“ (/share/<share_id>?view=md) ו“📖 מצב קריאה“ (/read/share/<share_id>). העמוד מרנדר את התבנית של עמוד הקובץ של הבעלים,view_file.html, עםis_public, כיfile.idבעמוד הזה הוא מזהה השיתוף ולא מזהה קובץ. כפתור חדש בסרגל של עמוד הקובץ צריך להחליט לאיזה צד הוא שייך:tests/test_public_share_page_actions.pyנופל על פעולה שלא הוחלט עליה.מומלץ לצרף צילומי מסך של תצוגת קובץ ושיתוף.
ראו גם
באנר הכרזות בראש המסך
ה‑WebApp כולל באנר הכרזות קצר בראש העמוד (מחליף את ”טיפ שבועי“ הישן). מעתה ניהול ההכרזות נעשה דרך ממשק אדמין ו‑API, ללא צורך בהזרקות ידניות.
איך מפעילים?
ודאו שהדגל
WEEKLY_TIP_ENABLEDנשארtrue– זהו המתג הכללי של הרכיב.היכנסו ל‑
/admin/announcementsוצרו/ערכו הכרזה. סימון ”הפעל“ יכבה אוטומטית כל הכרזה פעילה אחרת (תמיד תהיה לכל היותר אחת פעילה).בצד הלקוח, התבנית
base.htmlמבצעתfetchל‑GET /api/v1/announcements/active; אם קיימת הכרזה פעילה היא מוזרקת אוטומטית אלwindow.__announcementsומוצגת.
הערות וקישורים
linkבהכרזה הוא אופציונלי. קישורים פנימיים יתחילו ב‑/; קישורים חיצוניים חייבים להיותhttps://(http://נחסם מטעמי אבטחה).ניתן עדיין לבצע הזרקה ידנית ל‑HTML לצורך בדיקות/פיתוח, אך זה אינו נדרש עוד בתצורה רגילה.
מה קורה מאחורי הקלעים?
אם אין הכרזה פעילה – לא מוצג באנר כלל (
display:none).כאשר קיימת הכרזה, מוצגת הראשונה בלבד. כאשר יש
link– הרכיב מקבלrole="link"ותומך לחיצה/Enter/Space; אחרת מוצג כ‑role="status".ההנפשה מבוססת מרקיזה אנכית; ריחוף עוצר את הגלילה לנגישות טובה יותר.
כיבוי זמני
ניתן לכבות גלובלית באמצעות
WEEKLY_TIP_ENABLED=false.משתמש יכול להשבית מקומית (ללא UI מובנה) עם
localStorage.setItem('announcementBannerOff', '1').
המלצות לתוכן
הודעות קצרות וברורות בעברית, עם קריאה לפעולה.
מומלץ לספק יעד פנימי ב‑
linkעם פרטים מלאים (בלוג/צ’יינג’לוג).