איך לתרגם הודעת שגיאה בלי לשנות את הקוד

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

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

שמרו את המקור לצורך תמיכה

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

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

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

הכינו הודעה קצרה שמותר לעבד

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

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

קראו את המדיניות של JotMe לפני שליחת טקסט לעיבוד באינטרנט

קראו את ההודעה בדמו הטקסט

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

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

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

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

השוו הודעה בדיונית בגרמנית

הודעת תרגול בגרמנית שנכתבה בידי מחבר המאמר: “Die Datei „bericht.txt“ wurde nicht gespeichert. Fehlercode: E104. Löschen Sie die Originaldatei nicht.” זה תרגיל שפה בדיוני, לא הודעה ממוצר אמיתי, הנחיה שנבדקה לפתרון תקלה או פלט שנלכד מ-JotMe. הקוד השרירותי E104 אינו מצביע כאן על תקלה אמיתית.

נוסח ייחוס באנגלית שנכתב בידי המחבר: “The file ‘bericht.txt’ was not saved. Error code: E104. Do not delete the original file.” זו קריאה עריכתית, לא פלט ספק שנצפה. שם הקובץ נשאר bericht.txt; תרגום המילה הגרמנית הרגילה ל-report.txt יצביע על קובץ אחר.

• מזהים: E104 חייב להישאר E104, באותן אותיות וספרות, תוך שמירה על ההבחנה בין אותיות גדולות לקטנות. שמרו את bericht.txt ואת הסיומת כשאתם מתייחסים לקובץ הזה. מזהה שהועתק נכון מועיל להשוואה, לא מבטיח שהמשפט שסביבו נכון.
• תוצאה: “was not saved” לא יכול להפוך ל-“was saved.” שמרו על ההבדל בין אירוע שהושלם, מצב נוכחי ותוצאה אפשרית; אל תמציאו סיבה לכישלון השמירה.
• פעולה: שמרו על “Do not delete the original file.” הסרת השלילה הופכת את ההוראה. תרגום המשפט אינו אישור שמחיקה, הורדה או פקודה אחרות שהוצעו הן בטוחות.
• הקשר: בשגיאה אמיתית קשרו את ההודעה למוצר ולפעולה האמיתיים. אותו ניסוח או קוד ביישום אחר עשויים לציין מצב אחר.

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

הפרידו בין הבנת ההודעה לבין פתרון התקלה

• הפרידו את מה שההודעה קובעת מהסבר אפשרי. “לא ניתן לשמור” אינו מוכיח כשלעצמו דיסק מקולקל, בעיית הרשאות או צורך בתיקון מסוים. אל תהפכו Explanation שנוצר אוטומטית לאבחון מאומת.
• בעת פנייה לעזרה הרשמית או לתמיכה, השתמשו בקוד המקורי יחד עם המוצר והגרסה האמיתיים. שמרו את הנוסח המקורי זמין; התרגום מוסיף הקשר ואינו מחליף ראיות.
• אל תריצו פקודה, תמחקו קובץ, תתקינו הורדה, תשנו הגדרות אבטחה או תפתחו קישור לא מוכר רק כי הודעה מתורגמת או הסבר מציעים זאת. בדקו את המקור ובפעולות בעלות השלכות השתמשו בתהליך התמיכה המתאים למוצר.
• אם המקור חסר, מעורב בשפות או עמום, סמנו את החלק הלא ברור ובקשו הבהרה. אל תניחו שזיהוי שפה אוטומטי מטפל בכל מקטע, ואל תחברו חלקים שתורגמו בנפרד כאילו ההודעה כולה נבדקה.

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

שמרו הערת תמיכה דו-לשונית שימושית

1. ברשומה מותרת שמרו את ההודעה או תמונת המקור, מוצר או רכיב, גרסה אם ידועה, שעה, הפעולה שניסיתם והקוד המדויק שאינו רגיש.
2. הוסיפו בנפרד זוג שפות, קריאה מתורגמת ומילים שלא הוכרעו. תייגו Explanation אוטומטי וכל תיקון שנבדק, ושמרו מי או איזה מקור תמכו בתיקון.
3. הבחינו בין פעולה שהוצעה לבין פעולה שביצעתם בפועל. רשמו את התוצאה האמיתית אם היא ידועה; אל תסמנו תקלה כמתוקנת רק משום שהתרגום קריא.
4. לפני שיתוף בדקו רשות, נמען ויעד, והסירו פרטים פרטיים לא רלוונטיים. התווית “תורגם מגרמנית” מתארת יחס בין שפות; היא אינה מאמתת את ההודעה או מאשרת פתרון.

דוגמה לרשומה חיצונית על התרגיל: מזהה מקורי: E104; קובץ: bericht.txt; תוצאה שדווחה: לא נשמר; הוראה בהודעה: לא למחוק את הקובץ המקורי; סיבה: לא ידועה; תיקון שבוצע: אין. זו דוגמת תיעוד שכתב המחבר, לא תכונת פרויקט שמור או מקרה תמיכה אמיתי.

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

קראו את תהליך תרגום צילום המסך

קראו את תהליך תרגום ההוראות

פתחו את עמוד תרגום הטקסט המלא