ترجمة ملفات gettext .po
املأ الإدخالات الفارغة وغير الواضحة في ملفات .po الخاصة بـ Django و WordPress و PHP و Python، مع خانات msgstr[n] من Plural-Forms لكل لغة و msgctxt وتعليقات المترجم كسياق.
كيف يعمل
في gettext، يحتفظ كل ملف .po خاص باللغة بنسخته الخاصة من النص المصدر، لذا يعامل localize-dev translate كل ملف ككتالوج: فهو يملأ الإدخالات التي يكون msgstr الخاص بها فارغًا أو مميزًا كضبابي ويترك الإدخالات المترجمة وحدها. يتم تخطي إدخالات #~ القديمة.
تذهب تعليقات المترجم (#.) و msgctxt إلى النموذج كسياق، لذا تتم ترجمة "Archive" على زر كفعل. تحصل لغة جديدة (--locales pl) على ملفها الخاص بجانب ملف موجود، مع رأس Language و Plural-Forms الخاص بها. قم بالتجميع كالمعتاد بعد ذلك: python manage.py compilemessages لـ Django، msgfmt في أماكن أخرى.
قبل وبعد
الناتج الفعلي لـ localize-dev translate --locales de,pl على الملف الأول. كان الملف الألماني يحتوي على إدخالين فارغين وإدخال ضبابي. مع --locales de,pl تم ملؤها، وتم إنشاء الملف البولندي أدناه بثلاث خانات صيغة الجمع.
msgid ""
msgstr ""
"Language: de\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#. Heading on the account page
msgid "Your account"
msgstr ""
#, fuzzy
msgid "Signed in as %(email)s"
msgstr "Angemeldet als"
msgctxt "verb, on a button"
msgid "Archive"
msgstr ""
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] ""
msgstr[1] ""msgid ""
msgstr ""
"Language: pl\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
#. Heading on the account page
msgid "Your account"
msgstr "Twoje konto"
msgid "Signed in as %(email)s"
msgstr "Zalogowano jako %(email)s"
msgctxt "verb, on a button"
msgid "Archive"
msgstr "Archiwizuj"
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] "%(count)s plik przesłany"
msgstr[1] "%(count)s pliki przesłane"
msgstr[2] "%(count)s plików przesłanych"ما يبقى سليماً
%(name)sو{name}وعناصر نائب printf، تم التحقق منها- واحد
msgstr[n]لكل خانة من Plural-Forms الخاصة باللغة: 3 للبولندية، 6 للعربية - الترويسة وتعليقات المترجم وترتيب الإدخال
msgctxt، لذلك يمكن ترجمة نفس msgid بشكل مختلف حسب السياق
الأخطاء الشائعة، وكيفية تجنبها
الإدخالات الضبابية المتروكة
يتخطى gettext الإدخالات الضبابية عند تجميعه، لذا يعود الترجمة القديمة بصمت إلى النص المصدر. تتم ترجمة الإدخالات الضبابية مرة أخرى ويتم مسح العلامة.
العدد الخاطئ من خانات الجمع
يحتوي ملف تم نسخه من الألمانية على خانتين msgstr[n]؛ تحتاج البولندية إلى ثلاث. يتم تعيين Plural-Forms للملف الجديد بلغته، وتحصل كل خانة على الشكل الخاص بالأرقام التي تقع فيها.
عناصر نائبة مُعاد ترتيبها
العناصر النائبة غير المسماة %s تعني شيئًا بموضعها. يتم رفض الترجمة التي تعيد ترتيبها. يمكن للعناصر المسماة مثل %(email)s الانتقال إلى أي مكان تحتاجه الجملة.
قم بتشغيله
في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --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 بنقله إلى هذا التنسيق أولاً.