פתקים דביקים (Sticky Notes)

מהם פתקים דביקים?

פתקים דביקים מאפשרים להצמיד הערות קצרות ומודגשות על‑גבי תצוגת קובץ (קוד/Markdown/HTML), כך שאפשר לסמן נקודות חשובות, משימות או תזכורות ישירות במקום הרלוונטי בתוכן. הפתק ”ננעל“ לעוגן יציב כאשר ניתן (כותרת ב‑Markdown או id ב‑HTML) או לחלופין למיקום קואורדינטות/שורה בקוד.

איך מוסיפים ומנהלים פתקים

פעולה

איך עושים

הערות

הוספת פתק

לחיצה על כפתור הפתקים בתצוגת הקובץ ואז לחיצה בנקודה הרצויה

מומלץ להצמיד לעוגנים יציבים (כותרת/id) כשאפשר, לשמירה לאחר עריכות

עריכת תוכן/צבע

קליק על פתק קיים ועריכת השדה/בחירת צבע מהתפריט

צבעים עוזרים לסיווג מהיר (למשל ירוק=בוצע, אדום=דחוף)

הזזה/מיקום מחדש

גרירה קצרה של הפתק למיקום חדש בתצוגה

אם הפתק מעוגן לעוגן יציב – ההצמדה תישמר, והמיקום החזותי יעדכן

מחיקה

בחירה ב“מחק“ בתפריט הפתק

המחיקה מיידית ובלתי הפיכה

עיגון יציב לעומת מיקום קבוע

  • עיגון יציב: אם יש כותרת Markdown או אלמנט HTML עם id – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות.

  • מיקום קבוע: בקבצי קוד, כאשר אין עוגן יציב, הפתק נשמר לפי שורה/קואורדינטות; שינויי טקסט גדולים עלולים לשנות את המיקום היחסי.

שילוב עם סימניות

פתקים דביקים משלימים את הסימניות:

  • הסימניות מתאימות לניווט מהיר לנקודות חשובות בקובץ.

  • הפתקים מתאימים להוספת טקסט חופשי/הנחיות/תזכורות ויזואליות על התוכן עצמו.

מגבלות, פרטיות ואבטחה

  • מגבלות שימוש: עד 200 פתקים לקובץ ועד 1000 פתקים לכל משתמש.

  • פרטיות: פתקים נשמרים לחשבון המשתמש בלבד, ואינם מוצגים לאחרים כברירת מחדל.

  • אבטחה: - אין הרצת JavaScript מקוד פתקים. - בקבצי HTML, התצוגה נעשית בתוך sandbox לצורך בידוד.

טיפים שימושיים

  • העדיפו עוגנים יציבים כדי לשמר דיוק גם לאחר עריכות.

  • הגדירו קוד צבעים עקבי כדי לזהות משימות/סטטוסים במבט אחד.

  • נצלו פתקים לביקורת קוד עצמית ולמעקב משימות נקודתי בתוך קבצים גדולים.

API קצר (למפתחים)

ה‑API עשוי לכלול פעולות כגון יצירה/עדכון/מחיקה/שליפה של פתקים לפי מזהי קובץ ועוגן/מיקום. המימוש עשוי להשתנות בין גרסאות; ראו את עמוד ה‑API הרלוונטי אם פורסם, או עיינו בקוד webapp/sticky_notes_api.py לצרכי רפרנס.

התראות ותזכורות (Reminders)

המערכת כוללת תזכורות לפתקי Sticky והודעת מצב קבועה (Persistent UI):

  • בועת התראה עם מונה: כאשר יש פתקים ממתינים, תופיע בועה כתומה בולטת עם מונה. - מיקום: במובייל מעל כפתור תפריט ההמבורגר; בדסקטופ/טאבלט מעל קישור ההגדרות.

  • לחיצה על הבועה פותחת Pop‑up ולא מנווטת מיד. ה‑Pop‑up מציג שורה קצרה (עד 6 מילים) מכל פתק ממתין. - לחיצה על פריט ברשימה תוביל ישירות ל‑anchor של הפתק בתוך תצוגת ה‑Markdown המרונדרת (/md/<file_id>). - כפתורים: סגור (סוגר ומבטל את הבועה כעת), דחה לאחר"כ (סוגר את החלונית ומשאיר את הבועה גלויה).

  • קביעת תזכורת לפתק: בתוך פתק, לחצו על האייקון 🔔 כדי לפתוח חלון תזמון הכולל קיצורי זמן (עוד שעה/3 שעות/היום 21:00/מחר 9:00/24 שעות/שבוע) או בחירה ידנית datetime-local.

הערה

קיצורי הפקודות בסגנון /remind (למשל /remind 1, /remind 21:00) עדיין לא נתמכים בגרסה זו, והם יתווספו בהמשך. בינתיים השתמשו בחלון התזכורת (🔔) לקביעת זמן.

איורים

בועת התראה עם מונה מעל הגדרות/תפריט

בועה משודרגת עם מונה (דסקטופ)

חלון Pop-up לתזכורות עם רשימת פתקים וכפתורי פעולה

Pop‑up בלחיצה על הבועה: רשימת פתקים וכפתורי ”סגור“/“דחה לאחר“כ“

ניווט לעוגן פתק בתצוגת Markdown

ניווט לעוגן בתצוגת ה‑Markdown המרונדרת (‏/md/<file_id>)

Troubleshooting קצר

  • פתק ”זז“ לאחר עריכות גדולות בקוד: העדיפו להצמיד לעוגן יציב במקום לשורה גולמית.

  • פתק לא נשמר: ודאו שיש הרשאות וששמורו בוצע בהצלחה (הודעת אישור בתצוגה).

  • בעיות בתצוגת HTML: ודאו שפתקים מוצגים במסגרת ה‑sandbox ולא נחסמים על‑ידי הדפדפן.

בעיות נפוצות בתזכורות

  • איני רואה את הבועה: ודאו שקיימות תזכורות שעבר זמנן (ה‑UI מציג רק פריטים שמועד התזכורת שלהם הגיע). נסו לרענן את הדף.

  • לחיצה על פריט ב‑Pop‑up הובילה לתצוגת קוד: ודאו שאתם ניגשים ל‑/md/<file_id> (תצוגת Markdown). המערכת אמורה לנתב לשם אוטומטית.