בירור | העלאת קישורים

[shmuel]

@otzaria-bot
אם אני רוצה לעבוד על קישורים באמצעות התוסף של @d9, איך אני מעלה אותם ל-GitHub? או שעליי לשלוח אותם למישהו?

[פלמנמוני]

@shmuel לע"ע שלח ל @י.-פל.
יתכן ובעתיד יהיה ממשק שיתופי באתר אוצריא

[Otzaria-Bot]

הקישורים לא נכנסים למאגר של התוכנה אלא למאגר הספרייה — Otzaria/otzaria-library.

הייצוא מהכלי מפיק ZIP במבנה links/<שם ספר המקור>_links.json (ובמידת הצורך גם alt_toc/), וזה בדיוק המבנה שצריך להיכנס לתיקיית ה-links של אוסף המקור המתאים במאגר (למשל MoreBooks/links). את _report.txt לא מעלים — הוא בשבילך בלבד.

שתי דרכים:

• דרך GitHub: fork ל-otzaria-library, הוספת הקבצים בתיקייה הנכונה, ופתיחת PR. הפייפליין השבועי הוא שמכניס אותם בסוף ל-seforim.db.
• בלי GitHub: כפי שנכתב למעלה — לשלוח ל-@י.-פל.

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

תיעוד הפורמט המחייב נמצא ב-docs/קישורים-וכותרות.md באותו מאגר.

[Otzaria-Bot]

הקישורים נכנסים ל-repo של הספרייה, לא של התוכנה: https://github.com/Otzaria/otzaria-library

הפורמט שהמאגר מקבל הוא <תיקיית הספרים>/links/<שם הספר>_links.json — קובץ ליד תיקיית הספר עצמו (לדוגמה DictaToOtzaria/ערוך/links/). מה שהתוסף מייצר צריך להתאים לפורמט הזה, או לעבור המרה אליו.

שתי דרכים להעלות — אין צורך לשלוח לאף אחד אישית:

1. Pull Request (מועדף). עשה fork ל-Otzaria/otzaria-library, הוסף את קבצי ה-JSON, ופתח PR ל-main. אל תשכפל את המאגר למחשב — הוא בסביבות 3.2GB; העלה דרך ממשק הווב של GitHub (Add file → Upload files בתוך ה-fork). זה עובד בפועל: PR ‎#26 של משתמש חיצוני הוסיף בדיוק כך קישורי מפרשים לתלמוד בבלי ומוזג.
2. אם GitHub לא נוח לך — פתח נושא ב-https://github.com/Otzaria/otzaria-library/issues וצרף את הקבצים לפוסט. מתחזק ימזג.

לפני שאתה מעלה — שתי מלכודות שמפילות את הפייפליין השבועי:

• אם היעד (path_2) הוא ספר בבעלות ספריא — תלמוד בבלי, רש"י, תוספות, תנ"ך, משנה תורה — הרשומה חייבת לכלול גם ref_2. בלעדיו הסאגה השבועית נופלת בשגיאת new_target_ref_required. הסיבה: ספרי ספריא מיובאים מחדש כל שבוע ומספרי השורות בהם זזים, ולכן צריך מזהה יציב ולא line_index.
• path_2 חייב להיות בדיוק כתיב הכותרת של ספריא, כולל גרשיים. רש"י על שבת.txt מזוהה; רשי על שבת.txt — לא, וזה יישבר בשקט.
• האינדקסים 1-based, ושני הקצוות לא יכולים להיות שורות כותרת (<h…>) — אחרת הקישור מדולג.

התיעוד המלא, כולל קישורי טווח וקישורים למילה: https://github.com/Otzaria/otzaria-library/blob/main/docs/קישורים-וכותרות.md

[י. פל.]

@פלמנמוני כתב:

שלח ל @י.-פל.

למה?
שיפתח pr בotzaria-library!

[shmuel]

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

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