בקשת מידע | צורת הקישורים החדשה באוצריא - מגירסה 0.9.95

[מיכאלוש]

@יאיר-דניאל כתב:

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

הוא כתב

@Otzaria-Bot כתב:

2. קישורים אישיים בין ספרים — CSV/JSON
   זה מאפשר להוסיף קישורים מותאמים אישית שאינם בספרייה הרשמית.

פורמט הקבצים: *.links.csv או *.links.json

ייבוא (מ-0.9.95): הגדרות > ספרייה > "ייבוא דורות וקישורים" — בחירת קובץ ידנית, חד-פעמי.

שינוי מרכזי מהגרסה הקודמת:

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

לשאלת איפה מכניסים קישורים אישיים — הגדרות > ספרייה > "ייבוא דורות וקישורים", ובחירת קובץ .links.csv או .links.json.

אם יש צורך בפירוט על מבנה עמודות ה-CSV/JSON — אשמח לחפש

[יאיר דניאל]

@מיכאלוש הוא כתב מה זה - הוא לא הסביר איך זה בנוי ומה השינויים.

[שווה]

@otzaria-bot איך מכניסים את הנתונים האלה לתוכנה?

[יאיר דניאל]

@שווה ?
זה מבנה הקישורים החיצוני - לספרים בתוכנה, לא בין ספרים בתוך התוכנה

[שווה]

@יאיר-דניאל ואם אני רוצה שהאיתור ימצא ספר אישי, ובפרט ספר PDF בעמוד מסוים, יש דרך לעשות את זה?

[Otzaria-Bot]

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

שימוש בקישור:
הדבק את הכתובת (לדוגמה otzaria://open/book/123) בשורת הכתובת של הדפדפן ולחץ Enter — מערכת ההפעלה תפתח את אוצריא ישירות למיקום המבוקש. כך עובד גם לחיצה על קישור כזה בצ'אט/מייל.

כיצד משיגים את ה-<id> של ספר?
בתוך התוכנה — לחיצה ימנית על ספר/טקסט → "העתק קישור" (או ניסוח דומה). הקישור המועתק יכלול כבר את ה-id הנכון.

לסיכום: הטבלה מתארת את המבנה לצורך יצירה/שיתוף קישורים. בפועל: מקבלים קישור מהתוכנה בלחיצה ימנית, ושולחים/פותחים אותו מחוץ לתוכנה.

[א.י.ז]

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

[יאיר דניאל]

@שווה כתב:

@יאיר-דניאל ואם אני רוצה שהאיתור ימצא ספר אישי, ובפרט ספר PDF בעמוד מסוים, יש דרך לעשות את זה?

סטייה מהנושא.

[יאיר דניאל]

@otzaria-bot
תגיב לפוסט הזה:
https://otzaria.org/forum/post/25779
ולפוסט הזה:
https://otzaria.org/forum/post/25781
קרא אותם היטב לפני שאתה מגיב.

[Otzaria-Bot]

קובץ קישורים בין ספרים — שני פורמטים

---

פורמט Native (הישן) — <שם_ספר>_links.json

זה הפורמט שהיה קיים לפני גרסה 0.9.95 — הקובץ שצירפת (שיטות קמאי_links.json) הוא בפורמט הזה. כל רשומה מכילה:

[
  {
    "line_index_1": 5,
    "line_index_2": 120,
    "path_2": "שם/נתיב/ספר_היעד",
    "heRef_2": "ב עא",
    "Conection Type": "commentary"
  }
]

• line_index_1 — שורת המקור בספר הבסיס (1-based)
• line_index_2 — שורת היעד בספר המפרש (1-based)
• path_2 — נתיב/שם ספר היעד
• heRef_2 — כתובת עברית (דף ועמוד) — לתצוגה בלבד
• Conection Type — סוג הקישור: commentary, targum, reference, source, other

---

שינוי מרכזי מ-0.9.95

לפני: אוצריא סרקה אוטומטית את תיקיית הספרים האישיים בכל הפעלה ומצאה קבצי *_links.json.

עכשיו: ייבוא ידני — הגדרות > ספרייה > "ייבוא דורות וקישורים" > בחירת קובץ. הנתונים נשמרים לצמיתות ב-user_books.db.

כלומר: הקובץ הישן שלך תקף לחלוטין, צריך רק לייבא אותו ידנית.

---

איך לעדכן קישורים קיימים

1. ערוך את קובץ ה-JSON
2. הגדרות > ספרייה > "נקה הכל" (עם אישור)
3. ייבא את הקובץ המעודכן דרך "ייבוא דורות וקישורים"

---

פורמט חדש (CSV/JSON) — *.links.csv / *.links.json

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

מקור, ספר_יעד, מיקום_יעד, סוג, יעד_אישי, ספר_מקור, מקור_אישי, קטגוריית_מקור, קטגוריית_יעד

עמודות חובה: מקור, ספר_יעד, סוג.

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

דוגמה:

ספר_מקור,מקור,ספר_יעד,מיקום_יעד,סוג
שיטות קמאי על בבא מציעא,5,שיטות מקובצות,ב ז,פירוש

---

קובץ דורות — דורות.csv

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

דורות חוקיים (בדיוק):

• תורה שבכתב
• חז"ל
• ראשונים
• אחרונים
• מחברי זמננו

דוגמה:

ספר,דור,מחבר
שיטות קמאי על בבא מציעא,ראשונים,
שיטות מקובצות על בבא קמא,ראשונים,

הייבוא: הגדרות > ספרייה > "ייבוא דורות וקישורים" — ניתן לבחור קובץ CSV אחד הכולל גם דורות וגם קישורים, או קבצים נפרדים.

[י. פל.]

@יאיר-דניאל
חבל על זמנך, יש תיקייה בשם docs בotzaria-library, עם תיעוד מעולה!