PTC
הירשם שדרג ל־Pro החשבון שלך

כיצד להכין קובץ CSV לתרגום

קובץ CSV שמתורגם בצורה חלקה כולל מפתחות יציבים, עמודות טקסט מקור ברורות וקידוד UTF-8 תקין. מדריך זה מכסה כל שלב בהכנה. ברגע שקובץ ה־CSV שלכם מוכן, תוכלו לתרגם אותו ב־3 שלבים ב־PTC (Private Translation Cloud). לסקירה של שירות ה־CSV העצמאי, ראו תרגום קובצי CSV אונליין מבוסס בינה מלאכותית.

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

איך נראה קובץ CSV מוכן לתרגום

קובץ CSV מוכן לתרגום הוא קובץ שבו:

  • לכל מחרוזת הניתנת לתרגום יש מפתח יציב וייחודי.
  • עמודת שפת המקור מזוהה בבירור.
  • עמודות שפות היעד כבר קיימות (עמודה אחת לכל שפה) או שמופק קובץ CSV אחד לכל שפת יעד.
  • עמודות מזהים (SKU, מזהה, כתובת URL של תמונה, מחיר) ברורות ככאלה שאינן מיועדות לתרגום.
  • הקובץ הוא בקידוד UTF-8 תקין ללא עמימות בקידוד.

שני מבנים נפוצים:

פורמט רחב (עמודה אחת לכל שפה):

key,en,es,fr,de
welcome,Welcome,,,
cart.empty,Your cart is empty,,,
cart.items_one,"You have %{count} item",,,

פורמט ארוך (שורה אחת לכל מחרוזת, קובץ אחד לכל שפה):

key,source
welcome,Welcome
cart.empty,Your cart is empty
cart.items_one,"You have %{count} item"

שניהם עובדים. PTC קוראת את שניהם. בחרו את זה שמתאים לתהליך הקיים שלכם.

בחרו עמודות שמתרגמים ו־PTC יכולים לקרוא

הפכו את השורה הראשונה לשורת כותרות. השתמשו בשמות עמודות פשוטים ותיאוריים כמו key, source_text, ו־context. כך כלי התרגום שלכם וכל סוקר אנושי ידעו בדיוק מה כל עמודה מכילה.

עמודות חובה. כל קובץ CSV מוכן לתרגום דורש לכל הפחות עמודת key ועמודת טקסט מקור.

  • עמודת key מכילה מזהה ייחודי לכל מחרוזת. האפליקציה שלכם משתמשת בו כדי להתאים את התרגום הנכון בזמן ריצה. השתמשו במוסכמת שמות עקבית - אותיות קטנות, קווים תחתונים ונקודות בלבד. פורמטים נפוצים: button.submit, error.invalid_login, onboarding.welcome_message. לעולם אל תשנו מפתח לאחר שהתרגום התחיל. שינוי מפתח יוצר מחרוזת חדשה ומנתק את התרגום הקיים (מותיר אותו יתום).
  • עמודת טקסט המקור מכילה את הטקסט המקורי בשפת הבסיס שלכם.

אופציונלי אך שימושי: עמודת context. מחרוזות קצרות כמו "Save" או "Back" יכולות להיות בעלות משמעויות שונות בהתאם למיקום שבו הן מופיעות בממשק שלכם. הערה קצרה מסבירה למתרגם (או לבינה המלאכותית) למה המחרוזת משמשת:

key,source_text,context
button.save,Save,Document editor toolbar
checkout.button.save,Save,Checkout address form

עבור קבצים גדולים, עמודת namespace או group עוזרת לכם לארגן מחרוזות לפי פיצ'ר או אזור.

עמודות שפה. אם תהליך העבודה שלכם שומר את המקור והיעד באותו קובץ, הוסיפו עמודה לכל שפת יעד והשתמשו בקודי ה־locale ככותרת. השתמשו ב־es_ES עבור ספרדית (ספרד), fr_FR עבור צרפתית (צרפת), pt_BR עבור פורטוגזית (ברזיל).

השתמשו במפתחות מופרדים בנקודות ליצירת היררכיה. cart.items.one ו־cart.items.other מתקבצים באופן טבעי. הימנעו מרווחים במפתחות.

שמרו עמודות מזהים בנפרד. אם קובץ ה־CSV שלכם הוא קטלוג מוצרים, העמודות sku, handle, price, ו־image_url צריכות להיות מזוהות בבירור ככאלה שאינן מיועדות לתרגום, רק על סמך השמות שלהן. אל תקברו אותן בתוך עמודת metadata כללית.

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

סמנו מצייני מיקום כדי ש־PTC תשמור עליהם בכל השפות

מצייני מיקום הם אסימונים בתוך מחרוזת המוחלפים בזמן ריצה. %s, %d, {name}, {{count}}, %{currency}. PTC שומרת על מצייני המיקום כלשונם ולעולם אינה מתרגמת את האסימון עצמו.

key,source_text
greeting,"Hello, %{name}!"
cart.total,"Total: %{currency}%{amount}"
notification,"You have %{count} new messages"

מוסכמות ש־PTC מזהה מהקופסה:

  • %s, %d, %f, %1$s, %2$d - סגנון printf (gettext, Rails, Java).
  • {name}, {count}, {0} - תחביר str.format של Python, .NET, תחביר אינדקס של ICU.
  • {{name}}, {{count}} - i18next, Mustache, Handlebars.
  • %{name}, %{count} - Rails I18n, Ruby.

אם טקסט המקור שלכם כולל תגי HTML (<strong>, <br>, <a href="">), התייחסו אליהם באותו אופן כמו למצייני מיקום. PTC מזהה ושומרת עליהם בכל הפורמטים, במיקום הנכון בכל שפת יעד. לעולם אל תתרגמו את התג עצמו.

אם אתם משתמשים במוסכמה מותאמת אישית (לדוגמה, [[token]]), הגדירו אותה במילון המונחים של פרויקט ה־PTC ו־PTC תכבד אותה בכל שורה.

קודדו צורות רבים כשורות נפרדות כדי שכל שפה תקבל את הצורות הנכונות

לרוב השפות יש יותר משתי צורות רבים. לרבות מהן יש חוקים שדובר אנגלית לא היה יכול לצפות. בפולנית יש one / few / many / other. בערבית יש שש צורות. ביפנית יש אחת (אין הבחנה לרבים). כלי תרגום ששומר רק יחיד ורבים יפיק תוצאה שגויה עבור השפות האלה.

קודדו צורות רבים כשורות נפרדות עם מוסכמת סיומת:

key,source_text,context
cart.items.zero,Your cart is empty,Zero state
cart.items.one,"You have {count} item in your cart.",Singular: count = 1
cart.items.other,"You have {count} items in your cart.",Plural: count > 1

PTC קוראת את הסיומות .zero, .one, .few, .many, ו־.other (קטגוריות רבים של CLDR) ומייצרת את קטגוריות הרבים הנכונות לכל שפת יעד.

אל תשלבו צורות רבים למחרוזת אחת עם לוכסנים או סוגריים, כמו "You have {count} item(s) in your cart.". גישה זו אינה ניתנת לתרגום ומשבשת את הדקדוק של רוב השפות.

בצעו escape לתווים מיוחדים כדי שמנתח ה־CSV לא ישבור שורות

חוקי escape ב־CSV (RFC 4180):

  • פסיקים בתוך שדה: עטפו את השדה במירכאות כפולות, אחרת המנתח יפצל את המחרוזת שלכם על פני מספר תאים.
key,source_text
intro,"Welcome to our store, where every product matters"
  • מירכאות כפולות כפשוטן: בצעו escape על ידי הכפלתן.
key,source_text
quote,"He said ""hello"" and waved"
  • ירידות שורה בתוך שדה: תקין אם השדה עטוף במירכאות.
key,source_text
address,"123 Main Street
Springfield, IL 62701"
  • מירכאות מסולסלות: השתמשו תמיד במירכאות ישרות (") במקום במירכאות מסולסלות (“ ”). מנתחי CSV אינם מזהים מירכאות מסולסלות ויזרקו שגיאות עיצוב.
  • רווחים נגררים: הסירו אותם מכל התאים לפני השליחה. הם בלתי נראים ברוב עורכי הגיליונות האלקטרוניים אך גורמים לכישלונות בהתאמת מחרוזות באפליקציה שלכם.

עבור HTML או סימון בתוך תא, עטפו את השדה במירכאות ותנו ל־PTC לתרגם רק את הטקסט:

key,source_text
disclaimer,"<p>By signing up, you agree to our <a href=""/terms"">terms</a>.</p>"

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

שמרו כ־UTF-8 כדי למנוע שיבוש של תווים מיוחדים ותווים עם סימני הטעמה

קידוד הוא הגורם הנפוץ ביותר לבעיות בתרגום CSV. ללא UTF-8, תווים מחוץ לאלפבית הלטיני הבסיסי עלולים להיות מוצגים כ־???, כתיבות ריקות, או כטקסט משובש באפליקציה שלכם.

  • שמרו את קובץ ה־CSV שלכם כ־UTF-8 (עם או בלי BOM). רוב הכלים המודרניים משתמשים בזה כברירת מחדל. היסטורית, Excel ב־Windows לא עשה זאת.
  • אל תשתמשו בקידוד Windows-1252, ISO-8859-1, או "ANSI". תווים עם סימני הטעמה בשפות היעד ישתבשו.
  • אם אינכם בטוחים, פתחו את ה־CSV בעורך טקסט כמו VS Code או Notepad++ ובדקו את מחוון הקידוד. שמרו מחדש כ־UTF-8 במידת הצורך.

הנחיות ספציפיות ל־Excel:

  • Excel ל־Mac משתמש ב־UTF-8 כברירת מחדל. אין צורך בפעולה נוספת.
  • Excel ל־Windows: בחרו בקובץ > שמירה בשם ובחרו ב־CSV UTF-8 (מופרד בפסיקים) (*.csv) מהרשימה הנפתחת של הפורמטים. לא "CSV (מופרד בפסיקים)" רגיל.
  • Google Sheets: קובץ > הורדה > ערכים מופרדים בפסיקים (.csv). קידוד UTF-8 כברירת מחדל.

עבור קובצי CSV מקור שכבר נמצאים בקידוד שגוי, המירו בעזרת iconv:

iconv -f WINDOWS-1252 -t UTF-8 source.csv > source-utf8.csv

דוגמה מעשית: קובץ CSV שלם למסחר אלקטרוני ש־PTC מתרגמת ללא הכנה מוקדמת

קובץ CSV שלם ומוכן היטב לאתר מסחר אלקטרוני:

key,source_text,context
header.welcome,"Welcome to {{shopName}}",Top of page
header.cart.zero,"Your cart is empty",Cart icon - zero state
header.cart.one,"{count} item in cart",Cart icon - singular
header.cart.other,"{count} items in cart",Cart icon - plural
product.add_to_cart,"Add to Cart",Product page CTA
product.out_of_stock,"Out of Stock",Product availability badge
product.price,"{currency}{amount}",Price display
checkout.shipping,"Shipping address",Checkout step heading
checkout.payment,"Payment method",Checkout step heading
checkout.confirm,"Place Order",Final checkout button
errors.email.required,"Email is required",Form validation
errors.email.invalid,"Please enter a valid email address",Form validation
errors.card.declined,"Your card was declined. Please try a different payment method.",Checkout error
promo.tagline,"Sale ends Sunday, grab your deal!",Promo banner - contains comma
tooltip.save,"Click ""Save"" to keep your changes.",Tooltip - contains quotes
disclaimer,"<p>By placing this order, you agree to our <a href=""/terms"">terms and conditions</a>.</p>",Footer legal

קובץ זה:

  • כולל עמודות key, source_text, ו־context ברורות.
  • משתמש במפתחות היררכיים מופרדים בנקודות.
  • תומך במצייני מיקום ({{shopName}}, {count}, {currency}, {amount}).
  • מעבד צורות רבים עם סיומות .zero / .one / .other.
  • מבצע escape ל־HTML ולמירכאות בצורה נכונה.
  • שמור כ־UTF-8.

PTC מתרגמת זאת ישירות. אין צורך בהכנה מעבר למה שמוצג.

שיטות עבודה מומלצות לתרגום CSV ברשימה אחת

  • השתמשו בכלי תרגום ייעודי. הימנעו מתרגום ידני של קובצי CSV בעורך טקסט או בגיליון אלקטרוני. כלים ייעודיים כמו PTC שומרים על מבנה הקובץ שלכם, מטפלים במצייני מיקום כראוי, ושומרים על המפתחות שלכם שלמים.
  • השתמשו בפסיקים סטנדרטיים כתו מפריד. כלים מסוימים משתמשים בנקודה ופסיק כברירת מחדל. פסיקים הם הנתמכים ביותר והסבירות הנמוכה ביותר שיגרמו לשגיאות ייבוא.
  • שמרו על מחרוזת אחת בכל שורה. שילוב של מספר מחרוזות לשורה אחת הופך את התרגומים לבלתי ניתנים לניהול ומשבש את רוב כלי התרגום.
  • בודדו עמודות הניתנות לתרגום. שמרו עמודות שדורשות תרגום בנפרד מעמודות שצריכות להישאר ללא שינוי (מזהים מספריים, מספרי SKU, פרמטרים טכניים). הדבר מפחית את הסיכון שכלי או מתרגם ישנו בטעות נתונים שצריכים להישאר ללא שינוי.
  • הימנעו מתאים ממוזגים ומעיצוב גיליון אלקטרוני. CSV הוא טקסט פשוט. כל עיצוב שמוחל באמצעות תוכנת גיליון אלקטרוני יוסר כאשר הקובץ יעבור עיבוד.
  • הסירו עמודות ומטא-נתונים מיותרים. כללו רק את העמודות שכלי התרגום שלכם זקוק להן.
  • בדקו קודם כל עם מדגם קטן. לפני הרצת קובץ גדול לתרגום, בצעו בדיקה עם מדגם קטן כדי לאתר בעיות מבניות או בעיות קידוד בשלב מוקדם.
  • אמתו את הקובץ שלכם לפני ההעלאה. ודאו שלכל שורה יש מפתח ייחודי ללא כפילויות, שאין מפתחות המכילים רווחים או תווים מיוחדים, ושאין שורות שבורות.
  • שמרו גיבוי. שמרו תמיד עותק של קובץ ה־CSV המקורי שלכם לפני שליחתו לתרגום.

סקירה חזותית של התרגום בקטלוג או באפליקציה המרונדרים

לאחר ש־PTC מתרגמת את ה־CSV, המחרוזות מרונדרות בכל מה שצורך את ה־CSV. זה כולל את חזית החנות שלכם, האפליקציה שלכם, ולוח הבקרה שלכם. כותרת מוצר מתורגמת שמתאימה לקובץ עלולה לגרום להצפת תוכן בפריסת כרטיס. כפתור קופה בצרפתית עשוי להשתמש במילה הלא נכונה עבור "Place Order". כתובת ארוכה בגרמנית עלולה לשבש עמודה ברוחב קבוע בחשבונית מודפסת.

ה־AI Visual QA של PTC מאתר את הבעיות האלה. עבור חזיתות חנות ולוחות בקרה (מבוססי דפדפן), התקינו את תוסף הדפדפן של PTC והקליטו מעבר בחנות שלכם. PTC מריצה אותו מחדש בכל שפת יעד ומתקנת בעיות פריסה והקשר בקובץ ה־CSV באופן אוטומטי. עבור אפליקציות נייטיב שצורכות את ה־CSV, העלו במקום זאת צילומי מסך של המסכים הרלוונטיים.

תרגמו הכרזות על השקת מוצרים ואימיילים לספקים

הכרזות על השקת מוצרים ואימיילים ללקוחות בנוגע לעדכוני קטלוג נמצאים מחוץ ל־CSV. ה־Paste to Translate של PTC מטפל בתוכן השיווקי הזה באותו פרויקט, תוך שימוש באותו מילון מונחים וטון מותג כמו בתרגומי הקטלוג שלכם.

תרגמו ייבואים באצווה עם הגעת הנתונים באמצעות ה־API של PTC

ייבוא קטלוגים באצווה שדורשים תרגום עם הגעתם יכולים לזרום דרך ה־REST API של PTC עם אימות טוקן Bearer, תוך שימוש באותו מילון מונחים וטון מותג כמו בתרגומי ה־CSV שלכם.

כעת תרגמו את קובץ ה־CSV שלכם בעזרת PTC

לאחר שקובץ ה־CSV שלכם מוכן, תרגמו אותו ב־3 שלבים:

  1. העלו את קובץ ה־CSV שלכם ובחרו שפות יעד.
  2. PTC מתרגמת תוך שמירה על כל עמודה, מפתח ומציין מיקום.
  3. הורידו את קובצי ה־CSV המתורגמים וייבאו אותם למקומם.

התחילו תקופת ניסיון של 30 יום - 20,000 מילים ל־2 שפות, ללא כרטיס אשראי.