روبي أون ريلز

الترجمة بالذكاء الاصطناعي لـ Ruby on Rails مع واجهة سطر أوامر Lingo.dev

ما هو Ruby on Rails؟

Ruby on Rails هو إطار عمل لتطبيقات الويب من جانب الخادم مكتوب بلغة Ruby. يوفر هياكل افتراضية لقواعد البيانات وخدمات الويب وصفحات الويب، متبعًا نمط النموذج-العرض-المتحكم (MVC).

ما هو Lingo.dev CLI؟

Lingo.dev هي منصة ترجمة مدعومة بالذكاء الاصطناعي. يقوم Lingo.dev CLI بقراءة ملفات المصدر، وإرسال المحتوى القابل للترجمة إلى نماذج اللغة الكبيرة، وكتابة الملفات المترجمة مرة أخرى إلى مشروعك.

حول هذا الدليل

يشرح هذا الدليل كيفية إعداد Lingo.dev CLI في تطبيق Ruby on Rails. ستتعلم كيفية بناء مشروع باستخدام Rails، وتكوين خط أنابيب الترجمة، وعرض النتائج.

الخطوة 1. إعداد مشروع Rails

  1. إنشاء تطبيق Rails:

    rails new rails-demo

  2. الانتقال إلى دليل المشروع:

    cd rails-demo

  3. إنشاء متحكم مع عرض:

    bin/rails generate controller Home index

الخطوة 2. إنشاء محتوى المصدر

  1. افتح ملف اللغة الإنجليزية في config/locales/en.yml.

  2. أضف بعض المحتوى القابل للترجمة:

    en:
  home:
    title: "Welcome"
    greeting: "Hello from Rails + Lingo.dev"

الخطوة 3. تكوين CLI

في جذر المشروع، قم بإنشاء ملف i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": 1.8,
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "yaml-root-key": {
      "include": ["config/locales/[locale].yml"]
    }
  }
}

يحدد هذا الملف:

  • الملفات التي يجب على Lingo.dev CLI ترجمتها
  • اللغات المراد الترجمة بينها

في هذه الحالة، يقوم التكوين بترجمة ملفات YAML من الإنجليزية إلى الإسبانية.

[locale] هو عنصر نائب يتم استبداله في وقت التشغيل. يضمن ذلك قراءة المحتوى من موقع واحد (مثل config/locales/en.yml) وكتابته إلى موقع مختلف (مثل config/locales/es.yml).

لمعرفة المزيد، راجع تكوين i18n.json.

الخطوة 4. ترجمة المحتوى

  1. قم بالتسجيل للحصول على حساب Lingo.dev.

  2. قم بتسجيل الدخول إلى Lingo.dev عبر واجهة سطر الأوامر:

    npx lingo.dev@latest login

  3. قم بتشغيل خط أنابيب الترجمة:

    npx lingo.dev@latest run

    ستقوم واجهة سطر الأوامر بإنشاء ملف config/locales/es.yml لتخزين المحتوى المترجم وملف i18n.lock للاحتفاظ بسجل ما تمت ترجمته (لمنع إعادة الترجمة غير الضرورية).

الخطوة 5. استخدام الترجمات

  1. قم بتكوين المسارات المستندة إلى اللغة في config/routes.rb:

    Rails.application.routes.draw do
  scope "(:locale)", locale: /en|es/ do
    root "home#index"
  end
end

  2. قم بإعداد معالجة اللغة في app/controllers/application_controller.rb:

    class ApplicationController < ActionController::Base
  before_action :set_locale

  private

  def set_locale
    I18n.locale =
      params[:locale].presence_in(I18n.available_locales.map(&:to_s)) ||
      I18n.default_locale
  end
  
  def default_url_options
    { locale: I18n.locale }
  end
end

  3. استخدم طريقة المساعد t لتحميل السلاسل النصية المترجمة داخل العرض:

    <h1><%= t("home.title") %></h1>
<p><%= t("home.greeting") %></p>

  4. قم بتشغيل خادم Rails:

    bin/rails server

  5. انتقل إلى عناوين URL التالية: