Home

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

אוצריא היא אפליקציית קוד למחצה־פתוח לספרייה התורנית — ‏Flutter/Dart, רב־פלטפורמית (Windows‏, Linux‏, Android‏, iOS‏, macOS), עם מנוע חיפוש מהיר ב־Rust‏ (tantivy) ומסד ספרים SQLite‏ (~7000 ספרים).

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

📖 מדריך למשתמש

• התחלת העבודה — התקנה, הפעלה ראשונה, המסכים הראשיים
• הספרייה — עיון, חיפוש ספר, דף יומי, התקנת הספרייה
• קריאת ספר — תצוגות, מפרשים, ניקוד, תפריט ההקשר
• קריאת PDF — תצוגת ספר, חלוניות, מעבר צילום↔טקסט
• חיפוש — מצבי חיפוש, אפשרויות, סינון
• איתור מקורות — קפיצה למראה מקום
• טאבים ושולחנות עבודה
• סימניות, היסטוריה והערות
• הוספת ספרים אישיים — תיקיות אישיות, ייבוא דורות וקישורים
• הגדרות — כל שבע הלשוניות
• גיבוי ושחזור
• עדכונים — עדכון התוכנה ועדכון הספרייה
• תוספים — התקנה, הרשאות, ניהול
• כלים — מילונים, גימטריה, לוח שנה, שמור וזכור ועוד
• קישורי עומק — קישורי otzaria:// לספר, למקטע, לחיפוש ולכלים

🛠️ תיעוד למפתחים

יסודות

• ארכיטקטורה — עקרונות, מבנה תיקיות, BLoC/Repository, מקורות אמת, RTL, ‏deep links
• רצף האתחול — מ־main() ועד חשיפת החלון: splash, אתחול מדורג, providers
• הניווט והמסך הראשי — סרגל הניווט, MainWindowScreen, שורת הכותרת
• קישורי עומק — סכמת otzaria://: כתובות, ‏ExternalUriRouter, ‏single-instance
• מדריך פיתוח — סביבה, כללי קוד, בדיקות, בנייה

נתונים וספרייה

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

קריאה

• קורא הטקסט — ה־BLoC, טעינה עצלה, מצבי תצוגה, צורת הדף, ניקוד ופיסוק
• מפרשים וקישורים — קיבוץ מפרשים, פאנל המפרשים, קישורים הפוכים ו־inline
• קורא ה-PDF — פריסה כפולה, יציבות פריסה, דפדוף מונפש, המרת עמודים
• פתיחת ספרים וניווט — ‏openBook, זהות ספר, פתיחת בבלי כ־PDF, מיפוי PDF↔טקסט
• הדפסה וייצוא — הדפסה, רסטריזציית RTL, ייצוא ל־Word
• טאבים ושולחנות עבודה — סוגי טאבים, מיחזור חכם, side-by-side, שולחנות

חיפוש

• חיפוש מלא־טקסט — מנוע tantivy, שלושת המצבים, facets, תחביר @, גימטריה
• אינדוקס — בניית האינדקס, זהות ספרים, תחזוקה
• איתור מקורות — קפיצה למראה מקום

תוכן אישי ומערכת

• סימניות, היסטוריה והערות
• הגדרות — המנוע, הגדרות פר־ספר, מצב מוגן, מיקום הספרייה
• גיבוי ושחזור — מחסן blobs, רוטציית GFS, ארכיון מתגלגל
• מערכת התוספים — מניפסט, גשר RPC, הרשאות, שרת קבצים מקומי
• פיתוח תוספים — מדריך לכותבי תוספים: SDK, מצב פיתוח, אריזה ופרסום
• כלים מובנים — מילון, לוח שנה, גימטריה, שמור וזכור ועוד
• עדכון האפליקציה

עיצוב ו־UI

• מערכת העיצוב — ‏ColorScheme, טוקנים, גופנים
• רכיבי UI משותפים — ‏RtlTextField, ‏RtlIcon, ‏ActionButton, דיאלוגים, UiSnack
• קיצורי מקלדת

ריפואים קשורים

פירוט מלא על כל ריפו והקשרים ביניהם: הריפואים של אוצריא.

ריפו	תפקיד
Otzaria/otzaria	האפליקציה
Otzaria/SeforimLibrary	בניית מסד הספרים והפצת עדכוני דלתא
Otzaria/otzaria_library_updater	חבילת Dart לצריכת עדכוני הספרייה (דלתא/מלא)
Otzaria/otzaria_search_engine	מנוע החיפוש (Rust/tantivy)
Otzaria/otzaria-plugin-validator	GitHub Action לאימות ופרסום תוספים לחנות

חסר דף? רוצים להוסיף נושא?

הוויקי הוא מסמך חי. אם חסר כאן נושא, או שיש דף שכדאי להרחיב — פתחו issue חדש בגיטהאב ותארו איזה דף או תוכן חסר. נשמח להוסיף.

---

הוויקי נכתב על סמך קוד המקור נכון לגרסה 0.9.95. אם מצאתם אי־דיוק — עדכנו את הדף או פתחו issue.