@intlayer/docs 9.1.3 → 9.3.0

package/blog/ru/index.md

@@ -1,5 +1,5 @@
 ---
-createdAt: 2024-24-12
+createdAt: 2024-12-24
 updatedAt: 2025-06-29
 title: Блог
 description: Узнайте о всех темах, связанных с Intlayer, интернационализацией и другими

package/blog/ru/rag_powered_documentation_assistant.md

@@ -313,6 +313,13 @@ RAG, один из самых простых и мощных способов с
 </Step>
 
 </Steps>
+
+## Упростите сложность с Sanity
+
+Sanity стоит упомянуть здесь как вариант CMS, на который указывает статья. В то время как файлы Markdown требуют произвольного разделения токенов — с компромиссами размера блока и перекрытия, которые описывает статья — Content Lake Sanity хранит документацию как типизированные JSON-документы, определённые схемой. Каждое поле, заголовок и блок контента уже являются семантической единицей, что означает, что RAG-поиск работает на значимых границах, а не на приблизительных подсчётах токенов.
+
+Язык запросов GROQ в Sanity позволяет получить ровно те поля документа, которые релевантны для запроса пользователя — название, текст, связанные разделы — без загрузки всего документа. MCP-сервер подключает Content Lake напрямую к AI-агентам, поэтому структурированный контент, который питает ваш документационный сайт, также питает ваш RAG-pipeline без отдельного этапа приёма данных.
+
 ## Заключение
 
 RAG — один из самых простых и мощных способов сделать LLM практичными. Комбинируя **поиск + генерацию**, вы можете превратить статичную документацию в **умного помощника** и одновременно получить постоянный поток информации о продукте.

package/blog/tr/intlayer_with_react-intl.md

@@ -29,7 +29,9 @@ history:
 author: aymericzip
 ---
 
-# React-intl JSON çevirilerinizi Intlayer kullanarak nasıl otomatikleştirirsiniz
+# Intlayer kullanarak react-intl JSON çevirilerinizi nasıl otomatikleştirilebilir
+
+<iframe title="How to automate your react-intl JSON translations using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 ## İçindekiler
 

package/blog/tr/next-i18next_vs_next-intl_vs_intlayer.md

@@ -73,14 +73,20 @@ Bu rehber, **Next.js** için yaygın olarak kullanılan üç i18n seçeneğini k
 
 ---
 
-## Derinlemesine karşılaştırma
+## Giriş
 
-### 1) Mimari ve ölçeklenebilirlik
+Next.js, uluslararasılaştırılmış routing (örneğin, locale segmentleri) için yerleşik destek sağlar. Ancak bu özellik kendi başına çeviriler yapmaz. Yine de kullanıcılarınıza yerelleştirilmiş içerik sunmak için bir kütüphaneye ihtiyacınız vardır.
 
-- **next-intl / next-i18next**: Yerel başına **merkezi kataloglara** varsayılan (i18next'te **ad alanları** artı). Başlangıçta iyi çalışır, ancak artan bağlantı ve anahtar karmaşasıyla genellikle büyük bir paylaşılan yüzey alanı haline gelir.
-- **Intlayer**: **Bileşen başına** (veya özellik başına) sözlükleri **hizmet ettikleri kodla birlikte** teşvik eder. Bu, bilişsel yükü azaltır, UI parçalarının çoğaltılmasını/migrasyonunu kolaylaştırır ve ekip arası çatışmaları azaltır. Kullanılmayan içerik doğal olarak daha kolay tespit edilir ve temizlenir.
+Birçok i18n kütüphanesi mevcuttur, ancak günümüzde Next.js dünyasında üçü popüler hale gelmektedir: next-i18next, next-intl ve Intlayer.
 
-**Neden önemli:** Büyük kod tabanlarında veya tasarım sistemi kurulumlarında, **modüler içerik** monolitik kataloglardan daha iyi ölçeklenir.
+---
+
+## Mimari & ölçeklenebilirlik
+
+- **next-intl / next-i18next**: Varsayılan olarak dile göre **merkezi katologlar** kullanır (plus i18next'te **namespaces**). Başlangıçta iyi çalışır, ancak artan coupling ve key churn ile büyük bir paylaşılan surface area haline gelebilir.
+- **Intlayer**: **bileşen başına** (veya özellik başına) sözlükleri **hizmet ettikleri kod ile birlikte** yerleştirmeyi teşvik eder. Bu, bilişsel yükü azaltır, UI parçalarının çoğaltılmasını/göç edilmesini kolaylaştırır ve takımlar arası çatışmaları azaltır. Kullanılmayan içerik doğal olarak tanımlanması ve kaldırılması daha kolaydır.
+
+**Neden önemli:** Büyük codebases veya design-system kurulumlarında, **modüler içerik** monolitik kataloğlardan daha iyi ölçeklenir.
 
 ---
 
@@ -153,40 +159,132 @@ Kütüphanenin fallback'leri nasıl işlediği de önemlidir. Uygulamanın varsa
 
 ---
 
-### 2) TypeScript ve güvenlik
+## TypeScript & güvenlik
+
+<Columns>
+  <Column>
+
+**next-i18next**
+
+- Hook'lar için temel typings. **katı anahtar typing ekstra araç/yapılandırma gerektirir**.
 
-- **next-intl**: Sağlam TypeScript desteği, ancak **anahtarlar varsayılan olarak katı şekilde yazılmaz**; güvenliği manuel olarak sürdüreceksiniz.
-- **next-i18next**: Hook'lar için temel yazımlar; **katı anahtar yazımı ekstra araç/yapılandırma gerektirir**.
-- **Intlayer**: İçeriğinizden **katı türler oluşturur**. **IDE otomatik tamamlama** ve **derleme zamanı hataları** dağıtım öncesi yazım hatalarını ve eksik anahtarları yakalar.
+  </Column>
+  <Column>
+
+**next-intl**
 
-**Neden önemli:** Güçlü yazım, başarısızlıkları **sol** (CI/derleme) yerine **sağ** (çalışma zamanı) kaydırır.
+- Sağlam TypeScript desteği, ancak **anahtarlar varsayılan olarak katı şekilde yazılmaz**. güvenlik desenlerini manuel olarak korumanız gerekecektir.
+
+  </Column>
+  <Column>
+
+**intlayer**
+
+- **İçeriğinizden katı türler oluşturur**. **IDE otomatik tamamlama** ve **derleme zamanı hataları** yazım hatalarını ve eksik anahtarları deploy'dan önce yakalar.
+
+  </Column>
+
+</Columns>
+
+**Neden önemli:** Güçlü typing hataları **sola** (CI/build) kaydırır, **sağa** (runtime) değil.
 
 ---
 
-### 3) Eksik çeviri işleme
+## Eksik çeviri işleme
+
+<Columns>
+  <Column>
+
+**next-i18next**
+
+- **Runtime fallbacks** kullanır. Build başarısız olmaz.
+
+  </Column>
+  <Column>
+
+**next-intl**
+
+- **Runtime fallbacks** kullanır. Build başarısız olmaz.
 
-- **next-intl / next-i18next**: **Çalışma zamanı geri dönüşlerine** güvenir (örneğin, anahtarı göster veya varsayılan yerel). Derleme başarısız olmaz.
-- **Intlayer**: **Derleme zamanı algılama** ile eksik yerel veya anahtarlar için **uyarılar/hatalar**.
+  </Column>
+  <Column>
 
-**Neden önemli:** Derleme sırasında boşlukları yakalamak, üretimde "gizemli dizeler"i önler ve katı sürüm kapılarıyla uyumlu hale getirir.
+**intlayer**
+
+- Eksik locale'ler veya anahtarlar için **build-time detection** ile **uyarılar/hatalar** verir.
+
+  </Column>
+
+</Columns>
+
+**Neden önemlidir:** Build sırasındaki boşlukları yakalamak, üretimde 'undefined' stringleri önler.
 
 ---
 
-### 4) Yönlendirme, ara yazılım ve URL stratejisi
+## Yönlendirme, middleware & URL stratejisi
 
-- Üçü de App Router'da **Next.js yerelleştirilmiş yönlendirme** ile çalışır.
-- **Intlayer**, **i18n ara yazılımı** (üstbilgi/çerezler aracılığıyla yerel algılama) ve yerelleştirilmiş URL'ler ve `<link rel="alternate" hreflang="…">` etiketleri oluşturmak için **yardımcılarla** daha da ileri gider.
+<Columns>
+  <Column>
+
+**next-i18next**
+
+- Yerelleştirilmiş yönlendirmeye izin verir. Ancak middleware yerleşik değildir.
+
+  </Column>
+  <Column>
+
+**next-intl**
 
-**Neden önemli:** Daha az özel yapıştırıcı katman; yerel genelinde **tutarlı UX** ve **temiz SEO**.
+- Yerelleştirilmiş yönlendirmeye izin verir.
+- Middleware sağlar.
+
+  </Column>
+  <Column>
+
+**intlayer**
+
+- Yerelleştirilmiş yönlendirmeye izin verir.
+- Middleware sağlar.
+
+  </Column>
+
+</Columns>
+
+**Neden önemli:** SEO ve keşif için, ayrıca kullanıcı deneyimi için yardımcı olur.
 
 ---
 
-### 5) Sunucu Bileşenleri (RSC) uyumu
+## Server Components (RSC) hizalaması
 
-- **Hepsi** Next.js 13+'yı destekler.
-- **Intlayer**, RSC için tasarlanmış tutarlı API ve sağlayıcılarla **sunucu/istemci sınırını** yumuşatır, böylece formatlayıcıları veya t-fonksiyonlarını bileşen ağaçları aracılığıyla taşımazsınız.
+<Columns>
+  <Column>
+
+**next-i18next**
 
-**Neden önemli:** Hibrit ağaçlarda daha temiz zihinsel model ve daha az uç durum.
+- Sayfa ve layout server bileşenlerini destekler.
+- Alt server bileşenleri için senkron API sağlamaz.
+
+  </Column>
+  <Column>
+
+**next-intl**
+
+- Sayfa ve layout server bileşenlerini destekler.
+- Alt server bileşenleri için senkron API sağlamaz.
+
+  </Column>
+  <Column>
+
+**intlayer**
+
+- Sayfa ve layout server bileşenlerini destekler.
+- Alt server bileşenleri için senkron API sağlar.
+
+  </Column>
+
+</Columns>
+
+**Neden önemlidir:** Server component desteği Next.js 13+ sürümünün önemli bir özelliğidir ve performans için yardımcıdır. Ebeveyn server bileşenlerinden çocuk server bileşenlerine locale veya `t` fonksiyonunu props olarak geçirmek, bileşenlerinizi daha az yeniden kullanılabilir hale getirir.
 
 ---
 
@@ -297,14 +395,10 @@ Uygulama yapısı, codebase'iniz için iyi bir bakım alabilirliği sağlamak a
   </Tab>
 </Tabs>
 
-### 6) Performans ve yükleme davranışı
-
-- **next-intl / next-i18next**: **Ad alanları** ve **rota düzeyinde bölmeler** aracılığıyla kısmi kontrol; disiplin kayarsa kullanılmayan dizeleri paketleme riski.
-- **Intlayer**: **Derleme zamanında ağaç sallar** ve **sözlük/yere göre tembel yükler**. Kullanılmayan içerik gönderilmez.
+#### Karşılaştırma
 
-**Neden önemli:** Özellikle çok yerel sitelerde daha küçük paketler ve daha hızlı başlatma.
-
----
+- **next-intl / next-i18next**: Merkezi kataloglar (JSON; namespaces/messages). Net yapı, çeviri platformlarıyla iyi entegrasyon sağlar, ancak uygulamalar büyüdükçe dosyalar arası daha fazla düzenlemeye yol açabilir.
+- **Intlayer**: Bileşenlerle birlikte bulunan `.content.{ts|js|json}` sözlükleri. Bileşen yeniden kullanımını ve yerel akıl yürütmeyi kolaylaştırır; dosya ekler ve derleme zamanı araçlarına bağlıdır.
 
 #### Kurulum ve İçerik Yükleme
 
@@ -658,14 +752,15 @@ export default LandingPage;
   </Tab>
 </Tabs>
 
-### 7) DX, araçlar ve bakım
+#### Karşılaştırma
 
-- **next-intl / next-i18next**: Genellikle çeviriler ve düzenleme iş akışları için harici platformları bağlayacaksınız.
-- **Intlayer**: **Ücretsiz Görsel Düzenleyici** ve **isteğe bağlı CMS** (Git dostu veya dışa aktarılmış) gönderir. Artı içerik yazımı için **VSCode uzantısı** ve kendi sağlayıcı anahtarlarınızı kullanarak **AI destekli çeviriler**.
+Üçü de yerel başına içerik yükleme ve sağlayıcıları destekler.
 
-**Neden önemli:** Operasyon maliyetini düşürür ve geliştiriciler ile içerik yazarları arasındaki döngüyü kısaltır.
+- **next-intl/next-i18next** ile, tipik olarak seçili mesajları/namespace'leri rota başına yükler ve sağlayıcıları gerekli yerlere yerleştirirsiniz.
 
----
+- **Intlayer** ile, kullanımı çıkarmak için derleme zamanı analizini ekler, bu da manuel bağlantıları azaltabilir ve tek bir kök sağlayıcı kullanılmasını sağlayabilir.
+
+Ekip tercihine göre açık kontrol ile otomasyon arasında seçim yapın.
 
 ### İstemci bileşeninde kullanım
 
@@ -831,11 +926,20 @@ const ClientComponentExample = () => {
   </Tab>
 </Tabs>
 
-## Hangisini ne zaman seçmeli?
+#### Karşılaştırma
+
+- **Sayı biçimlendirme**
+  - **next-i18next**: `useNumber` yok; `Intl.NumberFormat` kullanın (veya i18next-icu).
+  - **next-intl**: `useFormatter().number(value)`.
+  - **Intlayer**: `useNumber()` built-in.
+
+- **Anahtarlar**
+  - İç içe geçmiş bir yapı tutun (`about.counter.label`) ve hook'unuzu buna göre kapsamlandırın (`useTranslation("about")` + `t("counter.label")` veya `useTranslations("about.counter")` + `t("label")`).
 
-- **next-intl**'i seçin eğer **minimal** bir çözüm istiyorsanız, merkezi kataloglarla rahatınız ve uygulamanız **küçük ila orta boy**.
-- **next-i18next**'i seçin eğer **i18next'in eklenti ekosistemine** ihtiyacınız varsa (örneğin, eklentiler aracılığıyla gelişmiş ICU kuralları) ve ekibiniz zaten i18next'i biliyorsa, esnekliği için **daha fazla yapılandırma** kabul ederek.
-- **Intlayer**'ı seçin eğer **bileşen kapsamlı içerik**, **katı TypeScript**, **derleme zamanı garantileri**, **ağaç sallama** ve **pil dahil** yönlendirme/SEO/düzenleyici araçlarını takdir ediyorsanız - özellikle **Next.js App Router**, tasarım sistemleri ve **büyük, modüler kod tabanları** için.
+- **Dosya konumları**
+  - **next-i18next** `public/locales/{lng}/{ns}.json` içinde JSON bekler.
+  - **next-intl** esnek; mesajları nasıl yapılandırdığınıza göre yükleyin.
+  - **Intlayer** içeriği TS/JS sözlüklerinde depolar ve anahtara göre çözer.
 
 ---
 
@@ -951,7 +1055,7 @@ const ServerComponent = ({ count }: ServerComponentProps) => {
 Geliştiriciler genellikle sayfalarını yerel ayarlar arasında düzgün şekilde referans vermeyi unuturlar.
 
 <Tabs defaultTab="next-intl" group='techno'>
- 
+
   <Tab label="next-i18next" value="next-i18next">
 
 ```ts fileName="i18n.config.ts"
@@ -1302,11 +1406,39 @@ Middleware'in kurulumu `intlayer.config.ts` dosyasında merkezileştirilmiştir.
   </Tab>
 </Tabs>
 
-## `next-intl` ve `next-i18next` ile birlikte çalışabilirlik
+### Kurulum kontrol listesi ve en iyi uygulamalar
+
+<Tabs defaultTab="next-intl" group='techno'>
+  <Tab label="next-i18next" value="next-i18next">
+
+- `src/app/[locale]/layout.tsx` dosyasında kök `<html>` öğesinde `lang` ve `dir` özniteliklerinin ayarlandığından emin olun.
+- Çevirileri ad alanlarına (örneğin `common.json`, `about.json`) `src/locales/<locale>/` altında bölün.
+- İstemci bileşenlerinde `useTranslation('<ns>')` kullanarak ve `I18nProvider` kapsamını aynı ad alanlarıyla ayarlayarak yalnızca gerekli ad alanlarını yükleyin.
+- Mümkün olduğunda sayfaları statik tutun: sayfalar üzerinde `export const dynamic = 'force-static'` olarak dışa aktarın; `dynamicParams = false` olarak ayarlayın ve `generateStaticParams` uygulayın.
+- Önceden hesaplanmış dizeler veya `t` işlevi ve `locale` geçirerek istemci sınırları altında eşzamanlı sunucu bileşenlerini kullanın.
+- SEO için, meta verilerde `alternates.languages` ayarlayın, `sitemap.ts` içinde yerelleştirilmiş URL'leri listeleyin ve `robots.ts` içinde yinelenen yerelleştirilmiş rotaları devre dışı bırakın.
+- Yerel ayara duyarlı biçimlendiricileri (örneğin `Intl.NumberFormat(locale)`) tercih edin ve React < 19 kullanırken bunları istemci üzerinde hafızaya alın.
 
-`intlayer`, `next-intl` ve `next-i18next` ad alanlarınızı yönetmenize de yardımcı olabilir.
+  </Tab>
+  <Tab label="next-intl" value="next-intl">
 
-`intlayer` kullanarak, içeriğinizi favori i18n kütüphanenizin formatında beyan edebilirsiniz ve intlayer ad alanlarınızı istediğiniz konumda oluşturacaktır (örnek: `/messages/{{locale}}/{{namespace}}.json`).
+- **HTML `lang` ve `dir` özniteliklerini ayarlayın**: `src/app/[locale]/layout.tsx` içinde, `dir` özniteliğini `getLocaleDirection(locale)` aracılığıyla hesaplayın ve `<html lang={locale} dir={dir}>` olarak ayarlayın.
+- **İletileri ad alanlarına göre bölün**: JSON'u locale ve ad alanına göre düzenleyin (örneğin `common.json`, `about.json`).
+- **İstemci yükünü en aza indirin**: Sayfalarda, yalnızca gerekli ad alanlarını `NextIntlClientProvider` öğesine gönderin (örneğin `pick(messages, ['common', 'about'])`).
+- **Statik sayfaları tercih edin**: `export const dynamic = 'force-static'` olarak dışa aktarın ve tüm `locales` için statik parametreler oluşturun.
+- **Eşzamanlı sunucu bileşenleri**: Sunucu bileşenlerini önceden hesaplanmış dizeler (çevrilmiş etiketler, biçimlendirilmiş sayılar) geçirerek eşzamanlı tutun; async çağrıları veya seri hale getirilemeyen işlevleri kullanmayın.
+
+  </Tab>
+  <Tab label="intlayer" value="intlayer">
+
+- **Modüler içerik**: `.content.{ts|js|json}` dosyalarını kullanarak içerik sözlüklerini bileşenlerle birlikte konumlandırın.
+- **Tür güvenliği**: Derleme zamanı içerik doğrulaması için TypeScript entegrasyonundan yararlanın.
+- **Derleme zamanı optimizasyonu**: Otomatik tree-shaking ve bundle optimizasyonu için Intlayer'ın derleme araçlarını kullanın.
+- **Entegre araçlar**: Yerleşik yönlendirme, SEO yardımcıları ve görsel editör desteğinden yararlanın.
+
+  </Tab>
+
+</Tabs>
 
 ---
 
@@ -1336,6 +1468,7 @@ Basit değil. Her seçeneğin avantaj ve dezavantajları var. İşte benim gör
 - modern Next.js için oluşturulmuş, modüler içerik, tip güvenliği, araçlar ve daha az boilerplate ile. **Bileşen kapsamlı içerik**, **kesin TypeScript**, **derleme zamanı garantileri**, **tree-shaking** ve **pil dahil** yönlendirme/SEO/editör araçlarını değer veriyorsanız - özellikle **Next.js App Router**, tasarım sistemleri ve **büyük, modüler kod tabanları** için.
 
   </Column>
+
 </Columns>
 
 Minimal kurulumu tercih ederseniz ve bazı manuel bağlantıları kabul ederseniz, next-intl iyi bir seçimdir. Tüm özelliklere ihtiyacınız varsa ve karmaşıklığa aldırmıyorsanız, next-i18next işe yarar. Ancak modern, ölçeklenebilir, modüler bir çözüm istiyorsanız ve dahili araçlarla, Intlayer bunu size kutusundan çıkar halde sağlamayı amaçlar.

package/blog/tr/rag_powered_documentation_assistant.md

@@ -254,6 +254,12 @@ Gpt-5 ile denedik, ama gecikme çok yüksekti (bazen 15 saniyeye kadar bir yanı
 
 </Steps>
 
+## Sanity ile Karmaşıklığı Atlayın
+
+Sanity, makalenin işaret ettiği CMS seçeneği olarak burada adlandırılmaya değer. Markdown dosyalarının keyfi token bölümlere ihtiyaç duyduğu durumlarda — makalenin açıkladığı chunk boyutu ve overlap dengeleri ile — Sanity'nin Content Lake, belgeleri yazılı, şema tarafından tanımlanmış JSON belgeleri olarak depolar. Her alan, başlık ve içerik bloğu zaten bir anlamsal birimdir; bu da RAG alımının yaklaşık token sayıları yerine anlamlı sınırlar üzerinde çalışması anlamına gelir.
+
+Sanity'nin GROQ sorgu dili, bir kullanıcı sorgusuna uygun belge alanlarını — başlık, gövde, ilgili bölümler — tam olarak almanızı sağlar; bu, tüm belgeyi getirmeye gerek yoktur. MCP sunucusu, Content Lake'i doğrudan AI ajanlarına bağlar; bu nedenle docs sitenizi güçlendiren aynı yapılandırılmış içerik, ayrı bir ingestion adımı olmaksızın RAG pipeline'ınızı da besler.
+
 ## Sonuç
 
 RAG, LLM'leri pratik hale getirmenin en basit, en güçlü yollarından biridir. **Retrieval + generation** birleştirerek, statik dokümanları **akıllı bir asistana** dönüştürebilir ve aynı zamanda sürekli ürün içgörüleri akışı elde edebilirsiniz.

package/blog/uk/index.md

@@ -1,5 +1,5 @@
 ---
-createdAt: 2024-24-12
+createdAt: 2024-12-24
 updatedAt: 2025-06-29
 title: Блог
 description: Дізнайтеся про всі теми, пов'язані з Intlayer, інтернаціоналізацією та іншим

package/blog/uk/rag_powered_documentation_assistant.md

@@ -317,6 +317,12 @@ RAG, це один із найпростіших і найпотужніших
 </Step>
 
 </Steps>
+## Пропустіть складність за допомогою Sanity
+
+Sanity варто згадати тут як варіант CMS, на який вказує стаття. Там де файли Markdown потребують довільного розділення токенів — з компромісами розміру chunk'а та перекриття, які описує стаття — Content Lake від Sanity зберігає документацію як типізовані, схемою визначені JSON-документи. Кожне поле, заголовок і блок контенту вже є семантичною одиницею, що означає, що RAG-пошук працює на змістовних межах замість приблизних підрахунків токенів.
+
+GROQ-мова запитів від Sanity дозволяє отримати саме ті поля документа, які відповідають запиту користувача — заголовок, основний текст, пов'язані розділи — без завантаження всього документа. MCP-сервер підключає Content Lake безпосередньо до AI-агентів, тому той самий структурований контент, який живить ваш сайт документації, також живить вашу RAG-конвеєр без окремого кроку ingestion.
+
 ## Висновок
 
 RAG — це один з найпростіших і найпотужніших способів зробити LLM практичними. Комбінуючи **retrieval + generation**, ви можете перетворити статичну документацію на **розумного помічника** і водночас отримати постійний потік інсайтів про продукт.

package/blog/vi/index.md

@@ -1,5 +1,5 @@
 ---
-createdAt: 2024-24-12
+createdAt: 2024-12-24
 updatedAt: 2025-06-29
 title: Blog
 description: Khám phá tất cả các chủ đề liên quan đến Intlayer, quốc tế hóa và các chủ đề khác

package/blog/vi/rag_powered_documentation_assistant.md

@@ -317,6 +317,12 @@ Và nếu bạn cũng đang thử nghiệm với RAG, tôi rất muốn nghe cá
 </Step>
 
 </Steps>
+## Bỏ Qua Độ Phức Tạp với Sanity
+
+Sanity đáng được nhắc đến ở đây như một tùy chọn CMS mà bài viết hướng tới. Trong khi các tệp Markdown yêu cầu chia tách token tùy ý — với những sự đánh đổi giữa kích thước chunk và overlap mà bài viết mô tả — Content Lake của Sanity lưu trữ tài liệu dưới dạng các tài liệu JSON được định nghĩa theo schema và có kiểu dữ liệu. Mỗi trường, tiêu đề và khối nội dung đã là một đơn vị ngữ nghĩa, điều này có nghĩa là việc truy xuất RAG hoạt động trên các ranh giới có ý nghĩa thay vì các số lượng token xấp xỉ.
+
+Ngôn ngữ truy vấn GROQ của Sanity cho phép bạn truy xuất chính xác các trường tài liệu liên quan đến truy vấn của người dùng — tiêu đề, nội dung, các phần liên quan — mà không cần tải toàn bộ tài liệu. MCP server kết nối Content Lake trực tiếp với các AI agent, vì vậy cùng một nội dung có cấu trúc làm nên trang tài liệu của bạn cũng cấp nuôi cho pipeline RAG của bạn mà không cần một bước nhập dữ liệu riêng biệt.
+
 ## Kết luận
 
 RAG là một trong những cách đơn giản nhất và mạnh mẽ nhất để làm cho các LLM trở nên thực tế. Bằng cách kết hợp **retrieval + generation**, bạn có thể biến các tài liệu tĩnh thành một **trợ lý thông minh** và cùng lúc đó, thu được một luồng thông tin sản phẩm liên tục.

package/blog/zh/index.md

@@ -1,5 +1,5 @@
 ---
-createdAt: 2024-24-12
+createdAt: 2024-12-24
 updatedAt: 2025-06-29
 title: 博客
 description: 了解所有与 Intlayer、国际化和其他相关的主题

package/blog/zh/intlayer_with_i18next.md

@@ -61,11 +61,62 @@ author: aymericzip
 
 <TOC/>
 
-### 第2步：实现 Intlayer 插件以封装 JSON
+## 分步指南：使用 i18next 设置 Intlayer
 
-创建一个 Intlayer 配置文件以定义支持的语言环境：
+<Steps>
+
+<Step number={1} title="安装依赖项">
+
+安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
 
-**如果您还想导出用于 i18next 的 JSON 字典**，请添加 `syncJSON` 插件：
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果你是 AI 代理，请使用 `intlayer-cli init`。
+
+> 此命令将检测你的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+```
+
+**包描述：**
+
+- **intlayer**: 国际化管理、内容声明和构建的核心库
+- **@intlayer/sync-json-plugin**: 将 Intlayer 内容声明导出为 i18next 兼容 JSON 格式的插件
+
+</Step>
+
+<Step number={2} title="实现 Intlayer 插件来包装 JSON">
+
+创建一个 Intlayer 配置文件来定义你支持的语言：
+
+**如果你还想为 i18next 导出 JSON 字典**，添加 `syncJSON` 插件：
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -86,24 +137,32 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-`syncJSON` 插件会自动包装 JSON。它会读取和写入 JSON 文件，而不会改变内容结构。
+`syncJSON` 插件将自动包装 JSON。它将读取和写入 JSON 文件，而不改变内容架构。
 
-如果你想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 会按以下方式处理：
+如果你想让 JSON 与 Intlayer 内容声明文件（`.content` 文件）共存，Intlayer 将按以下方式处理：
 
-1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
-2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 会合并所有字典。具体合并方式取决于插件的优先级以及内容声明文件的优先级（所有这些都是可配置的）。
+1. 加载 JSON 和内容声明文件，并将它们转换为 Intlayer 字典。
+2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 将合并所有字典。这取决于插件的优先级和内容声明文件的优先级（都可以配置）。
 
-如果通过 CLI 翻译 JSON 或使用 CMS 进行更改，Intlayer 会使用新的翻译更新 JSON 文件。
+如果使用 CLI 翻译 JSON 或使用 CMS 进行更改，Intlayer 将使用新的翻译更新 JSON 文件。
 
-要查看更多关于 `syncJSON` 插件的详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
+要了解有关 `syncJSON` 插件的更多详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
 
-<Steps>
+</Step>
+
+<Step number={3} title="设置 AI 提供商">
 
-<Step number={1} title="实现按组件的 JSON 翻译" isOptional={true}>
+Intlayer 为你的 i18next 工作流解锁了一套高级自动化和开发者友好的功能。
 
-默认情况下，Intlayer 会加载、合并并同步 JSON 文件和内容声明文件。更多详情请参阅 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。但如果你愿意，也可以使用 Intlayer 插件，在代码库中的任意位置实现按组件管理本地化的 JSON。
+- **自动检测和填充缺失翻译**：Intlayer 扫描你的 JSON 字典，查找未翻译或缺失的键，仅翻译这些，因此你的 JSON 的 99% 保持不变。
+- **大型 JSON 文件的分块翻译**：当你的翻译文件非常大时，Intlayer 自动将处理分成可管理的块，独立翻译它们以避免 API 限制和内存问题。
+- **命名空间并行化**：如果你有数百个命名空间（或文件），Intlayer 并行化翻译任务，有效地加快你的 CI/CD 或批量翻译操作。
+- **灵活的 AI 提供商支持**：选择你首选的 AI 提供商（例如 OpenAI、Claude、Gemini），只需配置凭据。使用你自己的 API 密钥，并根据需要切换提供商。
+- **弹性 AI 响应处理**：Intlayer 可以处理你的 AI 提供商将文本作为字符串或对象返回的边界情况，甚至在格式不一致时自动重试。
+- **CLI 和 CI/CD 就绪**：直接在你的测试或管道中运行 Intlayer 的检查和自动填充，使你的本地化过程健壮且自动化。
+- **集成到你现有的设置之上**：你不需要改变你的 i18next 或 Next.js 基础。Intlayer 作为插件添加到你的当前设置中，为你提供所有这些好处，同时实现最小迁移。
 
-为此，你可以使用 `loadJSON` 插件。
+以下是如何设置 AI 提供商的示例：
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -114,23 +173,14 @@ const config: IntlayerConfig = {
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
     defaultLocale: Locales.ENGLISH,
   },
-
-  // 保持当前的 JSON 文件与 Intlayer 字典同步
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
   plugins: [
-    /**
-     * 将加载 src 目录中所有匹配模式 {key}.i18n.json 的 JSON 文件
-     */
-    loadJSON({
-      source: ({ key }) => `./src/**/${key}.i18n.json`,
-      locale: Locales.ENGLISH,
-      priority: 1, // 确保这些 JSON 文件优先于 `./locales/en/${key}.json` 中的文件
-    }),
-    /**
-     * 将加载并将输出和翻译写回到 locales 目录中的 JSON 文件
-     */
     syncJSON({
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
-      priority: 0,
     }),
   ],
 };
@@ -138,7 +188,16 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-这将加载 `src` 目录中所有匹配 `{key}.i18n.json` 模式的 JSON 文件，并将它们作为 Intlayer 字典加载。
+然后你可以执行以下命令来填充你的翻译：
+
+```bash
+npx intlayer fill
+```
+
+这将使用你配置的 AI 提供商填充你的翻译。
+
+> 在 [Intlayer AI 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中查看所有可用的 AI 提供商。
+> 在 [Intlayer CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md) 中查看所有可用的命令。
 
 ---