המיני 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, ללא צורך בהזרקות ידניות.

איך מפעילים?

  1. ודאו שהדגל WEEKLY_TIP_ENABLED נשאר true – זהו המתג הכללי של הרכיב.

  2. היכנסו ל‑/admin/announcements וצרו/ערכו הכרזה. סימון ”הפעל“ יכבה אוטומטית כל הכרזה פעילה אחרת (תמיד תהיה לכל היותר אחת פעילה).

  3. בצד הלקוח, התבנית 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 עם פרטים מלאים (בלוג/צ’יינג’לוג).