להורדה | תוסף ליצירת קישורים לש"ס

D9

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

כמה הערות

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

קישור להורדת הגרסה האחרונה:
https://github.com/crfh1672/otzaria-link-generator/releases/latest/download/com.otzaria.links-generator.otzplugin

קישור גיטהאב של התוסף
https://github.com/crfh1672/otzaria-link-generator

מדריך למשתמש

מחולל קישורים לאוצריא — מדריך שימוש

מה התוסף עושה

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

ניתן להכניס את קבצי הקישורים שהתוסף יוצר לתוכנה דרך הגדרות> ספריה> דורת וקישורים לספרים אישיים

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

שלב א׳ — מסך האפיון

1. בחירת ספר הפירוש (הטור הימני)

זהו הספר שעליו עובדים. שלוש דרכים לבחור:

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

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

2. אפיון המיפוי (הטור האמצעי)

קטגוריית מקור וספר מקור

הבחירה בין תנ"ך, ש"ס והלכה אינה רק מסננת את רשימת הספרים — היא משנה את אופן העבודה
של המנוע. בין היתר בש"ס הוא מנסה לנתב גם לרש"י ולתוספות;

החלפת קטגוריה מאפסת את ספר המקור לראשון ברשימה.

מבנה הקטעים — מוצג רק בקטגוריית הלכה

שתי שאלות שרק אתם יודעים לענות עליהן, והן משנות מהותית את התוצאה:

"קטע פירוש מתחלק לכמה שורות" — האם קטע פירוש אחד עשוי להימשך על פני כמה שורות בקובץ.

"הספר מחולק לסעיפים קטנים" — מוצגת רק אם הראשונה דלוקה.

שלוש התוצאות:

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

איך לבחור: אם התוצאה מלאה בשורות "ירושת הקשר" שלא היו צריכות לרשת — כבו את השאלה השנייה.
אם יש הרבה שורות ריקות שהן בבירור המשך הקטע שמעליהן — הדליקו את הראשונה.

תו סיום דיבור המתחיל

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

"הפנה לדף הנוכחי" (ש"ס)

⚠️ המתג הזה אינו משפיע היום על התוצאה. הוא מוצג ונשמר, אך המנוע אינו מתחשב בו. טיפול
במילה "שם" נעשה ממילא, בלי קשר למצבו.

3. הגדרות אלגוריתם (הטור השמאלי)

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

תמיכה בפענוח ר"ת — פותח ראשי תיבות בשני הצדדים לפני ההשוואה,
השוואה גמישה קלה — מאפשר התאמה גם כשיש הבדלי כתיב או צורה דקדוקית. כיבוי דורש התאמה
מדויקת יותר.
שקילת מילים — מפחית את חשיבותן של מילים שכיחות ("אמר", "רבי", "הוא"), כדי שהתאמה על מילים
נדירות תיחשב חזקה יותר. כיבוי משווה בין כל המילים.

4. הרצה

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

בקטגוריות ש"ס כאשר המפרש מצטט תוס' התוסף מנסה בעצמו לאתר את רש"י ותוספות על ספר המקור, לפי עשרות וריאציות
שם.

שלב ב׳ — מסך העריכה

מה רואים

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

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

קוד הצבעים

מראה הכרטיס	משמעות
רגיל	מקושר בזכות עצמו
ורוד + משולש אזהרה	לא נמצא לו מקור — דורש טיפול
אפור בהיר + תג "ירושת הקשר"	מקבל את הקישור של שורה שמעליו
מקווקו ועמום + "לפני תחילת ההשוואה"	חומר פתיחה (הקדמה, הסכמות, שער) — לא נסרק בכוונה, אין מה לתקן
הבהוב ירוק	השורה זה עתה קושרה מחדש

הכפתורים בכל כרטיס

⠿ ידית גרירה — הדרך המהירה לקשר מחדש. ראו למטה.
תג האחוזים — לחיצה עליו מסמנת את הקישור כ"נבדק" (ירוק) או "ממתין לבדיקה" (כתום). המספר
עצמו לא משתנה. זהו סימון עבודה פנימי בלבד ואינו מיוצא.
↰ ירושת הקשר — הופך את השורה להמשך השורה שמעליה, או משחרר אותה בחזרה לעצמאות.
⧉ מועמד הבא — מופיע רק כשהמנוע מצא כמה אפשרויות. מדלג ביניהן במחזוריות; המספרון מציג באיזו
אתם. בחירה במועמד מסמנת את השורה כ"ממתין" כדי שתשימו לב שהחלפתם.
✎ עריכה — פותח את חלון הבחירה המלא.
⛓ ניתוק — מוחק את הקישור.

ריחוף על כפתור מראה מראש כמה שורות יושפעו — למשל "נתק קישור · 4 שורות שיורשות את ההקשר ממנה
ינותקו אף הן". שווה לקרוא לפני שלוחצים.

קישור מחדש בגרירה — הדרך המהירה

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

עם מקלדת (או בלחיצה רגילה על הידית): נפתחת אותה רשימה, ומנווטים בה כך:

מקש	פעולה
↓ ←	המועמד הבא
↑ →	המועמד הקודם
PageDown / PageUp	קפיצה של חמש
Enter או רווח	אישור
Escape	ביטול — עובד גם באמצע גרירה בעכבר

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

חלון העריכה המלא

לבחירה מדויקת, או לקישור לספר אחר לגמרי. בחלון:

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

קישור שבחרתם ידנית מקבל אוטומטית 100% וסטטוס "מאושר" — בחירה שלכם ודאית בהגדרה.

עריכת כמה שורות יחד

Ctrl (או ⌘) + קליק על כרטיס — מוסיף או מוריד אותו מהבחירה.
Shift + קליק — בוחר את כל הטווח מהנקודה הקודמת ועד כאן.
קליק רגיל — מנקה את הבחירה. לחיצה על כרטיס כדי לקרוא אותו לעולם אינה משנה דבר.

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

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

ירושת הקשר — מה זה

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

שורת "בא"ד" שראש השרשרת שלה עדיין לא קושר מוצגת יחד איתו במסגרת אחת ואינה נספרת בנפרד — קישור
של השורה העליונה פותר את שתיהן בבת אחת.

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

מחוון השורות הלא-מקושרות

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

הספירה אינה כוללת שורות ריקות, כותרות, חומר פתיחה, ושורות בא"ד שממתינות לראש שרשרת. אלו
אינן תקלות.

מגירת הניווט (☰) והסרגל העליון

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

בסרגל העליון: שמות שני הספרים ומונה הקישורים, ואז ⭳ ייצוא, 🗀 פרויקטים שמורים, 💾 שמירה,
⧩ מיון, ↺ חזרה למסך האפיון.

המיון — לפי סדר הספר, או לפי ניקוד עולה/יורד. ראו את המלצת העבודה בהמשך.

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

שלב ג׳ — ייצוא

לחיצה על ⭳ מורידה קובץ ZIP בשם הפירוש, ובו:

קובץ הקישורים הראשי — <פירוש>_links.json. זה הקובץ שאוצריא צורכת, והוא המוצר העיקרי.

קבצי קישורים הפוכים — אותם קישורים, קרואים מצדו של ספר המקור. נוצר קובץ נפרד לספר המקור,
לרש"י ולתוספות (זאת הצורה הישרה להכניס את הקישורים לאוצריא).

קובץ מראה לגמרא (ש"ס בלבד) — שורת פירוש שקושרה לרש"י או לתוספות תלויה בפועל גם בשורת הדף
עצמו, וזהו הקישור השני הזה. כיסוי חלקי כאן הוא נורמלי.

<פירוש>_links.csv — אותו מידע כטבלה, נפתח נכון באקסל בעברית.

<פירוש>_analysis.csv — קובץ בקרה מפורט: לכל קישור מוצגים שורת הפירוש, הד"ה, שורת המקור,
האחוז, וגם פירוט הניקוד מילה במילה — אילו מילים תרמו ואילו גרעו, וציוני כל המועמדים. זה
הכלי לברר למה המנוע בחר כפי שבחר.

<פירוש>.txt — הפירוש כפי שנטען, עם דיבור המתחיל מודגש בכל שורה.

תיקיית "שורות_ללא_קישור" — קובץ נפרד לכל שורה שלא קושרה, ובו השורה, כותרת הקטע שלה, וכל
טקסט הקטע המקביל במקור, ברש"י ובתוספות — כדי שתוכלו להכריע ידנית בלי לפתוח את הספר.

אחוז הוודאות — מה המספר אומר

האחוז שליד כל קישור הוא הערכה עצמית של המנוע, ותפקידו היחיד לומר לכם במה כדאי לפתוח את
הבדיקה. הוא אינו משפיע על ההחלטה לאיזו שורה לקשר, ואינו נכלל בקובץ המיוצא.

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

קישור שירש את יעדו משורה אחרת מקבל את האחוז של אותה שורה, פחות כ-20% לכל דילוג. כך "שם" ישירות
מתחת לקישור ודאי נראה אחרת מ"שם" שישה דילוגים במורד שרשרת רעועה.

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

מגבלות שכדאי להכיר

המתג "שם כהפנה לדף הנוכחי" בקטגוריית ש"ס אינו משפיע על התוצאה.
אין כפתור "אשר את כל הקישורים הוודאיים" — אישור נעשה כרטיס-כרטיס, או בבחירה מרובה.
הייצוא היחיד הוא חבילת ה-ZIP — אין ייצוא Markdown, HTML או העתקה ללוח.
סימון "נבדק / ממתין" אינו מיוצא. הוא כלי עבודה פנימי בלבד.
חוץ מאוצריא — אם התוסף רץ מחוץ לאפליקציה, מוצגים ספרי דמה, הודעות ההצלחה והשגיאה אינן
מופיעות, ומחיקת פרויקט או איפוס מילון ראשי התיבות לא יעבדו.

פתרון בעיות

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

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