واجهة برمجة تطبيقات الترجمة Gettext (.po)

التعريب. تدعم Localization.One تنسيق GNU Gettext القياسي في الصناعة. سواء كنت تقوم بإنشاء مكون إضافي لووردبريس، أو تطبيق Django، أو مشروع C++، يمكنك إدارة ترجماتك في واجهة حديثة وتصديرها كملفات .po صالحة.

لماذا يختار المطورون واجهة برمجة تطبيقات Gettext لدينا؟

  • تنسيق PO الأصلي: نقوم بإنشاء إدخالات msgid وmsgstr صالحة متوافقة مع Poedit ومجمعات Gettext القياسية (msgfmt).
  • الهروب الذكي: نتعامل تلقائيًا مع علامات الاقتباس المزدوجة والأسطر الجديدة، مما يضمن تجميع ملفاتك إلى تنسيق .mo الثنائي دون أخطاء في بناء الجملة.
  • إدارة الرأس: تتضمن كل ملف رؤوسًا قياسية (نوع المحتوى، الترميز)، بحيث يتعرف تطبيقك على مجموعة الأحرف (UTF-8) بشكل صحيح.

إدارة المشاريع المتقدمة

نقدم أدوات قوية للحفاظ على تنظيم التعريب الخاص بك، بغض النظر عن حجم مشروعك.

التصنيف: قم بتجميع سلاسل النصوص الخاصة بك في شجرة مجلدات منطقية (مثل، الإدارة > القائمة، الواجهة الأمامية > الأخطاء).

التسميات والعلامات: قم بتمييز السلاسل بتسميات مخصصة لتصفية التصديرات عبر واجهة برمجة التطبيقات.

الأدوار والأذونات: دعوة عدد غير محدود من أعضاء الفريق وتعيين أدوار دقيقة (مالك، مسؤول، مدير، مترجم).

Webhooks: استقبل إشعارات على خادمك كلما تم تحديث الترجمات أو الموافقة عليها.

كيفية الدمج

الخيار 1: التصدير اليدوي (واجهة المستخدم)

مثالي للتحديثات الدورية أو التجميع اليدوي.

  1. اذهب إلى لوحة التحكم في المشروع.
  2. انقر على زر تنزيل .
  3. اختر Gettext PO من قائمة التنسيق المنسدلة.
  4. اختر اللغة وقم بتنزيل الملف.

الخيار 2: الأتمتة باستخدام واجهة برمجة التطبيقات (CI/CD)

استرجع أحدث الترجمات مباشرة في خط أنابيب البناء الخاص بك. مرر المعامل format=po.

bash
# تنزيل الترجمات الإنجليزية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=po" > languages/en_US.po

# تنزيل الترجمات الإسبانية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=po" > languages/es_ES.po

الخيار 3: الدفع عبر Webhooks

قم بتكوين عنوان URL لـ Webhook في إعدادات مشروعك لأتمتة العملية بالكامل.

  • تحديثات سريعة: يتلقى خادمك طلب POST بعد فترة وجيزة من التغييرات (عادةً خلال 5 دقائق).
  • التجميع التلقائي: استخدم الـ webhook لتفعيل سكربت يقوم بتنزيل ملف .po وتجميعه تلقائيًا إلى .mo.

أسئلة متكررة

هل أحتاج إلى تجميع ملف .mo؟

نعم. توفر واجهة برمجة التطبيقات لدينا ملف .po المصدر. يجب أن تتضمن خطوة في عملية البناء الخاصة بك (باستخدام msgfmt) لتجميعه إلى ملف .mo ثنائي للحصول على أداء أفضل في الإنتاج.

هل هو متوافق مع ووردبريس؟

نعم. التنسيق المصدّر متوافق تمامًا مع ووردبريس. فقط تأكد من إعادة تسمية الملف إلى التنسيق الصحيح لمجال النص (مثل، my-plugin-es_ES.po) بعد التنزيل.

التقنيات ذات الصلة:

  • هل تستخدم أطر PHP الحديثة؟ تحقق من تعريب Laravel.
  • هل تحتاج إلى تنسيق ويب بسيط؟ انظر React JSON.

هل أنت مستعد لتحديث سير العمل الخاص بك باستخدام Gettext؟ أنشئ حسابك المجاني اليوم.