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

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