זיהוי והתאמה אישית של מצייני מיקום ב־PTC

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

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

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

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

דוגמה למציין מיקום

%service%

%{service}

:service:

${service}

$service$

''service''

[service]

@[service]

{{service}}, {{service_name}}

{service}, {service_name}

ביטוי רגולרי (Regex)

\%\w+\%

\%\{\w+\}

\:\w+\:

\$\{\w+\}

\$\w+\$

\'\'\w+\'\'

\[\w+\]

\@\[\w+\]

\{\{[\w_-]+\}\}

\{[\w_-]+\}

הוספת מצייני מיקום מותאמים אישית

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

בדף Settings ← String Placeholders (הגדרות ← מצייני מיקום במחרוזות), PTC מציג רשימה של מצייני מיקום מוגדרים מראש על סמך מבנה הפרויקט שזוהה וסוגי קובצי המשאבים בפרויקט שלכם.

כאן תוכלו:

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

לאחר ביצוע שינויים כלשהם, שמרו את ההגדרות כדי להחיל את העדכונים.

שיטות מומלצות למצייני מיקום מותאמים אישית

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

שמרו על מצייני מיקום פשוטים

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

• עדיף: <name>
• מורכב מדי: <user-name&role-123>

השתמשו בפורמטים ייחודיים

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

• מציין מיקום מורכב: {user_details}
• מציין מיקום פשוט: {user}

בדוגמה זו, {user_details} עלול להיות מזוהה בטעות כ־{user}, מכיוון ש־{user} הוא חלק ממציין המיקום המורכב.

השתמשו במילים בין מצייני מיקום לצורך הקשר

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

• עדיף: "Hello, <name>! Your order number is <order_number>."
• לא מומלץ: "<name> <order_number>"

מה קורה אם PTC נתקל בבעיות במצייני המיקום שלכם?

PTC מסמן מחרוזות שאינן ברורות מסיבות שונות, כגון:

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

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

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