תוסף לאוצריא שמחבר אותה לתוכנת פרויקט השו"ת של אוניברסיטת בר אילן שמותקנת במחשב. מתוך אוצריא אפשר:
- ספרים: לחפש ספרי בר אילן לפי שם או מחבר, לעיין בקטגוריות שלו, לראות את פרטי הספר ולפתוח אותו בבר אילן בלחיצה;
- חיפוש בטקסט, עם כל אפשרויות החיפוש של בר אילן: חיפוש רגיל (כמו "חיפוש קל", עם ההגדרות שלו), חיפוש מתקדם (צורות, חלופות וביטויים, מרחקים, ומילים באותו משפט, פסקה או מסמך, כמו "חיפוש טבלאי"), או ניסוח חופשי — בלי לזכור סימנים, עם דוגמאות בכל סוג והסבר במילים של מה יחופש;
- איתור מקום: לכתוב "בראשית ב ג" או "ברכות דף ב עמוד א", ובר אילן נפתח ישר במקום הזה;
- מתוך אוצריא עצמה:
- לחיצה ימנית על טקסט מסומן ← "חיפוש בבר אילן" (או
Ctrl+Alt+B); - לחיצה ימנית בספר ← "איתור המקום בבר אילן": בר אילן נפתח באותו מקום;
- ספרי בר אילן בחיפוש של מסך הספרייה;
- "חיפוש בבר אילן" בדיאלוג החיפוש;
- קיצורי מקלדת ללשוניות התוסף;
- לחיצה ימנית על טקסט מסומן ← "חיפוש בבר אילן" (או
- לעבוד בעברית או באנגלית, ובלי אינטרנט.
בר אילן לא צריך להיות פתוח: התוסף מפעיל אותו כשצריך. התוסף אינו מעתיק תוכן, והספר נפתח בבר אילן עצמו.
הבהרה: התוסף נועד למי שרכש כדין רישיון לבר אילן, ואינו מוצר רשמי של בר אילן. "שארית ישראל לא יעשו עוולה" (צפניה ג, יג). ראו התוסף ותנאי הרישיון של בר אילן, ופרטים בפורום אוצריא.
- הורידו את המתקין: OtzariaResponsa-Setup.exe (קישור קבוע לגרסה האחרונה; גם בדף ההורדות). במחשב בלי אינטרנט: מעבירים את הקובץ בדיסק און קי. הוא כולל גם את התוסף לאוצריא.
- הריצו אותו. אין צורך בהרשאות מנהל.
- אשרו את התקנת התוסף באוצריא, והדליקו את ההרשאה "הוספת רכיבים לתוכנה".
הסרה: מאפליקציות מותקנות ב-Windows ("שירות בר אילן לאוצריא"). בוחרים בין הסרה לצורך עדכון (השירות בלבד), הסרה רגילה (גם רשימת הספרים והיומן) והסרה מלאה (גם התוסף באוצריא). פירוט במדריך.
דרישות: Windows 10 ומעלה (64 ביט), אוצריא 0.9.98.1 ומעלה (היא 0.9.98.2), ופרויקט השו"ת של בר אילן בכל מהדורה. (גרסה 0.4 של התוסף מתאימה לאוצריא 0.9.97, וגרסאות 0.5 עד 0.6 לאוצריא 0.9.98.)
פנייה למפתח: "דיווח על בעיה" בתוסף עצמו (הלשונית "אודות ודיווח"), או ב-Issues של הפרויקט.
| מסמך | למי |
|---|---|
| docs/USER_GUIDE.md | משתמשים: התקנה, שימוש ופתרון בעיות, עם תמונות |
| CONTRIBUTING.md | מפתחים: מפת הקבצים, כללים, דיבוג ופקודות אימות |
| AGENTS.md | סוכני AI: כללי עבודה ומלכודות ידועות |
| docs/ARCHITECTURE.md | מתחזקים: רכיבים, החלטות וזרימות |
| docs/PROTOCOL.md | החוזה בין התוסף לשירות המקומי |
| docs/PLUGIN_ACCESS.md | מפתחי תוספים אחרים: קריאת רשימת ספרי בר אילן ופתיחתם |
| docs/RELEASING.md | שחרור גרסה ופרסום בחנות |
| CHANGELOG.md | שינויים לפי גרסה |
בחנות התוספים של אוצריא: https://otzaria.org/plugins/6abfbb96f4aadb0d88fd755a
שני רכיבים: התוסף (plugin/) רץ בתוך אוצריא, ושירות מקומי קטן (helper/) רץ ברקע ושולט בבר אילן. הם מדברים ב-HTTP על 127.0.0.1. קוד השליטה בבר אילן הועבר מ-Otzaria/otzaria#1572.
הסכם הרשאת השימוש של פרויקט השו"ת ("ההסכם") מעניק למשתמש זכות שימוש אישית במערכת. להלן מה התוסף עושה ומה אינו עושה, לפי סדר תנאי ההסכם:
- רישיון ושימוש אישי. התוסף אינו כולל, אינו מפיץ ואינו מחליף שום רכיב של המערכת: לא תוכנה, לא מאגרי מידע ולא תיעוד. הוא פועל רק מול מערכת שהמשתמש רכש והתקין במחשבו, וכל ספר נפתח לקריאה בתוכנת בר אילן עצמה.
- שימוש מסחרי. התוסף ניתן חינם, בקוד פתוח, ללא תשלום, פרסומות או תמורה אחרת.
- העתקה ושכפול. התוסף אינו מעתיק את התוכנה או את קובצי הטקסט שלה, ואינו קורא, שומר או מעביר את תוכן הספרים. כדי לפתוח את הספר הנכון הוא בונה פעם אחת רשימת ספרים: שם, מחבר, קטגוריה ופרטי מהדורה. הם נקראים, לקריאה בלבד, מעץ הספרים שבחלון "עיון", מקובץ העזרה של המערכת ומטבלת המחברים שבקובצי ההתקנה.
- הרשימה נשמרת במחשב המשתמש (
%LOCALAPPDATA%\OtzariaResponsa), התוסף והשירות אינם שולחים אותה אל מחוץ למחשב. - הסרה רגילה או מלאה של השירות מוחקת אותה. הסרה "לצורך עדכון" והסרת התוסף בלבד משאירות אותה, למקרה של התקנה חוזרת.
- שמות הספרים, המחברים והקטגוריות נמסרים גם לאוצריא שבאותו מחשב ונשמרים אצלה, כדי שיופיעו בחיפוש הספרייה. כיבוי המתג "ספרי בר אילן בחיפוש הספרייה" מוחק אותם מאוצריא.
- תוסף אחר לאוצריא שהמשתמש התקין, ושקיבל ממנו את ההרשאה "גישה לשירותים מקומיים", יכול לקרוא את אותה רשימה מהשירות שבמחשב (docs/PLUGIN_ACCESS.md). מדובר בפרטי הקטלוג בלבד, ולא בתוכן הספרים. השימוש שתוסף כזה עושה ברשימה הוא באחריותו.
- הרשימה נשמרת במחשב המשתמש (
- התאמות בתוכנה ושילובה בתוכנה אחרת. התוסף אינו משנה קובץ, קוד או רכיב של המערכת, ואינו משלב את הקוד שלה או את תוכן ספריה בתוכנה אחרת. הוא מפעיל אותה מבחוץ, דרך החלונות שלה (עיון, כתיבת מקורות, חיפוש, בחירת מאגרים): שולח אליהם לחיצות והקלדות כהודעות Windows, וקורא מהם את מה שהם מציגים, כמו שורות עץ הספרים ומספר התוצאות.
- בחירת מאגרים בחיפוש המתקדם נשמרת בבר אילן כמו בחירה ידנית, וחלה גם על החיפושים הבאים בו.
- בתוך אוצריא מוצגים שמות ספרי בר אילן (בחיפוש הספרייה) והסמל של בר אילן. הסמל נקרא מההתקנה, ואינו מצורף לתוסף.
- מנגנון ההגנה. התוסף אינו עוקף, משבית או משנה את מנגנון ההגנה מפני העתקה. בר אילן מופעל מקובץ ההפעלה שלו, כרגיל. כשאינו נפתח, התוסף מודיע על כך ועוצר.
- הדפסה והפקה מסיבית, הוצאה לאור ותרגום. התוסף אינו מדפיס, מייצא או מעתיק את טקסט הספרים. הספרים ותוצאות החיפוש מוצגים בתוכנת בר אילן בלבד.
- תחנת עבודה אחת. השירות המקומי מקבל בקשות רק מהמחשב עצמו, ורק מאותה הפעלה (session) של Windows (PROTOCOL.md §2). הוא אינו מאפשר שימוש במערכת ממחשב אחר.
התוסף אינו מוצר של אוניברסיטת בר אילן או של "בר-אילן — חברה למחקר ופיתוח בע"מ", ואינו קשור אליהן. כל הזכויות במערכת ובתכניה שמורות לבעליהן. ההצהרה מתארת את מבנה התוסף ופעולתו, ואינה ייעוץ משפטי. כל משתמש אחראי לשימוש שלו בהתאם לרישיון שבידו. בכל ספק באשר לאופי השימוש, ההסכם מורה לקבל מראש אישור בכתב של נציג החברה.