مدونة

فحص i18n لـ CI لا يحتاج إلى مفتاح API

فحص localize-dev يكتشف النصوص المشفرة، والأشكال الجمع المفقودة، والترجمات القديمة، ويحدد السطر في طلب السحب، ولا يرسل شيئًا إلى أي مكان.

Stephen Ufort · 10 نوفمبر 2026 · دقيقتان للقراءة

طلب سحب على GitHub حيث يحدد فحص i18n جملة مكتوبة بخط اليد في السطر 226

ترجمة التطبيق مرة واحدة هي الجزء السهل. الجزء الصعب هو الإصدار التالي، عندما يضيف شخص جملة باللغة الإنجليزية ولا يلاحظ أحد أنها لم تُترجم. localize-dev check هو أداة فحص لهذا الغرض. يعمل بدون اتصال، ولا يحتاج إلى حساب أو مفتاح API، ويخرج برمز 1 عندما يجد مشكلة، بحيث يمكن أن يفشل مهمة CI.

ماذا يبلغ

لقد قمت بتشغيله على تطبيق React صغير: مكون واحد، وملفات لغة إنجليزية وإسبانية وعربية، وجملة نسيها أحدهم لترجمتها. إليك المخرجات:

npx localize-dev check
  src/components/SignIn.tsx:9  "We'll email you a 6-digit code. No password needed."
⚠️  1 hardcoded string(s) in 1 file(s). Fix with: npx localize-dev run
⚠️  ar: 4 message(s) without a translation in locales/ar.json
Fill them in with: npx localize-dev translate

الاكتشاف الأول هو الجملة المنسية. الثاني أقل وضوحًا. احتوى الملف العربي على files_one و files_other، والتي تبدو كاملة إذا فكرت باللغة الإنجليزية. تحتاج اللغة العربية إلى ستة أشكال جمع، لذا يبلغ check عن الأربعة المفقودة: zero و two و few و many.

كل فحص يغطي طريقة واحدة لتعطل التطبيق المترجم:

  • نص ثابت، تم العثور عليه بواسطة نفس الماسح الضوئي الذي يستخدمه run.
  • ترجمات مفقودة، مع عد كل شكل جمع يحتاجه كل لغة.
  • ترجمات قديمة: تغير النص المصدر بعد ترجمته، تم العثور عليه من خلال localize.lock.json.
  • مفاتيح غير معروفة: استدعاء t() الذي لا يوجد مفتاحه في الملف المصدر، لذلك سيرى الناس المفتاح نفسه.
  • نص لا يمكن ترجمته في مكانه، مع ذكر السبب.
  • تحذيرات لا تفشل المهمة: أنماط اليمين واليسار التي تتعطل في اللغات من اليمين إلى اليسار، والنص في CSS، والمفاتيح التي لا يستخدمها أي كود.

تحديد السطر في طلب السحب

عندما يعمل في GitHub Actions، يقوم check أيضًا بطباعة أوامر سير العمل، والتي تعرضها GitHub كتعليقات توضيحية على اختلاف طلب السحب:

::error file=src/components/SignIn.tsx,line=9,title=Hardcoded string::"We'll email you a 6-digit code. No password needed." isn't translated. Run localize-dev run (or let the Action open a pull request).
::error file=locales/ar.json,title=Missing ar translations::4 message(s) have no ar translation: signin.files_few, signin.files_many, signin.files_two, signin.files_zero

يمكنك إضافته كخطوة CLI، أو استخدام وضع التحقق الخاص بـ GitHub Action، والذي لا يتطلب مفتاح API:

.github/workflows/i18n.yml
name: i18n
on: pull_request
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ufortstephen/autolocalize-action@v1
        with:
          mode: check

لماذا لا يرسل شيئًا

يقرأ check الملفات فقط: المصدر الخاص بك، وملفات اللغة الخاصة بك، وملف القفل. لا يقوم بإجراء أي مكالمات شبكة، لذا فهو آمن على الشوكات، وعلى التعليمات البرمجية الخاصة، وعلى المشغلات بدون إنترنت. إنه مجاني أيضًا، ولا يتم احتسابه ضمن أي حصة خطة.

تشغيله قبل CI

ينظر npx localize-dev check --changed فقط إلى الملفات التي تم تغييرها منذ آخر commit، مما يجعله سريعًا. يضيف npx localize-dev init --agent --pre-commit خطاف pre-commit لـ git يتحقق من الملفات المرحلية. عندما تكون المشكلة شيئًا قصدت تركه، مثل اسم علامة تجارية أو نص في منتقي لغة، فضع علامة على العنصر باستخدام data-i18n-ignore أو translate="no" وسيتجاهله check.

جربه على الكود الخاص بك في الملعب، لا يلزم حساب