Intlayer kullanarak react-i18next JSON çevirilerinizi nasıl otomatikleştirirsiniz

Intlayer nedir?

Intlayer, geleneksel i18n çözümlerinin eksikliklerini gidermek için tasarlanmış yenilikçi, açık kaynaklı bir uluslararasılaştırma kütüphanesidir. React uygulamalarında içerik yönetimi için modern bir yaklaşım sunar.

react-i18next ile somut bir karşılaştırma için react-i18next vs. react-intl vs. Intlayer blog yazımıza bakabilirsiniz.

Neden Intlayer'ı react-i18next ile Birleştirmelisiniz?

Intlayer mükemmel bir bağımsız i18n çözümü sunarken (bakınız React entegrasyon rehberimiz), react-i18next ile birkaç nedenle birleştirmek isteyebilirsiniz:

1. Mevcut kod tabanı: Yerleşik bir react-i18next uygulamanız var ve Intlayer'ın geliştirilmiş geliştirici deneyimine kademeli olarak geçmek istiyorsunuz.
2. Eski gereksinimler: Projeniz mevcut react-i18next eklentileri veya iş akışları ile uyumluluk gerektiriyor.
3. Ekip aşinalığı: Ekibiniz react-i18next ile rahat ancak daha iyi içerik yönetimi istiyor.
4. Intlayer özelliklerini kullanma: İçerik beyanı, çeviri otomasyonu, çevirilerin test edilmesi ve daha fazlası gibi Intlayer özelliklerini kullanmak istiyorsunuz.

Bunun için, Intlayer, JSON çevirilerinizi CLI veya CI/CD boru hatlarında otomatikleştirmeye, çevirilerinizi test etmeye ve daha fazlasına yardımcı olmak için react-i18next için bir adaptör olarak uygulanabilir.

Bu rehber, Intlayer'ın üstün içerik beyan sistemi kullanılırken react-i18next ile uyumluluğun nasıl korunacağını gösterir.

İçindekiler

Intlayer'ı react-i18next ile Kurmak İçin Adım Adım Rehber

Adım 1: Bağımlılıkları Yükleyin

Gerekli paketleri yükleyin:

npm install intlayer @intlayer/sync-json-plugin --save-devnpx intlayer init

Paket açıklamaları:

• intlayer: Uluslararasılaştırma yönetimi, içerik beyanı ve derleme için temel kütüphane
• @intlayer/sync-json-plugin: Intlayer içerik beyanlarını react-i18next uyumlu JSON formatına dışa aktarmak için eklenti

Adım 2: JSON'u sarmak için Intlayer eklentisini uygulayın

Desteklenen yerel ayarları tanımlamak için bir Intlayer yapılandırma dosyası oluşturun:

Eğer react-i18next için JSON sözlüklerini de dışa aktarmak istiyorsanız, syncJSON eklentisini ekleyin:

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 }) => `./locales/${locale}/${key}.json`,    }),  ],};export default config;

syncJSON eklentisi JSON'u otomatik olarak saracaktır. İçerik mimarisini değiştirmeden JSON dosyalarını okuyup yazacaktır.

Eğer bu JSON'u intlayer içerik beyan dosyaları (.content dosyaları) ile birlikte kullanmak isterseniz, Intlayer şu şekilde ilerleyecektir:

1. Hem JSON hem de içerik beyan dosyalarını yükler ve bunları bir intlayer sözlüğüne dönüştürür.2. JSON ile içerik beyan dosyaları arasında çakışma varsa, Intlayer tüm sözlükleri birleştirme işlemi yapar. Bu, eklentilerin önceliğine ve içerik beyan dosyasının önceliğine bağlıdır (tüm bunlar yapılandırılabilir).

CLI kullanılarak JSON'un çevirisi yapılırsa veya CMS kullanılırsa, Intlayer JSON dosyasını yeni çevirilerle güncelleyecektir.

syncJSON eklentisi hakkında daha fazla detay görmek için lütfen syncJSON eklenti dokümantasyonuna bakınız.

(İsteğe Bağlı) Adım 3: Bileşen başına JSON çevirilerini uygulama

Varsayılan olarak, Intlayer hem JSON hem de içerik beyan dosyalarını yükler, birleştirir ve senkronize eder. Daha fazla detay için içerik beyan dokümantasyonuna bakabilirsiniz. Ancak isterseniz, Intlayer eklentisi kullanarak kod tabanınızın herhangi bir yerinde yerelleştirilmiş JSON'un bileşen bazında yönetimini de uygulayabilirsiniz.

Bunun için loadJSON eklentisini kullanabilirsiniz.

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,  },  // Mevcut JSON dosyalarınızı Intlayer sözlükleri ile senkronize tutun  plugins: [    /**     * src içindeki {key}.i18n.json desenine uyan tüm JSON dosyalarını yükler     */    loadJSON({      source: ({ key }) => `./src/**/${key}.i18n.json`,      locale: Locales.ENGLISH,      priority: 1, // Bu JSON dosyalarının `./locales/en/${key}.json` dosyalarından öncelikli olmasını sağlar    }),    /**     * locales dizinindeki JSON dosyalarını yükler ve çıktı ile çevirileri geri yazar     */    syncJSON({      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,      priority: 0,    }),  ],};export default config;

Bu, src dizinindeki {key}.i18n.json desenine uyan tüm JSON dosyalarını yükleyecek ve bunları Intlayer sözlükleri olarak kullanacaktır.

Git Yapılandırması

Otomatik oluşturulan Intlayer dosyalarını yok saymanız önerilir:

# Intlayer tarafından oluşturulan dosyaları yok say.intlayer

Bu dosyalar derleme süreciniz sırasında yeniden oluşturulabilir ve sürüm kontrolüne dahil edilmesi gerekmez.

VS Code Eklentisi

Geliştirici deneyimini iyileştirmek için resmi Intlayer VS Code Eklentisini kurun:

VS Code Marketinden Yükleyin