Creation:2025-08-23Last update:2025-08-23

    Intlayer Dokümantasyonu

    Resmi Intlayer dokümantasyonuna hoş geldiniz! Burada, Next.js, React, Vite, Express veya başka bir JavaScript ortamı kullanıyor olsanız da, tüm uluslararasılaştırma (i18n) ihtiyaçlarınız için Intlayer'ı entegre etmek, yapılandırmak ve ustalaşmak için ihtiyacınız olan her şeyi bulacaksınız.

    Giriş

    Intlayer Nedir?

    Intlayer, özellikle JavaScript geliştiricileri için tasarlanmış bir uluslararasılaştırma kütüphanesidir. İçeriğinizin tanımını kodunuzun her yerinde yapmanıza olanak tanır. Çok dilli içerik tanımlarını kodunuza kolayca entegre etmek için yapılandırılmış sözlüklere dönüştürür. TypeScript kullanarak Intlayer, geliştirme sürecinizi daha güçlü ve verimli hale getirir.

    Intlayer ayrıca, içeriğinizi kolayca düzenlemenize ve yönetmenize olanak tanıyan isteğe bağlı bir görsel düzenleyici sağlar. Bu düzenleyici, içerik yönetimi için görsel bir arayüzü tercih eden geliştiriciler veya kod konusunda endişelenmeden içerik üreten ekipler için özellikle yararlıdır.

    Kullanım Örneği

    bash
    .└── Components    └── MyComponent        ├── index.content.ts        └── index.tsx
    src/components/MyComponent/index.content.ts
    import { t, type Dictionary } from "intlayer";

const componentContent = {
  key: "component-key",
  content: {
    myTranslatedContent: t({
      en: "Hello World",
      es: "Hola Mundo",
      fr: "Bonjour le monde",
      tr: "Merhaba Dünya",
    }),
  },
} satisfies Dictionary;

export default componentContent;
    src/components/MyComponent/index.tsx
    import type { FC } from "react";
import { useIntlayer } from "react-intlayer";

export const MyComponent: FC = () => {
  const { myTranslatedContent } = useIntlayer("component-key");

  return <span>{myTranslatedContent}</span>;
};

    Neden alternatifler yerine Intlayer?

    next-intl veya i18next gibi ana çözümlerle karşılaştırıldığında, Intlayer aşağıdaki gibi entegre optimizasyonlarla birlikte gelen bir çözümdür:

    Sayfalarınıza devasa JSON dosyaları yüklemek yerine sadece gerekli içeriği yükleyin. Intlayer, paket ve sayfa boyutlarınızı %50'ye kadar azaltmanıza yardımcı olur.

    Uygulamanızın içeriğini bileşenlerinize yakın konumlandırmak (scoping), büyük ölçekli uygulamalar için bakımı kolaylaştırır. Tüm içerik kod tabanınızı gözden geçirme zihinsel yükü olmadan tek bir özellik klasörünü kopyalayabilir veya silebilirsiniz. Ayrıca, içeriğinizin doğruluğunu sağlamak için Intlayer tamamen tiplidir (fully typed).

    İçeriğin koduyla aynı yerde (co-locate) bulunması, Büyük Dil Modellerinin (LLM'ler) ihtiyaç duyduğu bağlamı azaltır. Intlayer ayrıca eksik çevirileri test etmek için bir CLI, LSP, MCP ve yapay zeka aracıları için geliştirici deneyimini (DX) daha da pürüzsüz hale getirecek aracı yetenekleri (agent skills) gibi bir dizi araçla birlikte gelir.

    Yapay zeka sağlayıcınızın maliyeti üzerinden dilediğiniz LLM'yi kullanarak CI/CD ardışık düzeninizde (pipeline) çeviri yapmak için otomasyonu kullanın. Intlayer ayrıca içerik çıkarma işlemini otomatikleştirmek için bir derleyici (compiler) ve arka planda çeviri yapmanıza yardımcı olacak bir web platformu sunar.

    Büyük JSON dosyalarını bileşenlere bağlamak, performans ve tepkisellik (reactivity) sorunlarına yol açabilir. Intlayer, içeriğinizin yüklenmesini derleme zamanında (build time) optimize eder.

    Intlayer, sadece bir i18n çözümü olmaktan çok daha fazlasıdır; çevirmenler, metin yazarları ve diğer ekip üyeleriyle işbirliğini sorunsuz hale getirerek çok dilli içeriğinizi gerçek zamanlı yönetmenize yardımcı olacak, kendi sunucunuzda barındırılabilen bir görsel düzenleyici ve tam teşekküllü bir CMS sağlar. İçerik yerel olarak ve/veya uzak sunucularda depolanabilir.

    Ana Özellikler

    Intlayer, modern web geliştirme ihtiyaçlarını karşılamak üzere uyarlanmış çeşitli özellikler sunar. Aşağıda, her biri için ayrıntılı dokümantasyon bağlantılarına sahip temel özellikler yer almaktadır:

    • Uluslararasılaştırma Desteği: Uygulamanızın küresel erişimini yerleşik uluslararasılaştırma desteğiyle artırın.
    • Görsel Düzenleyici: Intlayer için tasarlanmış düzenleyici eklentileriyle geliştirme iş akışınızı geliştirin. Görsel Düzenleyici Kılavuzuna göz atın.
    • Yapılandırma Esnekliği: Kurulumunuzu, Yapılandırma Kılavuzu'nda ayrıntılı olarak açıklanan geniş yapılandırma seçenekleriyle özelleştirin.
    • Gelişmiş CLI Araçları: Projelerinizi Intlayer'ın komut satırı arayüzü ile verimli bir şekilde yönetin. Olanakları CLI Araçları Dokümantasyonu'nda keşfedin.

    Temel Kavramlar

    Sözlük (Dictionary)

    Her şeyi tutarlı ve sürdürülebilir kılmak için çok dilli içeriğinizi kodunuza yakın bir yerde düzenleyin.

    • Başlangıç
      Intlayer'da içeriğinizi bildirmenin temellerini öğrenin.

    • Çeviri (Translation)
      Uygulamanızda çevirilerin nasıl oluşturulduğunu, saklandığını ve kullanıldığını anlayın.

    • Numaralandırma (Enumeration)
      Çeşitli dillerdeki tekrarlanan veya sabit veri setlerini kolayca yönetin.

    • Koşul (Condition)
      Dinamik içerik oluşturmak için Intlayer'da koşullu mantığı nasıl kullanacağınızı öğrenin.

    • Ekleme (Insertion)
      Yer tutucuları kullanarak bir dizeye nasıl değer ekleyeceğinizi keşfedin.

    • Fonksiyon Alma (Function Fetching)
      Projenizin iş akışıyla uyumlu olacak şekilde içeriği özel mantıkla dinamik olarak nasıl alacağınızı görün.

    • Markdown
      Zengin içerik oluşturmak için Intlayer'da Markdown'ı nasıl kullanacağınızı öğrenin.

    • Dosya Gömmeleri (File embeddings)
      İçerik düzenleyicide kullanmak üzere dış dosyaları Intlayer'a nasıl gömeceğinizi keşfedin.

    • İç İçe Yerleştirme (Nesting)
      Karmaşık yapılar oluşturmak için Intlayer'da içeriği nasıl iç içe yerleştireceğinizi anlayın.

    Ortamlar ve Entegrasyonlar

    Intlayer'ı esnekliği göz önünde bulundurarak geliştirdik; popüler çerçeveler ve derleme araçlarıyla sorunsuz entegrasyon sağlıyoruz:

    Her entegrasyon kılavuzu, hızlı, SEO dostu ve son derece ölçeklenebilir bir uygulama sunabilmeniz için sunucu tarafı oluşturma (SSR), dinamik yönlendirme veya istemci tarafı oluşturma gibi Intlayer'ın özelliklerini kullanmaya yönelik en iyi uygulamaları içerir.

    Katkıda Bulunma ve Geri Bildirim

    Açık kaynağın ve topluluk odaklı gelişimin gücüne değer veriyoruz. İyileştirmeler önermek, yeni bir kılavuz eklemek veya dokümanlarımızdaki herhangi bir sorunu düzeltmek isterseniz, GitHub depomuzda bir Çekme İsteği (Pull Request) göndermekten veya bir Sorun (Issue) açmaktan çekinmeyin.

    Uygulamanızı daha hızlı ve daha verimli bir şekilde çevirmeye hazır mısınız? Bugün Intlayer kullanmaya başlamak için dokümanlarımıza dalın. İçeriğinizi düzenli tutan ve ekibinizi daha üretken kılan güçlü, akıcı bir uluslararasılaştırma yaklaşımını deneyimleyin.

    Neden Intlayer?
    Intlayer Nasıl Çalışır