i18next JSON çevirilerinizi Intlayer ile 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. JavaScript uygulamalarında içerik yönetimine modern bir yaklaşım sunar.

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

Neden Intlayer'ı i18next ile Birleştirmelisiniz?

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

1. Mevcut kod tabanı: Yerleşik bir i18next uygulamanız var ve Intlayer'ın geliştirilmiş geliştirici deneyimine kademeli olarak geçmek istiyorsunuz.
2. Eski gereksinimler: Projeniz mevcut i18next eklentileri veya iş akışları ile uyumluluk gerektiriyor.
3. Ekip aşinalığı: Ekibiniz i18next ile rahat ancak daha iyi içerik yönetimi istiyor.

Bunun için, Intlayer i18next için bir adaptör olarak uygulanabilir; bu, JSON çevirilerinizi CLI veya CI/CD boru hatlarında otomatikleştirmenize, çevirilerinizi test etmenize ve daha fazlasına yardımcı olur.

Bu rehber, Intlayer'ın üstün içerik beyan sistemi avantajlarından yararlanırken i18next ile uyumluluğu nasıl koruyacağınızı gösterir.

İçindekiler

Adım Adım Intlayer'ı i18next ile Kurma Rehberi

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

Gerekli paketleri yükleyin:

npm install intlayer @intlayer/sync-json-plugin

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ı i18next uyumlu JSON formatına 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:

Ayrıca i18next için JSON sözlükleri 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 }) => `./intl/messages/${locale}/${key}.json`,    }),  ],};export default config;

syncJSON eklentisi JSON'u otomatik olarak sarar. İçerik mimarisini değiştirmeden JSON dosyalarını okur ve yazar.

Eğer JSON dosyalarının intlayer içerik beyan dosyaları (.content dosyaları) ile birlikte var olmasını istiyorsanız, Intlayer şu şekilde ilerler:

1. Hem JSON hem de içerik beyan dosyalarını yükler ve bunları 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 (hepsi yapılandırılabilir).

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

Git Yapılandırması

Otomatik oluşturulan Intlayer dosyalarını görmezden gelmeniz önerilir:

# Intlayer tarafından oluşturulan dosyaları görmezden gel.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 yükleyin:

VS Code Marketplace'ten Yükleyin

VS Code Marketplace'ten Yükleyin