זיהוי והתאמה אישית של מצייני מיקום ב־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 כדי לספק מידע נוסף על מטרת מצייני המיקום.