Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
141 changes: 141 additions & 0 deletions BUILD_INSTRUCTIONS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
# הוראות בנייה של Wordiscover VSTO Add-in

## דרישות מקדימות

1. **Windows OS** (Windows 10/11)
2. **Visual Studio 2019 או חדש יותר** עם:
- Office/SharePoint Development workload
- .NET Framework 4.8 SDK
3. **Microsoft Office Word** (2013 ואילך)
4. **התלות**: PanelScrollControl.dll (מצוין בפרויקט)

---

## שיטה 1: בנייה עם Visual Studio (מומלץ)

### צעדים:

1. **שכפל או הורד את הקוד מ-GitHub**:
```bash
git clone [repository-url]
cd wordiscover2
git checkout claude/wordiscover-ui-responsive-011CV2WmMiy3RKBaw1QpY4fE
```

2. **פתח את הפרויקט**:
- פתח את הקובץ `Wordiscover.sln` ב-Visual Studio

3. **בדוק תלויות**:
- וודא ש-PanelScrollControl.dll קיים בנתיב: `..\..\PanelScrollControl-master\PanelScrollControl-master\PanelScrollControl\bin\Release\PanelScrollControl.dll`
- אם הקובץ חסר, תצטרך להוריד אותו מ-[PanelScrollControl GitHub](https://github.com/Cintio/PanelScrollControl)

4. **שנה ל-Release Configuration**:
- בתפריט העליון: `Build > Configuration Manager`
- שנה `Active solution configuration` ל-`Release`

5. **בנה את הפרויקט**:
- `Build > Build Solution` (או Ctrl+Shift+B)

6. **פרסם את ה-Add-in** (ליצירת installer):
- לחץ לחיצה ימנית על הפרויקט `Wordiscover`
- בחר `Publish`
- בחר תיקיית יעד (למשל: `C:\Wordiscover-Release`)
- לחץ `Finish` כדי ליצור את קבצי ההתקנה

7. **מצא את קבצי ההפצה**:
- התיקייה: `Wordiscover\bin\Release\` - מכילה את ה-DLL files
- תיקיית Publish - מכילה את setup.exe והקבצים להתקנה

---

## שיטה 2: בנייה עם MSBuild (שורת פקודה)

### צעדים:

1. **פתח Developer Command Prompt for Visual Studio**:
- חפש בתפריט Start: "Developer Command Prompt for VS 2019" (או הגרסה שלך)

2. **נווט לתיקיית הפרויקט**:
```cmd
cd C:\path\to\wordiscover2
```

3. **שחזר חבילות NuGet** (אם נדרש):
```cmd
nuget restore Wordiscover.sln
```

4. **בנה את הפרויקט**:
```cmd
msbuild Wordiscover.sln /p:Configuration=Release /p:Platform="Any CPU" /v:minimal
```

5. **פרסם** (אופציונלי):
```cmd
msbuild Wordiscover\Wordiscover.csproj /t:Publish /p:Configuration=Release /p:PublishUrl="C:\Wordiscover-Release\"
```

---

## קבצי פלט

לאחר בנייה מוצלחת:

### ✅ קבצי Build רגילים (תיקיית bin\Release):
- `Wordiscover.dll` - ה-Add-in עצמו
- `Wordiscover.dll.manifest` - manifest file
- `Wordiscover.vsto` - הקובץ להתקנה
- קבצי תלות נוספים

### ✅ קבצי Publish (תיקיית publish):
- `setup.exe` - תוכנית ההתקנה
- `Wordiscover.vsto` - קובץ ה-deployment
- תיקייה עם כל הקבצים הנדרשים

---

## התקנה

### מהמשתמש הקצה:

1. העתק את תיקיית ה-publish למחשב היעד
2. הרץ את `setup.exe`
3. עקוב אחר ההוראות על המסך
4. פתח את Word - ה-Add-in אמור להופיע אוטומטית

### התקנה ידנית (למפתחים):

1. העתק את הקבצים מ-`bin\Release` למיקום מתאים
2. רשום את ה-Add-in ב-Registry:
- HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\Wordiscover
- הוסף keys מתאימים (Manifest, LoadBehavior, etc.)

---

## פתרון בעיות

### בעיה: "Cannot find PanelScrollControl.dll"
**פתרון**: הורד את [PanelScrollControl](https://github.com/Cintio/PanelScrollControl), בנה אותו, ושים את הDLL בנתיב הנכון.

### בעיה: "Office Tools not installed"
**פתרון**: התקן את Visual Studio עם Office Development workload.

### בעיה: Build נכשל עם שגיאות
**פתרון**: וודא שיש לך .NET Framework 4.8 SDK מותקן.

---

## שינויים בגרסה האחרונה

✨ **גרסה עם UI משופר** - Branch: `claude/wordiscover-ui-responsive-011CV2WmMiy3RKBaw1QpY4fE`

- הוספו splitters בין כל חלקי הUI
- ניתן להתאים גודל כל סעיף (Find, Replace, Proximity, Results)
- שיפור תצוגת Proximity Search עם יכולת הגדלה
- גמישות מקסימלית בניהול שטח העבודה

---

## תמיכה

לבעיות או שאלות, פתח issue ב-GitHub repository.
98 changes: 98 additions & 0 deletions BUILD_README_HE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# 🔨 בנייה והתקנה של Wordiscover

## 📋 תקציר

הפרויקט עודכן עם UI משופר וגמיש. כדי לבנות את ה-Add-in, תצטרך **מחשב Windows** עם Visual Studio.

---

## 🚀 בנייה מהירה (Windows)

### אופציה 1: שימוש בסקריפט PowerShell (הכי פשוט!)

1. פתח **PowerShell** בתיקיית הפרויקט
2. הרץ:
```powershell
.\Build-Wordiscover.ps1 -Publish
```
3. הקבצים להתקנה יהיו בתיקייה `Build-Output`

### אופציה 2: Visual Studio

1. פתח את `Wordiscover.sln` ב-Visual Studio
2. שנה ל-**Release** configuration
3. **Build → Build Solution** (Ctrl+Shift+B)
4. לחיצה ימנית על הפרויקט → **Publish**
5. בחר תיקיית יעד ולחץ **Finish**

---

## 📦 מה נדרש?

- ✅ Windows 10/11
- ✅ Visual Studio 2019+ עם Office Development
- ✅ .NET Framework 4.8
- ✅ Microsoft Word 2013+

---

## 📖 הוראות מפורטות

ראה את הקובץ **BUILD_INSTRUCTIONS.md** להוראות מלאות בעברית.

---

## ✨ מה השתנה בגרסה החדשה?

### שיפורי UI:

- ✅ **Splitters גמישים** - גרור ושנה גודל של כל חלק
- ✅ **Proximity Search משופר** - יותר מקום לראות פרטים
- ✅ **גמישות מקסימלית** - התאם את ה-workspace לצרכים שלך

### איך זה עובד:

1. פתח את Wordiscover ב-Word
2. תראה **קווים מפרידים** (splitters) בין החלקים
3. **גרור** את הקווים כדי לשנות גודל
4. כל חלק (Find, Replace, Proximity, Results) ניתן להתאמה!

---

## 🆘 עזרה

### בעיות נפוצות:

**שגיאה: "Cannot find PanelScrollControl.dll"**
- הורד מ-[GitHub](https://github.com/Cintio/PanelScrollControl)
- בנה אותו ושים ב-`..\..\PanelScrollControl-master\...`

**שגיאה: "Office Tools not installed"**
- התקן Visual Studio עם Office Development workload

---

## 📝 קבצים חשובים

| קובץ | תיאור |
|------|--------|
| `Build-Wordiscover.ps1` | סקריפט בנייה אוטומטי |
| `BUILD_INSTRUCTIONS.md` | הוראות מפורטות |
| `Wordiscover.sln` | קובץ פתרון Visual Studio |

---

## 💡 טיפ

אם אתה רוצה רק לבנות בלי installer:
```powershell
.\Build-Wordiscover.ps1
```

הקבצים יהיו ב: `Wordiscover\bin\Release\`

---

**Branch:** `claude/wordiscover-ui-responsive-011CV2WmMiy3RKBaw1QpY4fE`

בהצלחה! 🎉
Loading