חיפוש טבלאי — תוסף לאוצריא
מפתח: יהל
גרסה 1.4.8 — בטא
התאמה לשפת העיצוב של אוצריא: רקע הדף לפי רקע הנושא (כותרת בתפקיד surfaceContainerHigh, כמו הלשונית הפעילה), פינות ברדיוס 8 במקום גלולות, ללא צללים, שורת כותרת קבועה בגלילה, רקע הדף בהיר מעט מהכותרת, ללא מסגרת סביב מאפייני החיפוש, וצבעים רק מתפקידי Material 3 של הנושא.
עיצוב מחודש: פלטת זהב־קרם בהשראת שאר תוספי אוצריא, מרווחים בין העמודות עצמן, מאפיינים כגלולות סימון,
תצוגה מקדימה של השאילתה כתגיות, שורת חיפוש דבוקה לתחתית, פס התקדמות ותוצאות מעוצבות.

ממלאים מילה אחת בכל עמודה. שלושת שדות „או” מוסיפים חלופות לאותה
עמודה. נדרשת התאמה מכל עמודה מלאה, לפי סדר העמודות מימין לשמאל.
אפשר להשאיר את העמודות האחרונות ריקות; אין להשאיר עמודה ריקה באמצע.

בלחצן „סינון מאגרים” שבראש הדף (ליד מצב החיבור) נפתחת חלונית שבה בוחרים „כל הספרייה” או „רק מאגרים נבחרים”.
רשימת המאגרים ותתי־המאגרים נטענת מהספרייה שלכם. אפשר לאתר מאגר
לפי שמו, לפתוח תתי־מאגרים באמצעות + ולסמן כמה מאגרים יחד. בחירת
מאגר כוללת את כל צאצאיו; לצמצום הבחירה מבטלים את האב ומסמנים
את תתי־המאגרים הרצויים. אין אפשרות לחפש בבחירה ריקה.
הכפתור ״חז״ל וכל הראשונים״ מחליף את הבחירה במקורות חז״ל ובכל ענפי
״ראשונים״ לפי סיווג הספרייה. ספרי המקור במדרשים שבהם יש גם
תתי־תיקיות של פירושים נבחרים לפי ספר, בלי לצרף את תיקיות הפירושים.
אפשר לפתוח את רשימת ספרי המדרש ולבטל את צירופם, ולשנות כל סימון.
החלוקה ל״ראשונים״ נשענת על סיווג אוצריא וכוללת את צאצאי הענפים.
בחירת המאגרים נשמרת אוטומטית לפתיחה הבאה. ״ניקוי הכול״ מנקה את
תנאי החיפוש ומשאיר את בחירת המאגרים. לא נשמרות מילות החיפוש.
הסינון נשלח למנוע לפני חישוב התוצאות והדפדוף, ולא רק מסתיר תוצאות.
אם רשימת המאגרים אינה נטענת, מוצגת הודעה ואפשר לנסות שוב.

בשדות המילה הראשית, רווח בסוף מילה או בשדה ריק מעביר למילה הבאה; Enter מחפש.
המעבר שומר את התוכן שכבר נמצא בשדה הבא ומציב את הסמן בסופו.
בעמודה האחרונה, רווח אינו מדלג ואינו מפעיל חיפוש.
באמצע מילה ובבחירת טקסט נשמרת העריכה הרגילה. Tab עובר בין המילים
הראשיות לפי שורה, ואז בין החלופות שורה אחר שורה; Shift+Tab חוזר
לאחור. אחר כך מגיעים למרווחים, לאפשרויות ולכפתור החיפוש. החצים
למטה ולמעלה עוברים בין המילה הראשית לחלופות שבאותה עמודה; החצים הצדדיים
ממשיכים להזיז את הסמן כרגיל. הדבקת משפט אינה מפוצלת בין עמודות.

המרווח הוא המספר המרבי של מילים בין שתי עמודות סמוכות. 0 פירושו
מילים צמודות — זו ברירת המחדל של ממשק החיפוש באוצריא. אפשר לשנות
כל מרווח בנפרד. מקף או ביטוי בן כמה מילים אינם מותרים בתוך שדה אחד.

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

המילים שחיפשתם, והחלופות שלהן, מודגשות בתוצאות (כולל קידומות, סיומות וכתיב מלא/חסר לפי האפשרויות שסומנו).
התוצאות מופיעות בהדרגה. לחיצה על כותרת תוצאה פותחת את הספר לצד
החיפוש, במיקום שנמצא. אם אוצריא אינה יכולה לפתוח חלונית לצד, היא
פותחת את הספר בלשונית רגילה. „עצירת החיפוש” משאירה את התוצאות שכבר התקבלו. חיפוש חדש
מחליף את הישן ואינו מערבב ביניהם. דפדוף מתייחס לתנאי החיפוש האחרון;
שינוי הטבלה משפיע רק לאחר לחיצה על „בצע חיפוש”.
גם בחירת המאגרים נשמרת עם החיפוש האחרון בזמן מעבר בין עמודים.

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

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

התקנה: פותחים באוצריא את קובץ table-search-1.4.8.otzplugin ומאשרים
את ההרשאות. לאחר ההתקנה פותחים „חיפוש טבלאי” בלשונית כלים.


תאימות: נבדק בפועל ב-macOS עם אוצריא 0.9.98, בנייה 99802.
חוזה ה-SDK אומת מול קוד אוצריא 0.9.98+801. הפעולות בשימוש
קיימות מ-0.9.97, אך גרסה זו ו-Windows/Linux לא נבדקו בפועל. אין שימוש באפשרות סדר-מילים חופשי שנוספה לאחר מכן.
עד 500 תוצאות בעמוד, ועד 10,000 תוצאות לדפדוף; בחיפוש רחב יותר יש
לצמצם את התנאים. תוצאות חלקיות או אינדקס שאינו עדכני מסומנים במפורש.

בדיקות ופיתוח: query.js בונה את הבקשה; session.js מנהל את זרם
התוצאות והביטול; app.js אחראי לממשק. בדיקות Node בתיקיית tests.
הבדיקות משתמשות בנתוני דמה מבודדים בלבד. חבילת ההתקנה אינה כוללת
נתוני דמה או את כלי הבדיקה. ניתן לארוז מחדש באמצעות build_package.py.


חדש בגרסה 1.4.8:
• „מרווח כללי” (ליד „סינון מאגרים”): מספר אחד שמוזן בבת אחת בכל משבצות המרווח בין העמודות; אפשר אחר כך לשנות כל משבצת בנפרד.
• „חיפוש חדש” מנקה את התוצאות ואת כל המילים והמרווחים בטבלה.
• „ערוך חיפוש” (ליד „הצגת תוצאות” ו„מיון”) פותח את הטבלה כפי שהייתה, עם התוצאות שנשארות, לעריכה וחיפוש חוזר.
