آموزش بومی سازی در برنامه نویسی اورلیا

آموزش بومی سازی در برنامه نویسی اورلیا

در این درس از مجموعه آموزش برنامه نویسی سایت سورس باران، به آموزش بومی سازی در برنامه نویسی اورلیا خواهیم پرداخت.

اورلیا پلاگین i18n را ارائه می دهد. در این درس، شما می آموزید که چگونه برنامه خود را با استفاده از این افزونه بومی سازی کنید.

مرحله ۱ – نصب یک پلاگین

پنجره خط فرمان را باز کرده و کد زیر را برای نصب پلاگین i18n اجرا کنید.

C:\Users\username\Desktop\aureliaApp>jspm install aurelia-i18n

ما همچنین باید پلاگین backend را نصب کنیم.

C:\Users\username\Desktop\aureliaApp>jspm install npm:i18next-xhr-backend

مرحله ۲ – ایجاد پوشه ها و پرونده ها

در پوشه root پروژه، ما باید یک فهرست محلی ایجاد کنیم.

C:\Users\username\Desktop\aureliaApp>mkdir locale

در این پوشه ، شما باید پوشه های جدید را برای هر زبانی که می خواهید اضافه کنید. ما با فایل translation.js در داخل ایجاد خواهیم کرد.

C:\Users\username\Desktop\aureliaApp\locale>mkdir en
C:\Users\username\Desktop\aureliaApp\locale\en>touch translation.json

مرحله ۳ – از یک پلاگین استفاده کنید

برای استفاده از این افزونه باید از بوت استروپ دستی استفاده کنید. برای اطلاعات بیشتر فصل پیکربندی را بررسی کنید. ما باید پلاگین i18n را به پرونده main.js اضافه کنیم.

main.js

import {I18N} from 'aurelia-i18n';
import XHR from 'i18next-xhr-backend';

export function configure(aurelia) {
   aurelia.use
   .standardConfiguration()
   .developmentLogging()
    
   .plugin('aurelia-i18n', (instance) => {
      // register backend plugin
      instance.i18next.use(XHR);

      // adapt options to your needs (see http://i18next.com/docs/options/)
      instance.setup({
         backend: {                                  
            loadPath: '/locales/{{lng}}/{{ns}}.json',
         },
                
         lng : 'de',
         attributes : ['t','i18n'],
         fallbackLng : 'en',
         debug : false
      });
   });

   aurelia.start().then(a => a.setRoot());
}

مرحله ۴ – ترجمه فایل JSON

این فایلی است که می توانید مقادیر ترجمه را در آن تنظیم کنید. ما از یک اسناد رسمی استفاده خواهیم کرد. پوشه de-DE در واقع باید برای ترجمه به زبان آلمانی استفاده شود ، با این حال ما برای درک بهتر از عبارات انگلیسی استفاده خواهیم کرد.

{
   "score": "Score: {{score}}",
   "lives": "{{count}} life remaining",
   "lives_plural": "{{count}} lives remaining",
   "lives_indefinite": "a life remaining",
   "lives_plural_indefinite": "some lives remaining",
   "friend": "A friend",
   "friend_male": "A boyfriend",
   "friend_female": "A girlfriend"
}

مرحله ۵ – تنظیم محل

ما فقط باید پلاگین i18n را وارد کنیم و تنظیم کنیم که از کد JSON از پوشه de-DE استفاده کند.

app.js

import {I18N} from 'aurelia-i18n';

export class App {
   static inject = [I18N];
    
   constructor(i18n) {
      this.i18n = i18n;
      this.i18n
      .setLocale('de-DE')
        
      .then( () => {
         console.log('Locale is ready!');
      });
   }
}

مرحله ۶ – نمایش

چند روش برای ترجمه داده وجود دارد. ما از ValueConverter سفارشی به نام t استفاده خواهیم کرد. در مثال زیر می توانید روش های مختلف قالب بندی داده ها را مشاهده کنید. این را با فایل translation.json مقایسه کنید و الگوهای مورد استفاده برای قالب بندی را مشاهده خواهید کرد.

<template>
   <p>
      Translation with Variables: <br />
      ${ 'score' | t: {'score': 13}}
   </p>

   <p>
      Translation singular: <br />
      ${ 'lives' | t: { 'count': 1 } }
   </p>

   <p>
      Translation plural: <br />
      ${ 'lives' | t: { 'count': 2 } }
   </p>

   <p>  
      Translation singular indefinite: <br />
      ${ 'lives' | t: { 'count': 1, indefinite_article: true  } }
   </p>

   <p>
      Translation plural indefinite: <br />
      ${ 'lives' | t: { 'count': 2, indefinite_article: true } }
   </p>

   <p>
      Translation without/with context: <br />
      ${ 'friend' | t } <br />
      ${ 'friend' | t: { context: 'male' } } <br />
      ${ 'friend' | t: { context: 'female' } }
   </p>
    
</template>

وقتی برنامه را اجرا می کنیم، خروجی زیر را خواهیم گرفت.

منبع.

لیست جلسات قبل آموزش برنامه نویسی اورلیا

1. آموزش برنامه نویسی اورلیا
2. بررسی اجمالی برنامه نویسی اورلیا 
3. آموزش تنظیمات محیطی در برنامه نویسی اورلیا 
4.  آموزش اولین برنامه در برنامه نویسی اورلیا
5. آموزش اجزا در برنامه نویسی اورلیا
6. آموزش چرخه زندگی کامپوننت در برنامه نویسی اورلیا
7. آموزش عناصر سفارشی در برنامه نویسی اورلیا
8. آموزش تزریق وابستگی در برنامه نویسی اورلیا
9. آموزش پیکربندی در برنامه نویسی اورلیا
10. آموزش پلاگین ها در برنامه نویسی اورلیا
11. آموزش اتصال داده ها در برنامه نویسی اورلیا
12. آموزش رفتار اتصال در برنامه نویسی اورلیا
13. آموزش مبدل ها در برنامه نویسی اورلیا
14. آموزش رویدادها در برنامه نویسی اورلیا
15. آموزش گردآورنده رویداد در برنامه نویسی اورلیا
16. آموزش فرم ها در برنامه نویسی اورلیا
17. آموزش HTTP در برنامه نویسی اورلیا
18. آموزش رفرنس ها در در برنامه نویسی اورلیا
19. آموزش مسیریابی در برنامه نویسی اورلیا
20. آموزش تاریخچه در برنامه نویسی اورلیا
21. آموزش انیمیشن ها در برنامه نویسی اورلیا
22. آموزش dialog در برنامه نویسی اورلیا
23. آموزش بومی سازی در برنامه نویسی اورلیا
24. آموزش ابزارها در برنامه نویسی اورلیا
25. آموزش بسته بندی در برنامه نویسی اورلیا
26. آموزش اشکال زدایی در برنامه نویسی اورلیا
27.  جامعه برنامه نویسی اورلیا