Repository navigation
Search
דף זה מתאר את החיפוש המילולי בקוד הפיתוח. להוראות שימוש ראה חיפוש בתוכן הספרים. החיפוש לפי עניין מתואר בנפרד בחיפוש חכם — מימוש.
יש להבחין בין ארבעה מסלולים:
| מסלול | מקור הנתונים | רכיב מרכזי |
|---|---|---|
| חיפוש ספר לפי שם או מחבר | קטלוג הספרייה |
DataRepository.findBooks ועובד חיפוש הספרים |
| איתור מקום ידוע | שמות ספרים, תוכן עניינים ומראי מקום | FindRefRepository |
| חיפוש מילים בתוכן | אינדקס מנוע החיפוש, ובמידת הצורך טקסט מהמסד המקורי | SearchRepository |
| חיפוש לפי עניין | מודל מקומי ונתוני וקטורים המתאימים לספרייה | SemanticSearchRepository |
חיפוש מקומי בתוך ספר פתוח משתמש בחלק מממשק ההגדרות המשותף, אך אינו זהה בכל יכולותיו לחיפוש באינדקס. לדוגמה, אפשרויות התאמת ניקוד וטעמים מוצגות רק במסלולים הנתמכים.
| רכיב | אחריות |
|---|---|
SearchDialog |
הזנת שאילתה, מצב, היקף ואפשרויות; חסימת חיפוש התלוי באינדקס חסר או לא תואם |
SearchConfiguration |
המצב והפרמטרים השמורים בכרטיסיית החיפוש |
SearchQueryBuilder |
תרגום בחירות הממשק לבקשה למנוע, לרבות הרחבות וחלופות |
SearchRepository |
ממשק החיפוש, ספירות, עימוד ופתרון זהות ספרים |
SearchEngineGateway |
גבול הקריאה למנוע הילידי ולפעולות הביטול שלו |
SearchBloc |
ניהול בקשות, תוצאות, מסננים, טעינת המשך ומצב שגיאה |
TantivySearchResults |
תוצאות, תצוגה מקדימה, איחוד, טעינת המשך ופתיחת מקור |
LibraryLineSource |
אספקת תוכן עדכני מהספרייה עבור רשומות אינדקס המפנות למקור |
עיבוד השאילתה והתאמת המילים נשענים על מנוע החיפוש. אין לשחזר ב־Dart מנרמל או מפרק מילים חלופי שאינו תואם ל־tokenizer של המנוע.
SearchMode כולל exact, advanced ו־fuzzy. האפשרות „חיפוש חכם” בממשק אינה ערך נוסף באותו enum; היא פותחת מסלול ותצורת תוצאות נפרדים.
Exact: חיפוש לפי המילים והסדר, עם אפשרות למרווח ולהרחבות משותפות לכל המילים. כאשר מופעלות אפשרויות הדורשות זאת, הבקשה מתורגמת למסלול מתקדם במנוע. לכן אין להניח שכל בקשה שהגיעה ממצב „מדויק” היא חיפוש רצף מילולי ללא הרחבות.
Advanced: אפשרויות גלובליות או לפי מילה, חלופות, מרווח לכל מעבר, החרגות, תחום ההתאמה וכמות המילים הנדרשת. SearchMatchPolicy מפריד בין „כל המילים”, „לפחות אחת”, „רוב” וסף מפורש. תחום ההתאמה יכול להיות מרווח מילים, אותה פסקה או אותה כותרת.
Fuzzy: מרחק עריכה של עד שתי פעולות ברמת המילה. הוא אינו מדד לקרבה בין מילים בטקסט ואינו חיפוש סמנטי. אפשרויות המילה של החיפוש המתקדם אינן מועתקות אליו אוטומטית.
יש להבחין בין:
- אפשרות חיפוש שמרחיבה את המילים, כגון כתיב מלא/חסר, תחיליות או חלופות.
- דרישה להתאמת סימנים שהוקלדו, כגון ניקוד.
- הגדרת תצוגה של הקורא, כגון הסתרת ניקוד, שאינה משנה כשלעצמה את תוכן המקור או את האינדקס.
מצב ואפשרויות נשמרים בזיכרון העבודה, וניתן לקבוע במפורש ברירת מחדל להפעלות הבאות. עריכת כרטיסייה קיימת משתמשת בתצורת הכרטיסייה.
היקף הספרים מתורגם ל־facets על פי זהות הספרים והקטגוריות. אין להשתמש בכותרת הספר כמזהה יחיד: שמות זהים יכולים להגיע מהספרייה הרשמית, מקבצים אישיים וממסדים מצורפים.
תחביר שאילתה@ספר@קטגוריה מפוענח ב־CategoryQueryParser. כשהוא קיים, הוא מחליף את בחירת הספרים והקטגוריות הידנית. מסננים מממד אחר, כגון מחבר ותקופה, עדיין מצורפים אליו.
ממדי הסינון כוללים בין היתר /base, /era/ ו־/author/. כמה בחירות באותו ממד מצורפות כחלופות; ממדים שונים מצמצמים זה את זה. שינוי היקף חייב לעדכן גם את התוצאות וגם את הספירות, בלי לפרסם ספירה ששייכת לבקשה קודמת.
UserRegexQuery מזהה שאילתה שלמה המוקפת /…/, ומבקש מהמנוע לפרש אותה. ביטוי תקין מקבל תוכנית חיפוש ומנגנון התאמה משלו; הוא אינו עובר הרחבות רגילות כאילו היה רצף מילים.
דגשים למימוש:
- זיהוי תלוי בתחביר תקין, לא רק בנוכחות לוכסן.
- שאילתה שאינה מזוהה כביטוי תקין חוזרת למסלול טקסט רגיל.
-
@בתוך ביטוי תקין אינו מפריד היקף. - חיפוש ביטוי הכולל רווחים עשוי לדרוש בדיקת תוכן השורה. אין להניח התאמה על פני שורות עצמאיות.
- עוגני תחילה וסוף מתייחסים לשורה במסלול המתאים.
- תחביר המנוע הוא הסמכות; אין להבטיח תמיכה בכל תחביר של
RegExpב־Dart.
SearchBloc משייך מזהה לבקשת חיפוש ומשתמש בביטול הילידי. תשובה שהגיעה לאחר שבקשה חדשה החליפה אותה אינה אמורה לעדכן את המסך. גם ספירות ה־facets נבדקות מול תמונת מצב של השאילתה וההיקף.
המסלול המשולב יכול לקבל תוצאות וספירות מאותה הרצה ולהציג תוצאות באצוות. עימוד מוסיף לתוצאות הקיימות; חיפוש חדש מחליף אותן. סינון מקומי של רשימה קודמת מתאים רק כשהרשימה מלאה והתצורה תואמת — רשימה שנחתכה או נטענה חלקית אינה בסיס לספירה מלאה.
הממשק מבחין בין שגיאת חיפוש, אפס תוצאות וחיפוש רחב מדי. אין להמיר את שלושתם לרשימה ריקה מוצלחת.
אינדקס עשוי לשמור הפניה לשורת מקור במקום עותק מלא של הטקסט. LibraryLineSource ופתרון הזהות מחברים את התוצאה למקור המתאים. לכן קובץ ספרייה לא זמין, ספר ששונה ואינדקס ישן הם מצבים שיש לטפל בהם גם כשמנוע החיפוש הצליח למצוא מזהה.
SearchResultOpener מאמת את הספר מול המזהה והכותרת שנשמרו בתוצאה. IndexFreshnessWarner יכול להזהיר כשהתוכן השתנה. אין לפתוח ספר אחר בעל אותו שם כתחליף שקט.
איחוד לפי סעיף או טקסט זהה שומר מידע על מופעים נוספים. מספר קבוצות, מספר תוצאות ומספר מופעים הם נתונים שונים. מצב תצוגה מקדימה משנה גם את פעולת הלחיצה: בחלונית רחבה לחיצה יחידה יכולה לבחור תצוגה מקדימה, ולחיצה כפולה פותחת את הספר.
תוספים יכולים לספק תוצאות חיצוניות באותו מסך. מקור התוצאה, מצב הטעינה ומגבלותיו נשארים נפרדים מהתוצאות המקומיות; ראה תוספים.
דף הבית · התחלת העבודה · שאלות נפוצות · פתרון תקלות
מדריך המשתמש נבדק מול גרסה 0.9.98.3+809; פרטי גרסאות ומועד הבדיקה בדף הבית.
התחלה מהירה
קריאה וחיפוש
אישי ותחזוקה
- כרטיסיות ושולחנות
- סימניות והערות
- ספרים אישיים
- מסדים אישיים
- גיבוי ושחזור
- הגדרות
- עדכונים
- תוספים
- כלים
- קישורים ישירים
תיעוד למפתחים
יסודות
נתונים
קריאה
חיפוש
מערכת
ממשק