User Personal Books

מדריך למשתמש: הוספת ספרים אישיים

אפשר להוסיף לאוצריא ספרים משלכם — קובצי TXT, Word (DOCX) ו־PDF — והם ישתלבו בספרייה, בחיפוש ובכל שאר הכלים.

במחשב: תיקיות מותאמות אישית

הגדרות ← ספריה ← תיקיות מותאמות אישית:

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

מצב אחסון לכל תיקייה

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

תפריט התיקייה (⋮): פתח תיקייה, העתק נתיב, הסר תיקייה (הספרים מוסרים מהתוכנה — הקבצים בדיסק לא נמחקים).

בנייד: "הספרים שלי"

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

טיפים לקבצי טקסט

• קובצי TXT צריכים להיות בקידוד UTF-8 (ברירת המחדל ברוב העורכים כיום).
• כותרות בפורמט Markdown‏ (#, ##...) או HTML הופכות אוטומטית לתוכן עניינים מלא של הספר.
• הספרים האישיים נכנסים לאינדקס החיפוש ככל ספר אחר.
• ל־PDF סרוק בלי שכבת טקסט אפשר להניח קובץ .txt באותו שם לצידו (תוצר OCR) — והחיפוש יעבוד גם בו.

ייבוא דורות וקישורים

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

מהם "קישורים"?

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

• בספר האישי — לצד כל שורה יופיעו המפרשים/המקורות המקושרים אליה, בדיוק כמו בספר רשמי.
• בכיוון ההפוך — אם הספר האישי שלכם מפרש ספר רשמי (למשל חידושים על מסכת), הוא יופיע כמפרש גם בתוך הספר הרשמי, לצד שאר המפרשים.

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

סוג (בקובץ)	משמעות	היכן מוצג
פירוש	פירוש/מפרש על המקור	פאנל המפרשים
תרגום	תרגום של המקור	פאנל המפרשים
הפניה	הפניה למקום אחר	פאנל הקישורים
מקור	ציון המקור של הקטע	פאנל הקישורים
אחר	כל השאר	פאנל הקישורים

כלי עזר ליצירת הקישורים: "מקשר הערות אוטומטי" (Link-Notes)

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

מה הוא עושה: אתם מספקים לו שני קבצי טקסט — קובץ הספר וקובץ ההערות — כשבשניהם אותם סימני הפניה (למשל <sup>1</sup> או (א), (ב)). הכלי מזהה אוטומטית איזו הערה שייכת לאיזו שורה בספר, ומייצר קובץ JSON של קישורים מוכן לייבוא לאוצריא.

שלבי העבודה בכלי:

1. הכינו שני קובצי טקסט — ספר והערות — עם סימני הפניה תואמים.
2. טענו את שני הקבצים בכלי.
3. הכלי מזהה אוטומטית את ההתאמות. סימני ההפניה יכולים להיות תגיות HTML (כגון <sup>1</sup>) או ביטוי רגולרי (regex) לסימונים כמו (א).
4. עברו על התוצאה בעורך המובנה — אפשר לתקן התאמות, לקשר ידנית, להגדיר טווח של כמה שורות רצופות, ולעגן קישור למילה ספציפית.
5. בחרו לכל הערה את סוג הקישור והורידו את קובץ ה־JSON.

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

איך נראה קובץ הקישורים? (פורמט אוצריא)

קובץ קישורים בפורמט אוצריא הוא מערך JSON של אובייקטים; כל אובייקט הוא קישור אחד. השדות:

שדה	חובה?	משמעות
line_index_1	✅	מספר השורה בספר המקור (הספר האישי), החל מ־1
line_index_2	✅	מספר השורה בספר היעד, החל מ־1
path_2	✅	שם ספר היעד (או נתיב הקובץ שלו — הסיומת מתעלמים ממנה)
heRef_2	✖	הכתובת העברית של היעד, לתצוגה בלבד (למשל "בראשית א׳, א׳")
Conection Type	✖	סוג הקישור (ראו הטבלה למעלה). ריק = פירוש. שימו לב לאיות Conection בנו״ן אחת — כך בדיוק

דוגמה לקובץ חידושי הרב_links.json:

[
  {
    "line_index_1": 12,
    "line_index_2": 3,
    "path_2": "בראשית",
    "heRef_2": "בראשית א׳, א׳",
    "Conection Type": "פירוש"
  },
  {
    "line_index_1": 40,
    "line_index_2": 128,
    "path_2": "תלמוד בבלי ברכות",
    "heRef_2": "ברכות ב׳ ע״א",
    "Conection Type": "הפניה"
  }
]

בדוגמה: שורה 12 בספר האישי מפרשת את שורה 3 בבראשית (תופיע כמפרש על בראשית א׳, א׳), ושורה 40 מפנה לברכות ב׳ ע״א.

ייבוא הקבצים לאוצריא

הגדרות ← ספריה ← דורות וקישורים לספרים אישיים ← "ייבוא דורות וקישורים", ובחרו קבצים:

קובץ	תוכן
דורות.csv	שיוך ספרים לתקופה — משפיע על מיון החיפוש והקיבוץ. עמודות: ספר, דור (חובה), ו־מחבר, קטגוריה (רשות). הדור חייב להיות אחד מ: תורה שבכתב, חז"ל, ראשונים, אחרונים, מחברי זמננו
<שם הספר>_links.json	קובץ הקישורים בפורמט אוצריא שתואר למעלה — זה הקובץ שמייצר כלי מקשר ההערות
<שם הספר>.links.csv	חלופת CSV לבניית קישורים ביד. עמודות: מקור (מספר שורה), ספר_יעד, סוג (חובה), ו־מיקום_יעד, יעד_אישי ועוד (רשות)

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

חשוב לדעת

• הספרים האישיים נשמרים במסד נתונים נפרד — הם שורדים עדכוני ספרייה ולא נדרסים לעולם.
• ספר אישי ששמו זהה לספר רשמי — שניהם יופיעו, כל אחד עם הזהות שלו.

דפים קשורים

• הספרייה
• הגדרות