Internasionalisasi Vue.js (i18n) dengan vue-i18n dan Intlayer

Daftar Isi

Apa itu Intlayer?

Intlayer adalah perpustakaan internasionalisasi sumber terbuka yang inovatif, dirancang untuk mengatasi kekurangan solusi i18n tradisional. Ini menawarkan pendekatan modern untuk manajemen konten dalam aplikasi Vue.js dan Nuxt.

Lihat perbandingan konkret dengan vue-i18n dalam posting blog kami vue-i18n vs. Intlayer.

Mengapa Menggabungkan Intlayer dengan vue-i18n?

Meskipun Intlayer menyediakan solusi i18n mandiri yang sangat baik (lihat panduan integrasi Vue.js), Anda mungkin ingin menggabungkannya dengan vue-i18n untuk beberapa alasan:

1. Basis kode yang ada: Anda memiliki implementasi vue-i18n yang sudah mapan dan ingin secara bertahap bermigrasi ke pengalaman pengembang yang lebih baik dari Intlayer.
2. Persyaratan warisan: Proyek Anda memerlukan kompatibilitas dengan plugin atau alur kerja vue-i18n yang sudah ada.
3. Kenyamanan tim: Tim Anda sudah terbiasa dengan vue-i18n tetapi menginginkan manajemen konten yang lebih baik.
4. Menggunakan fitur Intlayer: Anda ingin menggunakan fitur Intlayer seperti deklarasi konten, otomatisasi terjemahan, pengujian terjemahan, dan lainnya.

Untuk itu, Intlayer dapat diimplementasikan sebagai adaptor untuk vue-i18n guna membantu mengotomatisasi terjemahan JSON Anda di CLI atau pipeline CI/CD, menguji terjemahan Anda, dan lainnya.

Panduan ini menunjukkan cara memanfaatkan sistem deklarasi konten unggulan Intlayer sambil mempertahankan kompatibilitas dengan vue-i18n.

Panduan Langkah demi Langkah untuk Mengatur Intlayer dengan vue-i18n

Langkah 1: Instalasi Dependensi

Instal paket yang diperlukan menggunakan manajer paket pilihan Anda:

npm install intlayer @intlayer/sync-json-plugin

Penjelasan paket:

• intlayer: Perpustakaan inti untuk deklarasi dan manajemen konten
• @intlayer/sync-json-plugin: Plugin untuk menyinkronkan deklarasi konten Intlayer ke format JSON vue-i18n

Langkah 2: Terapkan plugin Intlayer untuk membungkus JSON

Buat file konfigurasi Intlayer untuk mendefinisikan locale yang didukung:

Jika Anda juga ingin mengekspor kamus JSON untuk vue-i18n, tambahkan plugin syncJSON:

import { Locales, type IntlayerConfig } from "intlayer";import { syncJSON } from "@intlayer/sync-json-plugin";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],    defaultLocale: Locales.ENGLISH,  },  plugins: [    syncJSON({      source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,    }),  ],};export default config;

Plugin syncJSON akan secara otomatis membungkus JSON. Plugin ini akan membaca dan menulis file JSON tanpa mengubah arsitektur kontennya.

Jika Anda ingin membuat JSON tersebut berdampingan dengan file deklarasi konten intlayer (.content files), Intlayer akan memprosesnya dengan cara berikut:

1. memuat baik file JSON maupun file deklarasi konten dan mengubahnya menjadi kamus intlayer.2. jika terdapat konflik antara file JSON dan file deklarasi konten, Intlayer akan melakukan penggabungan dari semua kamus tersebut. Bergantung pada prioritas plugin, dan prioritas file deklarasi konten (semua dapat dikonfigurasi).

Jika perubahan dilakukan menggunakan CLI untuk menerjemahkan JSON, atau menggunakan CMS, Intlayer akan memperbarui file JSON dengan terjemahan baru.

Untuk melihat lebih detail tentang plugin syncJSON, silakan merujuk ke dokumentasi plugin syncJSON.

(Opsional) Langkah 3: Implementasikan terjemahan JSON per-komponen

Secara default, Intlayer akan memuat, menggabungkan, dan menyinkronkan baik file JSON maupun file deklarasi konten. Lihat dokumentasi deklarasi konten untuk detail lebih lanjut. Namun jika Anda lebih memilih, dengan menggunakan plugin Intlayer, Anda juga dapat mengimplementasikan manajemen JSON per-komponen yang dilokalkan di mana saja dalam basis kode Anda.

Untuk itu, Anda dapat menggunakan plugin loadJSON.

import { Locales, type IntlayerConfig } from "intlayer";import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],    defaultLocale: Locales.ENGLISH,  },  // Jaga agar file JSON Anda saat ini tetap sinkron dengan kamus Intlayer  plugins: [    /**     * Akan memuat semua file JSON di src yang cocok dengan pola {key}.i18n.json     */    loadJSON({      source: ({ key }) => `./src/**/${key}.i18n.json`,      locale: Locales.ENGLISH,      priority: 1, // Memastikan file JSON ini memiliki prioritas lebih tinggi dibanding file di `./locales/en/${key}.json`    }),    /**     * Akan memuat, dan menulis output serta terjemahan kembali ke file JSON di direktori locales     */    syncJSON({      source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,      priority: 0,    }),  ],};export default config;

Ini akan memuat semua file JSON di direktori src yang cocok dengan pola {key}.i18n.json dan memuatnya sebagai kamus Intlayer.

Konfigurasi Git

Kecualikan file yang dihasilkan dari kontrol versi:

# Abaikan file yang dihasilkan oleh Intlayer.intlayerintl

File-file ini secara otomatis dibuat ulang selama proses build dan tidak perlu dikomit ke repositori Anda.

Ekstensi VS Code

Untuk pengalaman pengembang yang lebih baik, pasang Ekstensi VS Code Intlayer resmi:

Pasang dari VS Code Marketplace