# מדריך התקנה והפעלה — סוגריים ל־Microsoft Word

**ברוכים הבאים לסוגריים!**

סוגריים הוא תוסף ל־Microsoft Word שמזהה הפניות למקורות יהודיים בתוך המסמך ומחליף אותן בטקסט המקור עצמו. לדוגמה, הפניה כמו `{דברים י,יב}` יכולה להפוך אוטומטית לטקסט הפסוק המתאים.

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

## שלב 1 — הכנת קובץ ההתקנה

קיבלתם קישור להתקנה או קובץ בשם `manifest.xml` מהמוכר.

אם קיבלתם קובץ:
1. הורידו אותו למחשב.
2. שמרו אותו במקום שקל למצוא, למשל בשולחן העבודה.
3. ודאו שאתם יודעים היכן שמרתם אותו — תצטרכו לבחור בו במהלך ההתקנה.

אם קיבלתם קישור בלבד, פעלו לפי ההנחיות שקיבלתם מהמוכר.

**שימו לב:** אם התוסף כבר זמין בחנות Microsoft AppSource, אפשר להתקין אותו ישירות דרך Word, בלי להעלות קובץ ידנית. במקרה כזה, חפשו את השם „סוגריים” בחנות התוספים.

## שלב 2 — פתיחת Word

פתחו את Microsoft Word ופתחו מסמך קיים או צרו מסמך חדש.

אפשר להשתמש בתוסף בגרסאות Word הנתמכות. מיקום האפשרויות עשוי להשתנות מעט בין Word למחשב לבין Word בדפדפן.

## שלב 3 — התקנת התוסף

אם קיבלתם קובץ `manifest.xml`, בצעו את הפעולות הבאות:

1. עברו ללשונית **הוספה (Insert)**.
2. בחרו **תוספים (Add-ins)** או **התוספים שלי (My Add-ins)**.
3. אם האפשרות זמינה, לחצו על **העלאת התוסף שלי (Upload My Add-in)**.
4. בחרו את קובץ `manifest.xml` ששמרתם בשלב הראשון.
5. אשרו את ההתקנה, אם Word מבקש זאת.

לאחר ההתקנה, התוסף אמור להופיע ברצועת הכלים של Word.

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

## שלב 4 — פתיחת סוגריים

חפשו ברצועת הכלים את הכפתור **Cite Sources** ולחצו עליו.

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

## שלב 5 — הפעלת הרישיון

**חיפוש מקורות עובד מיד, בלי קוד הפעלה** — אפשר לחפש מקור לפי שם או בתוך הטקסט ולפתוח אותו לקריאה
ב-Sefaria כבר בשלב הזה. קוד הפעלה נדרש רק להכנסת מקורות למסמך, זיהוי אוטומטי של הפניות, ותכונות AI
(גרסת פלוס).

אם מופיע מסך הפעלת רישיון בפתיחה הראשונה:

1. העתיקו את קוד ההפעלה שקיבלתם מהמוכר.
2. הדביקו אותו בשדה המתאים.
3. לחצו על **הפעל רישיון**.
4. המתינו לאישור שההפעלה הצליחה.

יש להשלים את השלב הזה רק אם התוסף מבקש זאת. שמרו את קוד ההפעלה במקום בטוח.

## שלב 6 — חיבור ליכולות AI (אופציונלי)

**אפשר להשתמש בסוגריים גם בלי לחבר שירות AI.**

חיפוש המקורות והחלפת ההפניות פועלים ללא מפתח AI, בהתאם לתנאי הרישיון שלכם. אם תרצו להשתמש בתכונות מתקדמות, כגון סיכום מקורות או סיוע בפענוח הפניות עמומות, תוכלו לחבר מפתח API משלכם מספק נתמך, למשל Gemini, Anthropic או OpenAI.

כדי להגדיר זאת:

1. פתחו את חלונית סוגריים.
2. היכנסו ל־**הגדרות**.
3. בחרו ספק ומודל נתמכים, בהתאם לאפשרויות המוצגות.
4. הזינו את מפתח ה־API ופעלו לפי הוראות החיבור.

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

## שלב 7 — בדיקת התקינות

כעת נבדוק שהכול עובד.

1. במסמך Word, הקלידו את ההפניה הבאה:

   `{דברים י,יב}`

2. פתחו את חלונית סוגריים.
3. לחצו על **סרוק**.
4. המתינו לסיום הסריקה ובדקו את התוצאה.

אם התוסף מזהה את ההפניה ומחליף אותה בטקסט הפסוק המתאים, ההתקנה והפעולה הבסיסית הצליחו.

**זהו — אפשר להתחיל לעבוד עם סוגריים!**

## שלב 8 — הסרת התוסף

אם תרצו להסיר את התוסף בהמשך, עיינו בקובץ **`uninstall-guide.md`** המצורף לחבילת ההתקנה. הוא כולל הוראות להסרה.

## נתקלתם בבעיה?

אם ההתקנה לא הצליחה, הכפתור אינו מופיע או שההפניה לא הוחלפה:

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

כדי שנוכל לעזור במהירות, כדאי לצרף צילום מסך של ההודעה שמופיעה ולציין באיזה שלב נתקלתם בבעיה.