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

יש לכם מסד ספרים שלם בפורמט של אוצריא (קובץ .db), ולא קבצים בודדים? ראו מסדי ספרים אישיים.

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

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

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 של אובייקטים; כל אובייקט הוא קישור אחד. השדות:

דוגמה לקובץ חידושי הרב_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 שמונח לצד קובץ הספר:

• <שם הקובץ>.כותרות.csv — כותרות לספר אחד (אותו שם בסיס כמו קובץ הספר).
• כותרות.csv — קובץ אחד לכל התיקייה; בו נדרשת גם עמודת ספר.

כותרת שאין לה שורה ואין לה טקסט היא כותרת־אב — מקומה נגזר מהכותרות שתחתיה. כותרות נתמכות בספרי טקסט בלבד.

מבנה,רמה,כותרת,שורה,טקסט
סימנים,1,סימן א,1,
סימנים,2,סעיף א,3,
סימנים,2,סעיף ב,,ואם לא עשה כן

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

גרסאות: כמה קבצים כספר אחד

אם יש לכם כמה נוסחים של אותו ספר — מהדורות שונות, או קובץ טקסט וקובץ PDF — אפשר לאחד אותם לקבוצת גרסאות: הספר הראשי מופיע בעץ הספרייה, והשאר נפתחים ממנו ולא מלכלכים את העץ.

קובץ גרסאות.csv בתיקיית הספרים:

ראשי,גרסה,שם,הערות,עדיפות
שו"ת מהר"ם.txt,שו"ת מהר"ם - דפוס ראשון.txt,דפוס ראשון,,1
שו"ת מהר"ם.txt,שו"ת מהר"ם - צילום.pdf,צילום הדפוס,,2

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

חשוב לדעת

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

דפים קשורים

• מסדי ספרים אישיים
• הספרייה
• הגדרות