الوثائق / ترجم / String Catalog
ترجمة كتالوجات سلاسل Xcode
املأ ملفات Localizable.xcstrings لتطبيقات SwiftUI و UIKit، مع محددات %@ و %lld، وتنوعات الجمع، واستبدالات %#@name@، والتعليقات كالسياق. ملفات .strings القديمة أيضًا.
كيف يعمل
يحتوي كتالوج السلاسل على كل اللغات في ملف واحد. يضيف localize-dev translate اللغات المفقودة لكل إدخال مع ضبط state على translated، ويحافظ على ترتيب المفاتيح وتنسيق JSON الخاص بـ Xcode بحيث يبقى الاختلاف صغيرًا، ويرسل سياق كل سلسلة comment. يتم تخطي السلاسل التي بها shouldTranslate معطلة.
تأخذ التنويعات الجمع الأشكال التي تستخدمها كل لغة. تُترجم جملة تحتوي على عدة أعداد (%#@photos@ in %#@albums@) كالجملة بالإضافة إلى أشكال كل عدد، وتكتب مرة واحدة فقط بعد الانتهاء منها جميعًا. تُترك تنويعات الجهاز لمحرر Xcode. تُترجم ملفات en.lproj/Localizable.strings القديمة أيضًا إلى <lang>.lproj، مع الاحتفاظ بالتعليقات.
قبل وبعد
الناتج الفعلي لـ localize-dev translate --locales de على الملف الأول. يُضاف الألمانية إلى كل إدخال، مع تضمين تنويع الجمع، بتنسيق Xcode الخاص.
{
"sourceLanguage" : "en",
"strings" : {
"Delete Photo" : {
"comment" : "Button in the photo detail toolbar"
},
"Hello, %@!" : {
},
"%lld photos" : {
"localizations" : {
"en" : {
"variations" : {
"plural" : {
"one" : { "stringUnit" : { "state" : "translated", "value" : "%lld photo" } },
"other" : { "stringUnit" : { "state" : "translated", "value" : "%lld photos" } }
}
}
}
}
}
},
"version" : "1.0"
}{
"sourceLanguage" : "en",
"strings" : {
"Delete Photo" : {
"comment" : "Button in the photo detail toolbar",
"localizations" : {
"de" : {
"stringUnit" : {
"state" : "translated",
"value" : "Foto löschen"
}
}
}
},
"Hello, %@!" : {
"localizations" : {
"de" : {
"stringUnit" : {
"state" : "translated",
"value" : "Hallo, %@!"
}
}
}
},
"%lld photos" : {
"localizations" : {
"de" : {
"variations" : {
"plural" : {
"one" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Foto"
}
},
"other" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Fotos"
}
}
}
}
},
"en" : {
"variations" : {
"plural" : {
"one" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld photo"
}
},
"other" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld photos"
}
}
}
}
}
}
}
},
"version" : "1.0"
}ما يبقى سليماً
%@،%lld،%1$@وغيرها من المحددات، تم التحقق منها- تنويعات الجمع واستبدالات
%#@name@ - ترتيب المفاتيح وتنسيق JSON الخاص بـ Xcode، حتى لا يعيد Xcode كتابة الملف
- تعليقات المترجم، أيضًا في ملفات .strings
الأخطاء الشائعة، وكيفية تجنبها
ترتيب الحجج بشكل معكوس
الألمانية واليابانية غالبًا ما تتطلب ترتيب عناصر الجملة في ترتيب مختلف. يعني عناصر %@ غير المرقمة شيئًا من خلال موقعها، لذلك يتم رفض الترجمة التي تتغير فيها ترتيبها. يمكن نقل العناصر المرقمة مثل %1$@.
استبدالات نصف مترجمة
قيمة %#@name@ تتطلب جملة كاملة لكل عدد من أشكالها في كل لغة. يجب كتابتها معًا أو لا كتابتها على الإطلاق.
شكال الجمع الإنجليزية مقترنة باليابانية
اليابانية والصينية والكورية لديها شكل واحد للجمع. فقط other يتم كتابته بالنسبة لهم، بدلاً من one مقتبس من الإنجليزية.
قم بتشغيله
في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --dry-run ما سيتغير أولاً.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deثم حافظ على اكتماله في CI. هذا لا يحتاج إلى مفتاح API ويفشل عندما تكون اللغة مفقودة الترجمات:
npx localize-dev check --only translationsمجاني لـ 1,000 سلسلة في الشهر. تُحتسب السلسلة مرة واحدة بغض النظر عن عدد اللغات التي تدخل فيها. إنشاء حساب مجاني
أدلة للتطبيقات التي تستخدم هذا التنسيق
عندما لا يزال النص مرمزًا بشكل ثابت في الكود الخاص بك، يقوم localize-dev run بنقله إلى هذا التنسيق أولاً.