תוסף מרקר לאוצריא

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

• מדריך משתמש מלא
• ארכיטקטורה ודיבוג
• תאימות אוצריא
• מדריך תרומה ו־PR
• הוראות לסוכני AI
• עמוד התוסף בחנות אוצריא

מה חדש בגרסה 0.9.6

הגרסה הזאת מתקנת את הדבר שהכי הפריע: ההדגשות מופיעות בספרים תמיד, גם כשלשונית המרקר סגורה.

• מנוע רקע. עד עכשיו אוצריא ציירה את ההדגשות רק כל עוד לשונית התוסף הייתה פתוחה, ולחיצה על צבע כשהתוסף היה סגור פתחה את לשונית התוסף במקום לסמן בספר. מגרסה זו מרקר מחזיק מנוע קטן ברקע שעושה את שתי העבודות האלה בשקט. הוא דורש שתי הרשאות חדשות — „טעינה אוטומטית ברקע” ו**„מניעת כיבוי מנוע הרקע”** — ושתיהן מתחילות כבויות; עד שתאשרו אותן התוסף יתנהג כמו קודם ויסביר לכם בדיוק מה חסר.
• הטקסט שנשמר הוא בדיוק מה שסימנתם. באג קודם שמר לפעמים קטע שמתחיל כמה אותיות מוקדם יותר.
• שם ה׳ מסונן. הרשימה, ההדפסה והייצוא מציגים את הטקסט כפי שהספר מציג אותו, ואפשר גם לבקש החלפה תמידית בהגדרות.
• סמל המרקר בשורת הפקדים מסתיר ומציג את ההדגשות בספר הפתוח במקום לפתוח את התוסף, ואפשר להוריד אותו מהשורה לגמרי. גם Ctrl+Alt+J עושה את זה.
• „נקה סימון” מופיע בתפריט רק כשיש מה למחוק.
• מסך „אודות” מסביר מה התוסף עושה ולמי הוא מיועד, וכל כפתור מופיע רק אם ההרשאה שלו מאושרת. קיצור הדרך וההוספה לתפריט ההתחל עברו לאזור „הפעלה וכיבוי” משלהם.
• התוסף כבר לא „מפסיק להגיב” אחרי כמה דקות. אוצריא מגבילה כמה פניות תוסף רשאי לשלוח אליה ברצף, ומרקר חצה את התקרה הזאת בכל עלייה אצל כל מי שיש לו יותר מכמה עשרות סימונים. מאותו רגע חלק מהפניות נדחו בשקט: הסימון לא נוצר, המחיקה לא בוצעה, וגם הודעת השגיאה עצמה נדחתה — ולכן לא הופיעה. מעכשיו מרקר מווסת את עצמו, ושום סימון אינו נעלם מהרשימה בגלל קריאה שנכשלה.
• הודעות ההרשאות נכתבו מחדש בעברית פשוטה: מה לא עובד, למה, ואיפה מדליקים.
• קובצי הגופן ירדו מהחבילה ונטענים מאוצריא בזמן ריצה.

מה נכנס בגרסה 0.9.5

התוסף נכתב מחדש לאוצריא 0.9.97.

בסימון עצמו

• התפריט עובד מיד עם עליית אוצריא, גם אם התוסף מעולם לא נפתח. פריטי התפריט מוצהרים במניפסט ואוצריא רושמת אותם בלי להריץ קוד.
• הסרת סימון ועריכת הערה בלחיצה ימנית על ההדגשה עצמה — תת-תפריט בהקשר reader-highlight, בלי צורך לסמן מחדש את הטקסט.
• סימון מדויק של בחירה שחוצה פסקאות, על בסיס העוגנים שאוצריא מספקת (selection.sections) במקום ניחוש מקומי.
• פלטה של עד 12 צבעים, מהם עד 8 בתפריט הלחיצה הימנית, ולצדם מחק.
• קיצורי מקלדת ופקד בשורת הפקדים של מסך העיון.

בעריכה ובניהול

• עורך הערות עשיר, בשפת העורך של אוצריא: הדגשה, נטוי, קו תחתי, קו חוצה, סימון, הגדלה והקטנה של הכתב, כותרת, רשימה, רשימה ממוספרת, ציטוט וקישור. Ctrl+Enter שומר. ההערה מוצגת מעוצבת גם בכרטיס ובייצוא ל-HTML.
• פס סינון מהיר עם מונים: הכול, בספר הפתוח, מועדפות, עם הערה, עם תגית, דורשות תיקון, ופר-צבע. לחיצה על מונה מסננת.
• העתקה של הדגשה עם מראה המקום וההערה, בלחיצה אחת.
• הדפסה וייצוא ל-PDF של ההדגשות המסוננות, בעימוד A4.
• ניווט מקלדת ברשימה, ומיון וקיבוץ שנשמרים בין הפעלות.
• הגנה מפני איבוד טיוטה: סגירה בזמן שההערה לא נשמרה — שואלת קודם.

מסביב

• ממשק באנגלית לצד העברית, כולל שמות הפריטים בתפריט ההקשר. נגזר משפת אוצריא או נבחר ידנית בהגדרות התוסף.
• שליחת דיווח למפתח ישירות מהתוסף, דרך מנגנון הדיווח של אוצריא.
• גיבוי אוטומטי במרחב הפרטי של התוסף — בלי הרשאה, בלי בחירת תיקייה, עם שחזור בלחיצה.
• פחות הרשאות: שבע הרשאות הוסרו, כולל מעקב אחרי כל שינוי בחירה וכל ניווט.
• הקוד פוצל למנוע headless ולשכבת UI, ונוספה חבילת בדיקות שאוכפת גם את חוזה ה-payload של אוצריא.

תאימות

• אוצריא 0.9.97 ומעלה; נבדק גם על 0.9.98.
• minAppVersion במניפסט: 0.9.97 — הגרסה שבה נוסף ה-API החדש ביותר שבשימוש.
• פירוט מלא: docs/COMPATIBILITY.md.

התקנה

1. פותחים את עמוד התוסף בחנות או את חנות התוספים מתוך אוצריא.
2. מתקינים ומאשרים את ההרשאות המבוקשות.
3. זהו. תפריט הצבעים בלחיצה ימנית עובד מיד, גם בלי לפתוח את התוסף — הוא נרשם מהמניפסט בעליית אוצריא.

מבנה

manifest.json          זהות, הרשאות ותרומות עלייה דקלרטיביות
index.html             דף התוסף — הרשימה, העריכה וההגדרות
background.html        מנוע הרקע — דף בלי UI, כדי שההדגשות יופיעו תמיד
css/style.css          ערכת הממשק, על תפקידי הצבע של אוצריא בלבד
i18n/en.js             קטלוג התרגום לאנגלית
js/marker-domain.js    כללי דומיין טהורים, כולל מדיניות הסינון של ההערות
js/marker-i18n.js      שכבת התרגום
js/marker-runtime.js   הגבול היחיד מול ה-SDK
js/marker-richtext.js  עורך ההערות וה-sanitizer (נטען בדף בלבד)
js/marker-core.js      המנוע: הגדרות, הדגשות, תפריט, גיבוי, דיווח
js/marker-ui.js        הדף בלבד
js/marker-background.js  שורה אחת: הפעלת המנוע ב-background.html
test/                  בדיקות Node, ללא DOM וללא תלויות

בדיקות מקומיות

מתיקיית התוסף (אין npm install — לתוסף אין תלויות ואין שלב build):

for f in js/*.js i18n/*.js; do node --check "$f"; done
node --test "test/*.test.js"
git diff --check

הבדיקות אינן מריצות DOM ואינן מחליפות הרצה בתוך אוצריא. רשימת הבדיקות הידניות נמצאת ב-CONTRIBUTING.md.

דיבוג

לוגים מתחילים ב-[marker] עם שם השכבה: [marker][core], [marker][ui], [marker][sdk], [marker][events]. שגיאת SDK היא MarkerSdkError ונושאת method, code, category, retryable ו-isUnsupported. טבלת תסמינים נמצאת ב-docs/ARCHITECTURE.md.