Skip to content

ספריא: סמני סעיף בנושאי-כלים לא חוזרים לסעיף קודם (Otzaria/otzaria#5503) - #148

Open
palmoni5 wants to merge 1 commit into
Otzaria:otzariafrom
palmoni5:fix/seifim-backward-links
Open

palmoni5 wants to merge 1 commit into
Otzaria:otzariafrom
palmoni5:fix/seifim-backward-links

Conversation

@palmoni5

Copy link
Copy Markdown
Member

Important

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

Fixes Otzaria/otzaria#5503

הבעיה

במגן אברהם, סימן תמז, האפליקציה מציגה [סעיף א] באמצע סעיף יא, ומיד אחריו שוב [סעיף יא]. הסמנים האלה הם עלי מבנה ה-alt-TOC Seifim ש-SynthesizeSeifimAltTocPostProcess מסנתז מקישורי COMMENTARY מהשו"ע.

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

התיקון

ב-computeSeifMarkers כל שורה בוחרת סעיף לפי הסדר הזה:

  1. אם אחד מקישוריה הוא הסעיף הנוכחי, היא נשארת בו.
  2. אחרת היא פותחת את הסעיף הקרוב שאחריו באותו ספר בסיס, לפי lineIndex בבסיס.
  3. אם אין קישור כזה, נבחר הקישור הראשון, כמו היום, גם אם הוא אחורה.

השאילתה מוסיפה את bl.lineIndex, וה-ORDER BY לא השתנה. הכלל החדש שונה מהישן רק כשהישן בחר סעיף קודם, או כשהשורה מקושרת גם לסעיף הנוכחי.

היקף (ספרייה מקומית 2026-11, 66 נושאי-כלים על השו"ע)

  • כל הספרים: סמנים שחוזרים אחורה בתוך סימן ירדו מ-1,901 ל-259.
  • מגן אברהם: מ-265 ל-0.
  • ספרים שבאמת נבנים (אחרי שער ה-≥חצי וה-mirror): 73,758 סמנים ← 72,483. ההכרעות: 735 נשארו בסעיף הנוכחי, 725 עברו קדימה, 110 נשארו עם הקישור הראשון.

ביקורת איכות (QA עצמאי)

  • דגימה ידנית: 26 נקודות שבהן הכלל החדש שונה מהישן, מ-15 ספרים. החדש צודק ב-23, הישן ב-0, 2 לא ברורות, ובאחת שניהם שגויים.
  • השוואה אוטומטית לפי חפיפת הדיבור המתחיל לטקסט הסעיף, על כל 1,750 הנקודות: החדש טוב יותר ב-1,266, הישן ב-101, תיקו ב-383. ב-4 מתוך 5 "הישן טוב יותר" שנבדקו ידנית החדש צודק. החפיפה נוצרה שם מהפניה כמו "עיין ס"א".
  • מגבלה ידועה (כ-14 מקרים): שורה שמקושרת ל-[סעיף קודם, הנוכחי, הבא] ושייכת בפועל לבא נשארת בנוכחי, והסמן של הבא יורד שורה אחת מאוחר מדי. זו לא רגרסיה, כי הקוד הישן קפץ שם אחורה. אין דרך להכריע את זה מהקישורים בלבד.
  • 110 הנותרים שחוזרים אחורה: בערך חצי מהם פירוש שבאמת לא לפי הסדר, וחצי רעש בנתונים. השארת הסמן היא הבחירה השמרנית, כי דיכוי היה מעביר שורות לקבוצה לא נכונה בלי שום סימן.

מזהים

מזהי העלים נקבעים לפי (structure_id, ancestor_path) עם מספר סידורי לכל הורה. בסימנים שבהם מספר העלים משתנה (כ-876 מתוך כ-15,135), אותם מזהים עוברים לעלים אחרים, ומזהים בסוף נעלמים. BuildStateVerifier לא דוחה את זה, והאפליקציה לא שומרת מזהי alt-TOC בסימניות, בהיסטוריה או בלשוניות. ב-delta זה יופיע כעדכונים ב-alt_toc_entry וב-line_alt_toc.

בדיקות

  • ComputeSeifMarkersTest (8) ו-SynthesizeSeifimAltTocIntegrationTest (10) עוברים בהרצה עם --rerun.
  • נוספו שלוש בדיקות:
    • רצף השורות מרובות-הקישורים של מגן אברהם סימן תמז, מהנתונים האמיתיים. הבדיקה נכשלת על האלגוריתם הישן (אומת).
    • שורה שמקושרת רק לסעיף קודם עדיין פותחת אותו.
    • הבחירה קדימה מוגבלת לספר הבסיס של הקבוצה הנוכחית.

PR-ים פתוחים חופפים

אין. #147, #105 ו-#100 לא נוגעים ב-SynthesizeSeifimAltTocPostProcess.kt או בבדיקות שלו.

נדרש

בנייה מחדש של הספרייה.

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

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

על הספרייה הנוכחית (66 ספרים): סמנים שחוזרים אחורה בתוך סימן ירדו מ-1901 ל-259, במגן אברהם מ-265 ל-0.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[דיווח מהתוכנה] ציון לא נכון

1 participant