טקסט ותרגומים

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

משימה	מיקום נכון
שנה תווית בהתקנה אחת	$vocab_override בconfig.inc.php
הוסף או שפר שפת ממשק משתמש MRBS	web/lang/lang.<language>
תרגם או התאם אישית את דף העזרה בתוך היישום	web/site_faq/site_faq_<language>.html
תרגם מדריך זה	קובץ עם סיומת שפה מתחת docs/

דריסת ניסוח באתר יחיד

אל תערוך קובץ שפה שסופק עם המערכת רק כדי לשנות את המילה "חדר" או את כותרת האתר. מצא את האסימון ב-web/lang/lang.en ודרוס את ערכו:

$vocab_override['en']['mrbs'] = 'Resource Booking';
$vocab_override['de']['mrbs'] = 'Ressourcenbuchung';
$vocab_override['fr']['mrbs'] = 'Réservation de ressources';
$vocab_override['es']['mrbs'] = 'Reserva de recursos';

סדר האינדקס הוא תמיד שפה, ואז אסימון: $vocab_override[LANG][TOKEN].

אסימונים שימושיים המוגדרים באתר כוללים:

$vocab_override['en']['room.coffee_machine'] = 'Coffee machine';
$vocab_override['en']['entry.catering'] = 'Catering';
$vocab_override['en']['entry.description.placeholder'] =
    'Add information for the room team';
$vocab_override['en']['users.zip_code.oninvalid'] =
    'Enter a valid ZIP code';
$vocab_override['en']['type.C'] = 'Customer booking';

אסימוני שדות מותאמים אישית מתוארים ב-שדות מותאמים אישית. תיאורים של סוג הזמנה משתמשים ב-type.X, כאשר X הוא קוד הסוג המוגדר.

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

שמירה על מצייני המיקום

מחרוזות שפה עשויות להכיל מצייני printf, כגון %s ו-%d, או צורות ממוספרות כגון %1$d. שמור על כל מציין ועל סוגו. אפשר לשנות את סדר הארגומנטים בתרגום רק באמצעות הצורה הממוספרת.

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

בחירת שפת הממשק

כברירת מחדל, MRBS בוחר שפה מהדפדפן:

$disable_automatic_language_changing = false;

כדי לאלץ שפה אחת:

$disable_automatic_language_changing = true;
$default_language_tokens = 'de';

האסימון חייב להתאים לקובץ web/lang/lang.* זמין. ניתן לעקוף בנפרד את בחירת המקום עבור תאריכים ושעות:

$override_locale = 'de-DE';
$cli_language = 'de';

$override_locale חייב להיות נתמך גם על ידי מערכת ההפעלה של השרת. $cli_language שולט בפקודות הפועלות מחוץ לדפדפן. לצורך אבחון, $language_debug = true כותב מידע על שפה ואזור ליומן השגיאות; השבת אותו שוב לאחר פתרון בעיות.

הוסף או תחזוק שפת יישום

הקובץ האנגלי הוא קובץ הייחוס ושפת הגיבוי. כדי ליצור שפה המזוהה באמצעות הקוד xx:

cp web/lang/lang.en web/lang/lang.xx

לאחר מכן:

1. שמור על קו הפתיחה PHP וכל מפתח $vocab.
2. תרגם ערכי מחרוזת, לא שמות אסימונים.
3. שמור את הקובץ כ-UTF-8.
4. אל תשתמש בישויות HTML מלבד  ; כתוב תווי UTF-8 ישירות.
5. שמור על סמני החלפה וסימון מכוון.
6. בדוק את תחביר PHP.

php -l web/lang/lang.xx

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

בדוק את השלמות

checklang.php משווה קבצי שפה עם lang.en. עבור מופע פיתוח, מקם או שמור אותו בספריית האינטרנט MRBS ופתח את:

https://example.invalid/mrbs/checklang.php?lang[]=xx

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

בדיקת תחביר ו-checklang.php תופסים בעיות שונות: השתמש בשניהם.

תרגם את דף העזרה בתוך היישום

טקסט העזרה אינו מגיע מ-$vocab. זה מאוחסן בנפרד:

web/site_faq/site_faq.html
web/site_faq/site_faq_de.html
web/site_faq/site_faq_fr.html
web/site_faq/site_faq_es.html

בחר את הסיומת ללא קו תחתון:

$faqfilelang = 'de';

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

תרגם מדריך זה

אתר התיעוד משתמש בקבצי סיומת:

docs/admin-guide/custom-fields.md
docs/admin-guide/custom-fields.de.md
docs/admin-guide/custom-fields.fr.md
docs/admin-guide/custom-fields.es.md

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

זרימת עבודה בטוחה בשדרוג

1. שים ניסוח לאתר בלבד ב-$vocab_override.
2. שמור רשימה של קבצי שפות ושאלות נפוצות שמתוחזקים מקומית.
3. השווה lang.en חדש עם הגרסה הקודמת עבור אסימונים שנוספו או השתנו.
4. הפעל את php -l על כל קובץ שפה שהשתנה.
5. הפעל את checklang.php על מופע פיתוח מוגבל.
6. סקור את השינויים הנפוצים בנפרד.
7. בדוק את כל השפות הפעילות לפני הפריסה.

רשימת בדיקה לאימות

• זיהוי דפדפן וברירת המחדל הכפויה בחר את השפה הצפויה.
• אסימונים חסרים חוזרים לאנגלית מובנת.
• ניווט, טפסים, שגיאות, אישורים ודפי ניהול מעובדים כהלכה.
• %s, %d וסמני מיקום מקבלים את הערכים הנכונים.
• תאריכים, שעות, ימי חול ואזורי זמן משתמשים במקום המיועד.
• נושאים וגופים בדוא"ל, דוחות, ייצוא ועבודות בשורת הפקודה משתמשים בשפה המיועדת.
• שדות מותאמים אישית, סוגי הזמנות, מצייני מיקום והודעות אימות מתורגמים.
• דף העזרה משתמש בקובץ הצפוי site_faq.
• יומנים אינם מכילים איתור באגים בשפה מתמשכת או ערכי טופס רגישים.