מאגר ספרים מותאמים לתוכנת אוצריא
מאגר זה מכיל מסד ספרים _DB) וקבצי TXT שעברו התאמה טכנית לשימוש בתוכנת אוצריא.
מכיוון שהמאגר מכיל קבצים גדולים, הורדה רגילה דרך כפתור ה-"Download ZIP" הירוק של GitHub עלולה לשבש את הקבצים.
- ניתן להתקינו באוצריא - דרך חנות התוספים, למעבר - לחצו כאן
- קוד המקור של התוסף, הסבר על אופן פעולתו ודיווח על תקלות - במאגר otzaria-github-downloader-plugin
הבהרה חשובה: הקבצים מיועדים לשימוש פרטי בלבד ואינם חלק מההפצה הרשמית של התוכנה. חלק מהתכנים הכלולים במאגר כפופים לזכויות יוצרים, ולכן אסורים בהפצה ציבורית, או שימוש מסחרי.
מטרת המאגר
-
ריכוז וניהול קבצים מותאמים בפורמט אחיד
-
שימוש אישי בסביבת אוצריא בלבד
-
גיבוי וארגון תכנים, לצורך שימוש פרטי
הבהרה משפטית
העלאת הקבצים למאגר זה אינה מהווה ויתור על זכויות יוצרים ואינה מעניקה רישיון שימוש מעבר לשימוש פרטי אישי, בהתאם לדין.
האחריות לשימוש בתכנים חלה על המשתמש בלבד.
אין המערכת אחראית על מקור הקבצים או על תוכנם.
אוצריא מאפשרת "חיפוש חכם" לפי עניין, אך הוקטורים הרשמיים שלה מכסים רק את הספרייה הרשמית. במאגר זה מתפרסמים וקטורים משלימים (סגמנט .oxv) לספרי המסד האישי, כדי שגם הם יימצאו בחיפוש לפי משמעות.
- קרדיט: החיפוש מבוסס על מודל ועל פורמט הוקטורים של פרויקט אוצריא, ועל הסקריפט
otzaria_personal_vectors.pyשל קרית חנה. פרסום הוקטורים אושר ע"י בעלי אוצריא. קובצי המודל עצמו אינם מפורסמים כאן. - איפה: בדף ה-Releases, תג
vectors-v<N>(המספר הוא גרסת המסד האישי). הקבצים:otzarya-books-vectors-….oxv.zst(כ-1.1GB),vectors-manifest.jsonו-vectors-manifest.json.sig. - תנאים להתאמה: גרסת המסד האישי המצורף חייבת להיות זהה לגרסה שבמניפסט (השדה
db.version), כי הוקטורים קשורים למספרי השורות בספרים. הוקטורים חייבים גם להתאים לסט הוקטורים הרשמי המותקן אצלך (אותו מודל), אחרת ההתקנה תסרב. - התקנה (זמנית, עד שיהיה נתיב רשמי באוצריא):
- סגור את אוצריא.
- הורד את שלושת הקבצים לתיקייה ריקה אחת. אם ההורדה נפסקת באמצע, נסה שוב: השרת אינו תומך בהמשך הורדה.
- הרץ מתוך תיקיית המאגר (בדיקה יבשה קודם, עם
--dry-run):אם גרסת המסד לא נקראת אוטומטית, הוסףpython -X utf8 .github/scripts/vectors_ci.py install --manifest <תיקייה>/vectors-manifest.json --files-dir <תיקייה> --vectors-dir "C:\ProgramData\otzaria\vectors" --dry-run--db-version <N>. כשהבדיקה היבשה תקינה, הרץ שוב בלי--dry-run. - פתח את אוצריא וחפש ב"חיפוש חכם (ניסיוני)". תוצאות מהוקטורים האלה מסומנות "התאמה לפי עניין".
- שחזור: ההתקנה שומרת את הדור הקודם בקובץ
PREVIOUSבתיקיית הוקטורים. - עדכון: בכל גרסת מסד חדשה יש לבנות את הוקטורים מחדש, ולכן יש להתקין סגמנט חדש.
המאגר פתוח לקבלת הצעות להוספת ספרים. אין צורך בידע מוקדם בגיטאב – פשוט עקבו אחרי השלבים הבאים.
- שלב 1: יצירת עותק אישי (Fork)
כנסו לעמוד הראשי של המאגר
בפינה הימנית למעלה לחצו על הכפתור Fork
יווצר עבורכם עותק אישי של המאגרGitHub (בחשבון שלכם)
-
שימו לב: אתם עובדים רק על העותק שלכם, לא על המאגר הראשי.
-
שלב 2: הוספת הספרים
בעותק (Fork) שלכם:
כנסו לתיקייה:
incoming/
- הוסיפו קבצים חדשים - או קבצים שתוקנו על ידכם:
קבצי TXT בלבד (כרגע)
שמרו על שמות קבצים ברורים ומסודרים
-
חשוב מאוד תוספות מתקבלות אך ורק בתיקייה incoming שינויים מחוץ לתיקייה זו לא יאושרו.
-
שלב 3: שליחת בקשה להוספה (Pull Request)
לאחר שהוספתם את הקבצים:
לחצו על הכפתור Pull Request
אשרו את הבקשה עם ההודעה:
"הוספת ספרים חדשים לתיקיית נכנסת"
שלחו את הבקשה
🔹 מה קורה עכשיו?
הקבצים לא נכנסים אוטומטית למאגר
בעל המאגר בודק את הבקשה
אם הכל תקין:
הקבצים יאושרו
הם יועברו לתיקייה המתאימה
- מה לא יאושר?
בקשות שיכללו אחד מהבאים יידחו:
מחיקה של קבצים קיימים
קבצים שאינם תואמים למדיניות המאגר