פתרון בעיות וקבלת עזרה ב-Prism

Prism היא סביבת עבודה שיתופית ל-LaTeX עם בינה מלאכותית מובנית, המבוססת על מודלי חזית ונועדה לעזור לחוקרים לחשוב, לכתוב ולשפר את עבודתם מהר יותר. היכולות החכמות המובנות בה מאיצות את העבודה המדעית ומאפשרות להעמיק בה.

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

איך לגשת ל-Prism

Prism זמין בכתובת prism.openai.com לכל המשתמשים בעלי חשבון ChatGPT במסלול Free, Go, Plus או Pro, שאינם חברים ומעולם לא היו חברים ב-workspace מסוג Business או Enterprise. בעתיד הקרוב נרחיב את הגישה גם ל-Business, ל-Enterprise ול-Edu.

1. שימוש ביכולות החכמות המובנות של Prism

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

1. יצירת קטעי קוד LaTeX: בקשו מ-Prism ליצור רכיבי LaTeX נפוצים, למשל ״צור טבלה בגודל 4×4״ או ״הוסף איור עם כיתוב״. Prism יחזיר קוד LaTeX מוכן לשימוש ויציע אפשרויות לשמירה ולביטול השינוי, כך שתוכלו לשלב אותו ישירות בפרויקט.

2. אבחון בעיות קומפילציה: אם הקומפילציה של המסמך נכשלת, תארו את הבעיה בחלונית (למשל, ״הקומפילציה של המסמך שלי נכשלת״). Prism ישאל שאלות הבהרה ויעזור לכם לבדוק גורמים אפשריים, כמו פקודות חסרות או הפניות שלא ניתן לפתור.

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

4. הגהה: בקשו מ-Prism לבצע הגהה של קטע, להדגיש שגיאות או פערים לוגיים ולהציע דרכים לשפר את בהירותו. אפשר להיעזר במיומנויות, כמו סקירת מאמר, לקבלת משוב עריכתי ועובדתי.

5. חיפוש בספרות המחקר: הוסף ביבליוגרפיה למאמר שלי, והצע גם מחקרים קשורים שאולי פספסתי.

2. אבחון שגיאות קומפילציה

אם לא ניתן לבצע קומפילציה של מסמך ה-LaTeX שלכם, נסו את השלבים הבאים:

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

2. עיינו ביומן הקומפילציה: כשהקומפילציה נכשלת, חלונית התצוגה המקדימה של ה-PDF מציגה יומן קומפילציה. התמקדו בהודעת השגיאה הראשונה (למשל, פקודת \end{document} חסרה), שכן שגיאות מאוחרות יותר נובעות לעיתים קרובות ממנה. שתפו את ההודעה הזו עם Prism כדי לקבל הנחיות מדויקות יותר.

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

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

3. המלצות למניעת בעיות

1. הישארו מחוברים לחשבון: עבדו תמיד כשאתם מחוברים לחשבון כדי לוודא שהשינויים שלכם נשמרים וזמינים גם בהתחברויות הבאות.

2. השתמשו בחבילות נתמכות: Prism תומך בחבילות LaTeX נפוצות רבות. חבילות נדירות, מיושנות או לא מתוחזקות עלולות לגרום לשגיאות קומפילציה לא צפויות.

3. ערכו בהדרגה: בצעו שינויים קטנים וקומפילציה לעיתים קרובות. כך קל יותר לזהות איזו עריכה גרמה לשגיאה ולתקן אותה במהירות.

העברת פרויקטי LaTeX ל-Prism

מדריך זה מסביר כיצד להעביר פרויקטי LaTeX קיימים מ-Overleaf או מהמחשב שלכם ל-Prism. ייבוא הפרויקטים מרכז הכול במקום אחד ומאפשר לכם להמשיך לעבוד בלי ליצור מחדש את הקבצים באופן ידני.

ייבוא פרויקטים מ-Overleaf

כדי להעביר פרויקט מ-Overleaf ל-Prism, הורידו תחילה את קובצי הפרויקט מ-Overleaf ואז העלו אותם ל-Prism.

הורדת פרויקט יחיד

1. פתחו את לוח ניהול הפרויקטים שלכם ב-Overleaf.

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

3. לחצו על סמל ההורדה בשורה שבה מופיע שם הפרויקט.

4. Overleaf יוריד את הפרויקט כולו למחשב שלכם כקובץ .zip.

הורדת כמה פרויקטים

1. פתחו את רשימת הפרויקטים שלכם ב-Overleaf.

2. בחרו את הפרויקטים באמצעות תיבת הסימון בתחילת כל שורה.

1. כדי לבחור הכול, לחצו על תיבת הסימון הראשונה ברשימה.

2. לאחר הבחירה, לחצו על סמל ההורדה בפינה השמאלית העליונה של רשימת הפרויקטים.

הפרויקטים שנבחרו יירדו כקובצי .zip.

ייבוא פרויקטים ל-Prism

אפשר לייבא פרויקטים ל-Prism בשלוש דרכים: העלאת תיקייה, העלאת ארכיון .zip או גרירה ושחרור של קבצים בתצוגת כל הפרויקטים.


כדי לייבא פרויקט מתפריט הייבוא:

1. פתחו את Prism ועברו אל ייבוא.

2. לחצו על החץ שליד ייבוא כדי לבחור את סוג הייבוא.

בחרו באחת מהאפשרויות הבאות:

1. פתחו את Prism ועברו לאפשרות ייבוא.

2. לחצו על החץ שליד ייבוא כדי לבחור את סוג הייבוא.

3. בחרו באחת מהאפשרויות הבאות:

ייבוא קובץ .zip: בחרו מהמחשב את ארכיון הפרויקט שהורדתם. Prism יחלץ ויטען את הפרויקט באופן אוטומטי.


ייבוא תיקייה: בחרו את תיקיית הפרויקט מהמחשב. Prism ייבא את קובצי ה-.tex, קובצי הביבליוגרפיה, התמונות ושאר משאבי הפרויקט.


כדי לייבא באמצעות גרירה ושחרור: בתצוגת כל הפרויקטים, גררו ושחררו תיקיית פרויקט או קובץ .zip לתוך Prism. Prism ייצור פרויקט חדש וייבא את הקבצים עבורכם באופן אוטומטי.

לאחר סיום ההעלאה, Prism יפתח את הפרויקט המלא כדי שתוכלו להתחיל לערוך ולבצע קומפילציה.

שאלות נפוצות נוספות

חשבון, אבטחה וחיוב

ש: איפה אפשר למצוא את מדיניות הפרטיות שלכם? ת: מדיניות הפרטיות של Prism נמצאת כאן.

ש: האם אתם מאמנים את המודלים על הנתונים שלי? ת: למשתמשים יש שליטה מלאה בשאלה אם הנתונים שלהם ישמשו לשיפור המודלים שלנו, בהתאם למדיניות הפרטיות שלנו.

ש: האם אתם משתמשים ב״אפס שמירת נתונים (ZDR)״? אילו נתונים נרשמים ביומנים או נשמרים? ת: Prism אינו משתמש כרגע באפשרות ה-API ״אפס שמירת נתונים (ZDR)״, ושומר יומנים למשך תקופה לאחר הבקשות כדי לשפר את המוצר.


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

שיתוף ועבודה משותפת

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


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

ייבוא וייצוא של פרויקטים

ש: ההעלאה או הייבוא של קובץ ה-ZIP תקועים בשלב ״מייבא את הפרויקט שלך״. מה לעשות? ת: נסו להעלות את הקובץ שוב. אם התהליך עדיין תקוע לאחר ניסיון נוסף, שתפו את קובץ ה-ZIP עם צוות התמיכה כדי שניתן יהיה לאתר את התקלה בתהליך הייבוא.


ש: איך מייצאים או מורידים את הפרויקט כקובץ ZIP? ת: לחצו על שם הפרויקט, ואז בחרו בייצוא כדי להוריד עותק דחוס של הפרויקט. ייתכן שיידרשו כמה שניות ליצירת החיבור לשרת לפני שיהיה אפשר לייצא.

אמינות, השבתות וקישוריות

ש: הפרויקטים שלי נעלמו אחרי רענון. האם הם אבדו? ת: רעננו שוב ובדקו מחדש את רשימת הפרויקטים. הנתונים שלכם אמורים להופיע שוב.


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


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

שלמות נתונים, שחזור, גיבויים והיסטוריית גרסאות

ש: המסמך שלי נתקע, ואז תוכן נעלם ועוגני תגובות זזו. אפשר לשחזר אותו? ת: התחילו בהורדת גיבוי בפורמט .zip. ב-Prism יש גם היסטוריית גרסאות, שעשויה לאפשר לכם לשחזר גרסה קודמת. לא תמיד ניתן לשחזר את מיקומי עוגני התגובות, וכרגע תגובות אינן מיוצאות בגיבויים. אם העיצוב השתנה, נסו לתקן אותו בעזרת כלי עיצוב הקוד.


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


ש: האם אפשר לשחזר את מיקומי התגובות, והאם התגובות נכללות בגיבויי הפרויקט? ת: ייתכן שלא ניתן לשחזר את מיקומי התגובות בדיעבד. כעת מתבצעים גיבויים תקופתיים (למשל, בערך כל 10 דקות) כדי לאפשר שחזור בתקלות עתידיות, אך כרגע תגובות אינן מיוצאות בגיבויי ZIP.

אינטגרציות

Zotero

ש: למה אי אפשר לייבא ספריות קבוצתיות של Zotero ל-Prism? ת: ספריות קבוצתיות של Zotero עדיין אינן נתמכות. אפשר לעבוד עם ספריות אישיות, אך כרגע אין תמיכה בספריות קבוצתיות.


ש: האינטגרציה שלי עם Zotero תקועה (למשל, אחרי החלפת חשבונות או מפתחות API). איך אפשר לתקן את זה? ת: צוות התמיכה יצטרך את המזהה המספרי שלכם ב-Zotero (לא את שם המשתמש) כדי לנתק את האינטגרציה מהמשתמש הקודם או האנונימי. לאחר מכן תוכלו לקשר אותה מחדש לחשבון שלכם. דוגמה לאופן הביצוע: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

ש: האם אפשר לשכפל פרויקט Prism באמצעות Git ‏(GitHub/GitLab) או לשמור עליו מסונכרן עם פלטפורמת ה-Git של המוסד שלי? ת: אינטגרציה עם Git עדיין אינה זמינה, אבל הפיתוח שלה מתוכנן בעדיפות גבוהה.

בנייה ופתרון בעיות ב-LaTeX

ש: איך מאלצים בנייה מחדש מאפס (ניקוי קובצי Aux/toc/bbl)? ת: טענו מחדש את הדף. רענון הדף מאלץ בנייה חדשה ונקייה.


ש: איורים או תמונות לא נטענים ב-Prism, אבל אותו קוד LaTeX עובד במקומות אחרים. ת: השתמשו בנתיבים יחסיים לקובץ ה-.tex שמבצע את הייבוא. אם קובץ ה-.tex נמצא בתיקיית משנה והתמונה נמצאת בתיקיית השורש של הפרויקט, הוסיפו ../ לתחילת הנתיב.


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


ש: מופיעות אזהרות ״Underfull/Overfull \hbox״ בקובץ ה-.bbl שנוצר. האם זו שגיאת קומפילציה? ת: לא, אלה אזהרות סידור טקסט, ולא שגיאות שמכשילות את הקומפילציה. אם קובץ ה-PDF שנוצר נראה תקין, לרוב אפשר להתעלם מהאזהרה.


ש: למה סביבות lstlisting/listings גורמות לשגיאות בתוך מסגרת ב-Beamer (למשל, ״Extra }, or forgotten \endgroup״)? ת: כשמשתמשים בסביבות להצגת קוד, סמנו את מסגרת ה-Beamer כ-[fragile]. לעיתים קרובות זה פותר את השגיאות האלה.


ש: ההפניות שלי עם \cite מופיעות כ-״[?]״, למרות שקובץ ה-.bib קיים והפקודות הביבליוגרפיות מופיעות. איזו תצורה תעבוד? פתרון עוקף שעבד הוא לוודא שהביבליוגרפיה נכללת כראוי מתוך המסמך הראשי. בעבודה עם BibTeX, כללו את הפקודות \bibliographystyle{plain} ו-\bibliography{refs} (כאשר refs.bib הוא הקובץ שלכם).

ממשק המשתמש ובקשות לתכונות חדשות

ש: האם יש ב-Prism מצב בהיר? ת: כן. Prism תומך בשלוש הגדרות מראה: לפי המערכת, בהיר וכהה. אפשר לבחור את ערכת הנושא המתאימה לכם ביותר.