מסמך זה מסביר איך להתקין את Vitruvius במחשב שלכם. לכל שאלה או תקלה — צרו קשר ב-vitruviusecosystem@gmail.com.

1סגרו את Revit

חשוב לסגור את Revit 2024 אם הוא פתוח. אחרת ה-installer ינסה לכתוב לתיקיית האדינים בזמן ש-Revit נועל אותה, ויקבל שגיאה.

2הריצו את ה-installer

לחיצה כפולה על Vitruvius-Setup-0.3.0.exe.

צפויה התראה של Windows Defender SmartScreen

Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognized app from starting.

זה צפוי — ה-installer עדיין אינו חתום בחתימה דיגיטלית בגרסת הבטא.

לחצו "More info" ← "Run anyway".

3בחרו מצב התקנה

יופיע דיאלוג של Windows שמציע שתי אופציות:

אופציה	משמעות
Install for me only	התקנה למשתמש הנוכחי בלבד. אינו דורש סיסמת אדמין.
Install for all users	התקנה לכל המשתמשים במחשב. דורש סיסמת אדמין.

אם אתם המשתמש היחיד במחשב — בחרו "for me only" (פשוט יותר, ברירת המחדל). אם המחשב משותף (משרד עם כמה אדריכלים על אותו מחשב) — בחרו "for all users".

4אישור התקנה

לחצו Next ← Install ← Finish. ההתקנה מתבצעת אוטומטית:

• מעתיקה את ה-addin של Vitruvius לתיקיית Revit
• מתקינה את הפונט Vitruvius Hebrew Visual ב-Windows
• רושמת את ה-uninstaller בלוח הבקרה

5פתחו Revit 2024

יופיע דיאלוג של Revit:

Security - Unsigned Add-In

זה צפוי — אותה סיבה כמו השלבים הקודמים (אין חתימה דיגיטלית עדיין).

לחצו "Always Load" (לא רק "Load Once"). אחרת כל פעם שתפעילו את Revit הדיאלוג יחזור.

6הזינו מפתח הפעלה ופרטים בסיסיים

בלשונית Vitruvius בריבון, לחצו על כפתור כלשהו (למשל "תקן טקסט"). יופיע דיאלוג "ברוך הבא ל-Vitruvius" עם 4 שדות למילוי חד-פעמי:

שדה	מה למלא
מפתח הפעלה	המפתח האישי שקיבלתם מאיתנו, בפורמט VIT-XXXX-XXXX-XXXX
שם המשרד	למשל: "לוטן דייטש אדריכלים"
השם שלך	שם פרטי + משפחה
מייל אישי במשרד	המייל שלכם בעבודה

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

חשוב: המפתח נקשר למחשב הזה בלבד. אסור להעביר אותו לאדריכל אחר. אם תצטרכו להתקין על מחשב נוסף (למשל החלפת laptop) — פנו אלינו ונאפס לכם.

7בדקו שהלשונית הופיעה

ב-Revit 2024 תופיע לשונית חדשה Vitruvius עם שני פאנלים:

Vitruvius          (פאנל ראשון)
  ▸ EN/עב          — מעבר בין עברית לאנגלית
  ▸ אודות          — גרסה ופרטי קשר

עריכת DWG          (פאנל שני)
  ▸ תקן טקסט        — תיקון אוטומטי של ג'יבריש בעברית
  ▸ החל CTB מקורי   — הצגת קישור ה-DWG עם CTB של היועץ
  ▸ עריכת שכבות     — לחיצה על קו פותחת עריכה של ה-layer
  ▸ עורך Xref       — הצגת/הסתרת Xref-ים מקוננים
  ▸ שחזר CTB        — ביטול החלת CTB
  ▸ חזור למקור      — ביטול תיקון טקסט

אם הלשונית לא הופיעה — בדקו את הלוג %APPDATA%\Vitruvius\diagnostic.log ושלחו אותו אלינו (אם הוא לא קיים, ה-addin לא נטען כלל).

---

איך להשתמש — Quickstart

תיקון טקסט עברי שבור בקישור DWG

1. פתחו מודל Revit עם DWG link שמופיע עם עברית הפוכה / ג'יבריש.
2. בלשונית Vitruvius ← "תקן טקסט".
3. תופיע רשימת הקישורים שזוהו (כולל Xref-ים מקוננים).
4. ✓ ליד הקישורים לתיקון (ברירת המחדל — כולם) ← "תקן".
5. תוך 3–5 שניות הקישורים מתעדכנים והעברית מופיעה תקנית.
6. אם משהו לא נראה טוב — "חזור למקור" מבטל את התיקון.

החלת CTB של היועץ

1. "החל CTB מקורי".
2. הקישור נבחר אוטומטית (אם יש רק אחד). בחרו קובץ CTB מהרשימה (Vitruvius מאתר אוטומטית CTBs בתיקיית הקישור).
3. "החל". תצוגת הקישור ב-Revit נראית כמו שיודפס בפועל.

עריכת שכבה ספציפית בקישור

1. "עריכת שכבות" ← לחיצה על קו כלשהו בקישור.
2. דיאלוג נפתח עם שם השכבה (גם אם היא בתוך Xref מקונן).
3. שינוי הסתרה / צבע / עובי קו ← "החל".

הצגה/הסתרה של Xref מקונן

1. "עורך Xref" ← לחיצה על הקישור.
2. רשימה של ה-Xref-ים בו. סימון checkbox = מוצג; ביטול = מוסתר.
3. "החל".

---

פרטיות

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

לכיבוי הטלמטריה — ערכו את %APPDATA%\Vitruvius\telemetry.config והחליפו "enabled": true ל-"enabled": false. ההפסקה מיידית בהפעלה הבאה של Revit.

הסרת ההתקנה

לוח הבקרה ← תוכניות ← Vitruvius ← Uninstall. ה-uninstaller מסיר את כל קבצי ה-addin, הפונט Vitruvius Hebrew Visual, ואת הרישום מ-Registry.

לא נמחק:

• קובץ shxfontmap.txt של Revit (נשאר עם המיפויים — לא רוצים שההסרה תשבור קישורים בכל המודלים)
• תיקיית הנתונים %APPDATA%\Vitruvius\ (לוגים + state + license.dat). למחיקה מלאה — מחקו אותה ידנית.

---

בעיות נפוצות

"ה-installer לא רץ — Windows חוסם"

קליק ימני על הקובץ ← Properties ← תחתית הטאב General ← "Unblock" ← Apply.

"התקנתי אבל אין לשונית Vitruvius ב-Revit"

ודאו שבשלב 5 בחרתם "Always Load" ולא "Do Not Load". אם בחרתם בטעות — הסירו את ההתקנה והתקינו מחדש.

"הקלדתי את המפתח אבל מקבל 'מפתח לא חוקי'"

• ודאו שכתבתם בפורמט VIT-XXXX-XXXX-XXXX עם המקפים.
• אותיות גדולות. רווחים מהדבקה — Vitruvius מנקה אוטומטית.
• אם עדיין לא עובד — צלמו את הדיאלוג ושלחו לנו.

"הרצתי תיקון, אבל הקישור עדיין נראה ג'יבריש"

ב-Revit: Manage Links ← Reload על הקישור הספציפי. אם זה לא עוזר — שלחו לנו את %APPDATA%\Vitruvius\diagnostic.log.

"התיקון פגע בטקסט אנגלי בקובץ"

זה לא אמור לקרות. אם זה כן קרה — שלחו את ה-DWG. זה bug חשוב.

---

תודה

אתם מסייעים לאמת את הכלי. אחרי 2-3 שבועות שימוש נשלח לכם שאלון פידבק קצר — תענו במה שתרצו, לא חייבים על הכל.