@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/tr/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v7'ye hoş geldiniz! Bu büyük sürüm, performans, tür güvenliği ve geliştirici deneyiminde önemli iyileştirmeler sunuyor. Aşağıda, geçiş notları ve pratik örneklerle birlikte öne çıkanlar yer almaktadır.
 
+## İçindekiler
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Öne Çıkanlar
 
 - Daha hızlı derlemeler için önbellekleme stratejisi
@@ -260,6 +264,126 @@ Bu, uygulamanız için daha hızlı indirme süreleri ve geliştirilmiş çalı
 
 ---
 
+## Otomatik Kod Biçimlendirmesi: formatCommand configuration
+
+v7, editör yapılandırmasında `formatCommand` seçeneğini tanıtarak, Intlayer tarafından yazıldığında içerik dosyalarını otomatik olarak biçimlendirmenizi sağlar. Bu, içerik bildirimi dosyalarınız arasında tutarlı kod stili ve biçimlendirmesini sağlar.
+
+Ayarlanmadığında, Intlayer biçim komutunu otomatik olarak algılamaya çalışacaktır. Şu komutları çözmeyi deneyerek: prettier, biome, eslint.
+
+### Konfigürasyon
+
+`formatCommand` seçeneği, `{{file}}` ifadesinin gerçek dosya yolu ile değiştirildiği bir string şablonunu kabul eder:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Desteklenen formatters
+
+Dosya yollarını argüman olarak kabul eden herhangi bir kod formatteri kullanabilirsiniz:
+
+**Biome kullanarak:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Prettier kullanarak:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**ESLint kullanarak:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Bun'ın yerleşik formatteri kullanarak:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Faydalar
+
+- **Tutarlı biçimlendirme**: Tüm içerik dosyaları, projenizin stil yönergelerine göre otomatik olarak biçimlendirilir
+- **Geliştirici deneyimi**: Intlayer dosyaları yazdıktan sonra dosyaları manuel olarak biçimlendirmeye gerek yoktur
+- **Takım tutarlılığı**: Tüm takım üyelerinin içerik dosyalarına aynı biçimlendirmenin uygulanmasını sağlar
+- **CI/CD entegrasyonu**: İçerik dosyaları, otomatik iş akışlarında tutarlı biçimlendirmeyi korur
+
+### Nasıl çalışır
+
+Intlayer bir içerik bildirimi dosyasını (`.content.ts`, `.content.js`, vb.) yazdığında veya güncellediğinde, dosya üzerinde belirtilen format komutunu otomatik olarak çalıştırır. `{{file}}` yer tutucu gerçek dosya yolu ile değiştirilir ve komut projenin temel dizininde yürütülür.
+
+---
+
+## Sözlük Yapılandırması: Daha İyi Organizasyon ve Yapı
+
+v7, sözlük ile ilgili ayarlar için daha iyi bir organizasyon ve geliştirilmiş içerik yönetimi sağlayan yeni bir adanmış `dictionary` yapılandırma bölümü sunar.
+
+### Yeni dictionary yapılandırması
+
+`fill` özelliği, `content` bölümünden yeni `dictionary` bölümüne taşınmış, sorumlulukların daha net bir şekilde ayrılmasını sağlamıştır:
+
+**v6 yapılandırması:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**v7 yapılandırması:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Yeni yapının faydaları
+
+- **Daha net organizasyon**: Sözlüğe özgü ayarlar artık bir arada gruplandırılıyor
+- **Daha iyi sorunların ayrılması**: İçerik keşfi vs. sözlük işlemleri açıkça ayrılıyor
+- **Geliştirilmiş bakım kolaylığı**: Sözlükle ilgili konfigürasyonları anlamak ve değiştirmek daha kolay
+- **Gelecekteki genişletilebilirlik**: Sözlük bölümü ek sözlüğe özgü ayarları barındırabiliyor
+- **Kapsamlı sözlük yönetimi**: Yeni sözlükler oluşturmak ve yönetmek için `title`, `live`, `priority`, `tags`, `version` ve `description` gibi özellikleri içeriyor
+
+### Yapılandırma kullanımı
+
+Sözlük yapılandırması iki ana amaca hizmet eder:
+
+1. **Varsayılan Değerler**: İçerik bildirim dosyaları oluştururken varsayılan değerleri tanımlama
+2. **Fallback Davranışı**: Belirli alanlar tanımlanmadığında fallback değerleri sağlama, sözlük işlem davranışını global olarak tanımlamanıza izin verme
+
+Sözlük bölümü, sözlük yönetimi için kapsamlı özellikler içerir:
+
+- **`fill`**: İçerik oluşturma için otomatik doldurma davranışı
+- **`title`**: Yeni sözlükler için varsayılan başlık
+- **`live`**: Gerçek zamanlı güncellemeler için live senkronizasyon yapılandırması
+- **`priority`**: Sözlük çözümlemesi için öncelik ayarları
+- **`tags`**: İçerik organizasyonu için varsayılan etiketler
+- **`version`**: Sözlük güncellemeleri için sürüm yönetimi
+- **`description`**: Yeni içerik için varsayılan açıklama
+
+İçerik bildirim dosyaları ve yapılandırma değerlerinin nasıl uygulandığı hakkında daha fazla bilgi için bkz. [İçerik Dosyası Belgeleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md).
+
+---
+
 ## Fill komutu: Daha iyi içerik yönetimi için güncellenmiş davranış
 
 v7, `fill` komutu için daha öngörülebilir ve esnek içerik yönetimi sağlayan geliştirilmiş bir davranış sunar:
@@ -407,6 +531,10 @@ Sistem otomatik olarak:
 - **`middleware.prefixDefault`**: `routing.mode` ile değiştirildi
 - **`middleware.noPrefix`**: `routing.mode` ile değiştirildi
 
+### Yeni konfigürasyonlar
+
+- **`editor.formatCommand`**: İçerik dosyalarının otomatik kod formatlaması için yeni seçenek
+
 ### Geçiş eşlemesi
 
 #### Konfigürasyon eşlemesi

package/docs/tr/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: "Yeni Intlayer v8 - Yenilikler"
 description: "Intlayer v8'deki yenilikleri keşfedin. Geliştirici deneyiminde otomatik içerik algılama ile iyileştirmeler, şema doğrulamasıyla veri bütünlüğünün sağlanması ve sözlük yönetimi üzerinde daha fazla kontrol sunulmaktadır."
 keywords:
@@ -409,6 +409,16 @@ Daha fazla ayrıntı için [HTML İçerik Dokümantasyonu](https://github.com/ay
 
 ---
 
+## YAML ve Markdown İçerik Dosyaları (v8.10.0)
+
+Artık doğrudan `.content.md` ve `.content.yaml` dosya uzantılarını kullanarak içerik tanımlayabilirsiniz. Bu, uzun biçimli içerikler, bloglar, dokümantasyonlar ve gizlilik politikaları için mükemmeldir.
+
+Bu dosyalar Görsel Editör (Visual Editor) üzerinden tamamen düzenlenebilir, böylece teknik olmayan ekip üyeleri için kolaylaştırılmış bir iş akışı sağlanır.
+
+Daha fazla ayrıntı için [YAML İçerik Dosyaları Dokümantasyonu](https://intlayer.org/tr/doc/concept/content#yaml-content-file) ve [Markdown İçerik Dosyaları Dokümantasyonu](https://intlayer.org/tr/doc/concept/content/markdown) sayfalarına bakın.
+
+---
+
 ## Özel URL Yeniden Yazımları
 
 Intlayer v8, standart `/locale/path` yapısından farklı olan dile özgü yollar tanımlamanıza olanak tanıyan **Özel URL Yeniden Yazımları** desteğini getirir. Bu, yerel SEO'yu iyileştirmek ve İngilizce dışı kullanıcılar için daha doğal bir kullanıcı deneyimi sağlamak açısından güçlü bir özelliktir.
@@ -753,6 +763,58 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR Çoğul Kuralları (v8.8.0)
+
+Karmaşık diller için desteği artıran, Unicode CLDR Projesi tarafından tanımlanan çoğul kurallarına dayalı yeni bir `plural` düğüm yardımcısı (helper) tanıtıldı.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+Daha sonra framework bileşeninizde sayıyı dinamik olarak geçirebilirsiniz:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* In English:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+Daha fazla bilgi için [Çoğullaştırma Dokümantasyonu](https://intlayer.org/tr/doc/concept/content/plural) sayfasına bakın.
+
+---
+
 ## İçerik Şeması Doğrulama
 
 Intlayer v8, sözlükler için şema doğrulamasını tanıtır. Artık yapılandırmanızda Zod kullanarak yeniden kullanılabilir doğrulama şemaları tanımlayabilir ve bunları içerik dosyalarınıza uygulayabilirsiniz. Bu, içeriğinizin her zaman beklenen yapıya uygun olmasını sağlar ve hataları build zamanında yakalar.
@@ -797,6 +859,34 @@ Eğer içerik şemayla eşleşmezse (ör. başlık çok kısaysa), build süreci
 
 ---
 
+## TypeScript: IntlayerNode İlkel Erişimcileri (Primitive Accessors)
+
+`IntlayerNode` tipi, ilkel JavaScript metotlarının doğrudan içerik düğümleri üzerinde çağrılmasına izin verecek şekilde güncellendi. Bu, yerelleştirilmiş içeriğinizle doğrudan standart bir string, number, boolean veya array ilkel tipiymiş gibi etkileşime girmenizi mümkün kılar.
+
+React, Preact, Solid, Svelte, Vue ve Angular genelinde desteklenir.
+
+### String Örneği
+
+```typescript
+content.placeholder; // IntlayerNode<string> döner
+content.placeholder.value; // string döner
+content.placeholder.toString(); // string döner
+content.placeholder.toLowerCase(); // string döner
+String(content.placeholder); // string döner
+content.placeholder.toUpperCase(); // Büyük harfe dönüştürülmüş string döner
+content.placeholder.replace("a", "b"); // Değiştirilmiş string döner
+```
+
+### Array Örneği
+
+```typescript
+content.myArrayOfString             // IntlayerNode<Array<string>> döner
+content.myArrayOfString.find(...)   // Eleman döner
+content.myArrayOfString.join(', ')  // Birleştirilmiş string döner
+```
+
+---
+
 ### Geliştirilmiş Otomatik İçerik Algılama
 
 v8'de Intlayer, içerik dizelerinizde Markdown sözdizimini, HTML etiketlerini ve değişken yerleştirmelerini akıllıca algılar. Bu, genellikle `md()`, `html()` veya `insert()` gibi yardımcı fonksiyonları atlamanıza olanak tanır.
@@ -1002,6 +1092,17 @@ Intlayer VSCode uzantısı, uluslararasılaştırma iş akışınızı kolaylaş
 
 ---
 
+## Araçlar: C++ Watcher ve OXC Tabanlı LSP (v8.12.0)
+
+Intlayer v8.12.0, geliştirici deneyimine büyük iyileştirmeler getiriyor:
+
+- **Parcel Watcher**: İçerik izleyici (content watcher), daha hızlı güncellemeler sağlamak ve bellek tüketimini önemli ölçüde azaltmak için yerel C++ dosya izlemeden yararlanan `@parcel/watcher` paketine `chokidar`'dan taşındı.
+- **Yeni Language Server Protocol (LSP)**: Yepyeni bir LSP artık kullanılabilir. OXC tabanlı ayrıştırma ile oluşturulan bu protokol, IDE'nizin ve yapay zeka ajanlarınızın `useIntlayer('my-key')` çağrılarını ilgili `.content` dosyalarıyla ve tersi şekilde sorunsuz bir şekilde ilişkilendirmesine yardımcı olur.
+
+Daha fazla ayrıntı için [LSP Dokümantasyonu](https://intlayer.org/tr/doc/lsp) sayfasına bakın.
+
+---
+
 ## Derleyici Optimizasyonları
 
 Intlayer v8, Markdown ve HTML derleyicisi için yeni bir önbellekleme katmanı içerir. Bu, aynı yapılandırmaya sahip özdeş içerik dizelerinin yalnızca bir kez ayrıştırılmasını sağlar; bu da yeniden render'lar sırasında veya aynı içeriğin birden çok yerde kullanılması durumunda genel yükü önemli ölçüde azaltır.
@@ -1057,6 +1158,48 @@ Intlayer v8, Markdown ve HTML derleyicisi için yeni bir önbellekleme katmanı
 
 ---
 
+## Deneysel Build Optimizasyonları: Minify ve Purge (v8.7.0)
+
+Intlayer v8.7.0, üretim (production) bundle'ınızı optimize etmek için tasarlanmış, `intlayer.config.ts` dosyanızda kullanabileceğiniz yeni deneysel build özellikleri sunar:
+
+- **Sözlük Minifikasyonu (Minification)**: Boyutu azaltmak için sözlük dosyalarını küçültür (minify eder).
+- **Kullanılmayan Anahtarları Temizleme (Purging)**: Sözlüklerden kullanılmayan çeviri anahtarlarını tarar ve kaldırır, aktif anahtarları kısa karakterlere yeniden adlandırır (örneğin `"products" -> "a"`, `"pricing" -> "b"`). Bu, bundle boyutunu %5'e kadar azaltır.
+- **TypeScript Kontrollerini Devre Dışı Bırakma**: Derleme adımı sırasında TypeScript tip kontrolünü (typechecking) devre dışı bırakarak build işlemlerini hızlandırır.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * Minify the dictionaries to reduce the bundle size.
+     */
+    minify: true,
+
+    /**
+     * Purge the unused keys in dictionaries
+     */
+    purge: true,
+
+    /**
+     * Indicates if the build should check TypeScript types
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Esneklik: Birleştirilmiş İçe Aktarma Modu
 
 `live` boolean özelliği, daha kapsamlı olan `importMode` özelliği lehine kullanımdan kaldırıldı. Bu, sözlüklerin nasıl yükleneceğini açıkça tanımlamanıza olanak tanır: statik olarak, dinamik olarak veya canlı senkronizasyon ile.
@@ -1204,6 +1347,49 @@ Svelte'deki Markdown ve HTML içerikleri artık stringleştirildiklerinde otomat
 
 ---
 
+## Angular Desteği: Vite Bundler (v8.11.0)
+
+Angular kullanıcıları için Intlayer, artık yeni bir özel esbuild eklentisi aracılığıyla Vite bundler'ı yerel olarak destekleyerek geliştirme ve derleme (build) sürelerini hızlandırıyor.
+
+Yapılandırma detayları için [Angular Ortam Dokümantasyonu](https://intlayer.org/tr/doc/environment/angular) sayfasına bakın.
+
+---
+
+## Site Haritası (Sitemap) Oluşturma (v8.6.0)
+
+Intlayer artık dillerinize (locales) ve yönlendirme (routing) modunuza göre otomatik olarak site haritaları oluşturuyor. Bu, özellikle TanStack Router gibi yönlendirici mimarilerinde SEO optimizasyonu için son derece kullanışlıdır:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## v7'den geçiş notları
 
 ### Yapılandırma Değişiklikleri