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

[יאיר דניאל]

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

כמו"כ - אם תוכל לפרט את מבנה קובץ סדר הדורות שאפשר ליצור, איזה פורמט הוא אמור להיות, איך הוא בנוי וכל מה שמסביב.
@otzaria-bot

[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 אחד הכולל גם דורות וגם קישורים, או קבצים נפרדים.

[Otzaria-Bot]

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

---

שני סוגי קישורים באוצריא (0.9.95):

---

1. Deep Links — סכמת otzaria://

זה השינוי המרכזי. אוצריא רשומה כמטפלת ב-URI מיוחד שמאפשר לפתוח כל מסך/ספר מתוך דפדפן, קיצור דרך, אפליקציה אחרת, WhatsApp וכו'.

כתובות עיקריות:

כתובת	תוצאה
otzaria://open/book/<id>	פתיחת ספר לפי מזהה DB
otzaria://open/book/<id>?index=<n>	ספר + קפיצה לשורה n
otzaria://open/book/<id>?index=<n>&mark	ספר + שורה + הדגשת רקע צהוב
otzaria://open/book/<id>?index=<n>&m=<טקסט>	ספר + שורה + הדגשת טקסט ספציפי
otzaria://open/pdf/<id>?index=<n>	פתיחת PDF בעמוד n
otzaria://open/search?q=<טקסט>	חיפוש מיידי (טקסט URL-encoded)
otzaria://open/detection?q=<טקסט>	איתור מקורות
otzaria://open/settings/library	הגדרות ספרייה (וכל תת-הגדרות)

הבדל בין mark ל-m=:

• ?mark — מדגיש את כל רקע השורה בצהוב
• ?m=טקסט — מדגיש מילים ספציפיות בתוך השורה

הערות:

• טקסט עברי ב-q= ו-m= חייב להיות URL-encoded (UTF-8)
• index שלילי/לא מספרי — מתעלם, ייפתח בתחילה
• כתובות case-insensitive (OTZARIA://OPEN/BOOK/1234 תקף)

מה היה קודם: לא היה URI scheme סדור. הקישורים בין ספרים היו פנימיים בלבד (לחיצה על מילה מקושרת בתוך הספר).

---

2. קישורים אישיים בין ספרים — CSV/JSON

זה מאפשר להוסיף קישורים מותאמים אישית שאינם בספרייה הרשמית.

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

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

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

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

תוספת: קישור עם מיקום טקסטואלי כמו "ב עא" (דף ועמוד) נפתר אוטומטית לאינדקס שורה בזמן הייבוא.

---

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

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

[יאיר דניאל]

@Otzaria-Bot לא הרחבת על מבנה הקישורים בין ספרים - שזה הנושא שרציתי לבדוק.
תסביר איך זה היה בנוי קודם - ואיך זה בנוי עכשיו, ואיך אני משנה את הקישורים שכבר יש לי - מצורף קובץ קישור לדוגמא
קובץ שיטות קמאי על בבא מציעא_links.json

כמו"כ לא הסברת כלום על מבנה הקובץ והעמודות בקובץ "סדר הדורות"
תרחיב על שני העניינים האלו - כולל דוגמאות.

[מיכאלוש]

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

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

הוא כתב

@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, עם תיעוד מעולה!