@intlayer/docs 5.8.1 → 6.0.0-canary.1

package/docs/tr/testing.md

@@ -0,0 +1,200 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-09-20
+title: İçeriğinizi test etme
+description: Intlayer ile içeriğinizi nasıl test edeceğinizi keşfedin.
+keywords:
+  - Test Etme
+  - Intlayer
+  - Uluslararasılaştırma
+  - CMS
+  - İçerik Yönetim Sistemi
+  - Görsel Editör
+slugs:
+  - doc
+  - testing
+---
+
+# İçeriğinizi test etme
+
+Bu rehber, sözlüklerinizin eksiksiz olduğunu otomatik olarak nasıl doğrulayacağınızı, gönderim öncesi eksik çevirileri nasıl yakalayacağınızı ve uygulamanızda yerelleştirilmiş kullanıcı arayüzünü nasıl test edeceğinizi gösterir.
+
+---
+
+## Test edebilecekleriniz
+
+- **Eksik çeviriler**: Herhangi bir sözlük için gerekli yerel ayarlardan herhangi biri eksikse CI başarısız olur.
+- **Yerelleştirilmiş UI renderı**: Belirli bir yerel sağlayıcı ile bileşenleri render edin ve görünen metin/özellikler üzerinde doğrulama yapın.
+- **Derleme zamanı denetimleri**: CLI üzerinden yerel olarak hızlı bir denetim çalıştırın.
+
+---
+
+## Hızlı başlangıç: CLI ile denetim
+
+Denetimi proje kök dizininizden çalıştırın:
+
+```bash
+npx intlayer content test
+```
+
+Faydalı bayraklar:
+
+- `--env-file [path]`: ortam değişkenlerini bir dosyadan yükler.
+- `-e, --env [name]`: bir ortam profili seçer.
+- `--base-dir [path]`: çözümleme için uygulama temel dizinini ayarlar.
+- `--verbose`: ayrıntılı günlükleri gösterir.
+- `--prefix [label]`: günlük satırlarına önek ekler.
+
+Not: CLI ayrıntılı bir rapor yazdırır ancak başarısızlıklarda sıfır olmayan bir çıkış kodu vermez. CI kontrolü için, eksik gerekli yerel ayarların sıfır olduğunu doğrulayan bir birim testi (aşağıda) ekleyin.
+
+---
+
+## Programatik test (Vitest/Jest)
+
+Gerekli yerel ayarlarınız için eksik çeviri olmadığını doğrulamak için Intlayer CLI API'sini kullanın.
+
+```ts fileName=i18n.test.ts
+/* @vitest-environment node */
+import { listMissingTranslations } from "intlayer/cli";
+import { describe, expect, it } from "vitest";
+
+describe("çeviriler", () => {
+  it("gerekli yerel ayarlarda eksik yok", () => {
+    const result = listMissingTranslations();
+
+    if (result.missingRequiredLocales.length > 0) {
+      // Test yerelde veya CI'da başarısız olduğunda faydalıdır
+      console.log(result.missingTranslations);
+    }
+
+    expect(result.missingRequiredLocales).toHaveLength(0);
+  });
+});
+```
+
+Jest eşdeğeri:
+
+```ts fileName=i18n.test.ts
+import { listMissingTranslations } from "intlayer/cli";
+
+test("gerekli yerel ayarlarda eksik yok", () => {
+  const result = listMissingTranslations();
+
+  if (result.missingRequiredLocales.length > 0) {
+    // eslint-disable-next-line no-console
+    console.log(result.missingTranslations);
+  }
+
+  expect(result.missingRequiredLocales).toHaveLength(0);
+});
+```
+
+Nasıl çalışır:
+
+- Intlayer, yapılandırmanızı (yerel ayarlar, requiredLocales) ve bildirilen sözlükleri okur, ardından raporlar:
+  - `missingTranslations`: anahtar bazında, hangi yerel ayarların eksik olduğunu ve hangi dosyadan olduğunu.
+  - `missingLocales`: tüm eksik yerel ayarların birleşimi.
+  - `missingRequiredLocales`: `requiredLocales` ile sınırlı alt küme (veya `requiredLocales` ayarlanmadıysa tüm yerel ayarlar).
+
+---
+
+## Yerelleştirilmiş UI testi (React / Next.js)
+
+Bileşenleri bir Intlayer sağlayıcısı altında render edin ve görünür içerik üzerinde doğrulama yapın.
+
+React örneği (Testing Library):
+
+```tsx
+import { IntlayerProvider } from "react-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyComponent } from "./MyComponent";
+
+test("İngilizce yerelleştirilmiş başlığı render eder", () => {
+  render(
+    <IntlayerProvider locale="en-US">
+      <MyComponent />
+    </IntlayerProvider>
+  );
+
+  expect(screen.getByText("Beklenen İngilizce başlık")).toBeInTheDocument();
+});
+```
+
+Next.js (App Router) örneği: framework sarmalayıcısını kullanın:
+
+```tsx
+import { IntlayerClientProvider } from "next-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyPage } from "./MyPage";
+
+test("Fransızca yerelleştirilmiş başlık render edilir", () => {
+  render(
+    <IntlayerClientProvider locale="fr-FR">
+      <MyPage />
+    </IntlayerClientProvider>
+  );
+  expect(
+    screen.getByRole("heading", { name: "Beklenen Başlık" })
+  ).toBeInTheDocument();
+});
+```
+
+İpuçları:
+
+- Özellikler için ham string değerlerine ihtiyacınız olduğunda (örneğin, `aria-label`), React'te `useIntlayer` tarafından döndürülen `.value` alanına erişin.
+- Daha kolay birim testi ve temizlik için sözlükleri bileşenlerle aynı yerde tutun.
+
+---
+
+## Sürekli Entegrasyon
+
+Gerekli çeviriler eksik olduğunda derlemeyi başarısız kılan bir test ekleyin.
+
+`package.json`:
+
+```json
+{
+  "scripts": {
+    "test:i18n": "vitest run -c"
+  }
+}
+```
+
+GitHub Actions örneği:
+
+```yaml
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm run test:i18n
+```
+
+İsteğe bağlı: testlerle birlikte insan tarafından okunabilir bir özet için CLI denetimini çalıştırın:
+
+```bash
+npx intlayer content test --verbose
+```
+
+---
+
+## Sorun Giderme
+
+- Intlayer yapılandırmanızın `locales` ve (isteğe bağlı olarak) `requiredLocales` tanımladığından emin olun.
+- Uygulamanız dinamik veya uzak sözlükler kullanıyorsa, testleri sözlüklerin mevcut olduğu bir ortamda çalıştırın.
+- Karma monorepo yapıları için, CLI'yi doğru uygulama köküne yönlendirmek amacıyla `--base-dir` kullanın.
+
+---
+
+## Doküman Geçmişi
+
+| Sürüm | Tarih      | Değişiklikler      |
+| ----- | ---------- | ------------------ |
+| 6.0.0 | 2025-09-20 | Testlerin tanıtımı |

package/docs/tr/vs_code_extension.md

@@ -0,0 +1,154 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Resmi VS Code Uzantısı
+description: Geliştirme iş akışınızı geliştirmek için VS Code'da Intlayer uzantısının nasıl kullanılacağını öğrenin. Yerelleştirilmiş içerik arasında hızlıca gezinin ve sözlüklerinizi verimli bir şekilde yönetin.
+keywords:
+  - VS Code Uzantısı
+  - Intlayer
+  - Yerelleştirme
+  - Geliştirme Araçları
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - vs-code-extension
+---
+
+# Resmi VS Code Uzantısı
+
+## Genel Bakış
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), projelerinizde yerelleştirilmiş içerikle çalışırken geliştirici deneyimini iyileştirmek için tasarlanmış **Intlayer** için resmi Visual Studio Code uzantısıdır.
+
+![Intlayer VS Code Uzantısı](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+Uzantı bağlantısı: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Özellikler
+
+### Anında Gezinme
+
+**Tanım Git Desteği** – Karşılık gelen içerik dosyasını anında açmak için bir `useIntlayer` anahtarında `Cmd+Click` (Mac) veya `Ctrl+Click` (Windows/Linux) kullanın.  
+**Sorunsuz Entegrasyon** – **react-intlayer** ve **next-intlayer** projeleriyle zahmetsizce çalışır.  
+**Çok Dilli Destek** – Farklı diller arasında yerelleştirilmiş içeriği destekler.  
+**VS Code Entegrasyonu** – VS Code'un gezinme ve komut paletiyle sorunsuz entegre olur.
+
+### Sözlük Yönetimi Komutları
+
+İçerik sözlüklerinizi doğrudan VS Code'dan yönetin:
+
+- **Sözlükleri Oluştur** (`extension.buildDictionaries`) – Proje yapınıza göre içerik dosyaları oluşturun.
+- **Sözlükleri Gönder** (`extension.pushDictionaries`) – En son sözlük içeriğini deponuza yükleyin.
+- **Sözlükleri Çek** (`extension.pullDictionaries`) – En son sözlük içeriğini deponuzdan yerel ortamınıza senkronize edin.
+
+### İçerik Bildirim Oluşturucu
+
+Farklı formatlarda yapılandırılmış sözlük dosyaları kolayca oluşturun:
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Modülü (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## Kurulum
+
+**Intlayer**'ı doğrudan VS Code Marketplace'ten yükleyebilirsiniz:
+
+1. **VS Code**'u açın.
+2. **Uzantılar Marketplace**'e gidin.
+3. **"Intlayer"** arayın.
+4. **Yükle**'ye tıklayın.
+
+Alternatif olarak, komut satırı aracılığıyla yükleyin:
+
+```sh
+code --install-extension intlayer
+```
+
+## Kullanım
+
+### Hızlı Gezinme
+
+1. **react-intlayer** kullanan bir proje açın.
+2. Aşağıdaki gibi bir `useIntlayer()` çağrısı bulun:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. Anahtar üzerinde (ör. `"app"`) **Command-tıklayın** (`⌘+Click` macOS'ta) veya **Ctrl+Click** (Windows/Linux'ta).
+4. VS Code otomatik olarak karşılık gelen sözlük dosyasını açacaktır, ör. `src/app.content.ts`.
+
+### İçerik Sözlüklerini Yönetme
+
+#### Sözlükleri Oluşturma
+
+Tüm sözlük içerik dosyalarını oluşturmak için:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+**Sözlükleri Oluştur** arayın ve komutu çalıştırın.
+
+#### Sözlükleri Gönderme
+
+En son sözlük içeriğini yükleyin:
+
+1. **Komut Paleti**'ni açın.
+2. **Sözlükleri Gönder** arayın.
+3. Gönderilecek sözlükleri seçin ve onaylayın.
+
+#### Sözlükleri Çekme
+
+En son sözlük içeriğini senkronize edin:
+
+1. **Komut Paleti**'ni açın.
+2. **Sözlükleri Çek** arayın.
+3. Çekilecek sözlükleri seçin.
+
+## Geliştirme & Katkı
+
+Katkıda bulunmak mı istiyorsunuz? Topluluk katkılarını memnuniyetle karşılıyoruz!
+
+Repo URL: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Başlarken
+
+Depoyu klonlayın ve bağımlılıkları yükleyin:
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> `vsce` paketiyle uyumluluk için `npm` paket yöneticisini kullanın, uzantıyı oluşturmak ve yayınlamak için.
+
+### Geliştirme Modunda Çalıştırın
+
+1. Projeyi **VS Code**'da açın.
+2. Yeni bir **Uzantı Geliştirme Ana Bilgisayarı** penceresi başlatmak için `F5`'e basın.
+
+### Bir Pull Request Gönderin
+
+Uzantıyı iyileştirirseniz, [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension)'da bir PR gönderin.
+
+## Geri Bildirim & Sorunlar
+
+Bir hata mı buldunuz veya özellik isteğiniz mi var? **GitHub deposumuzda** bir sorun açın:
+
+[GitHub Sorunları](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Lisans
+
+Intlayer **MIT Lisansı** altında yayınlanmıştır.
+
+## Doküman Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |

package/docs/zh/autoFill.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-06-29
+updatedAt: 2025-09-20
 title: 自动填充
-description: 学习如何在 Intlayer 中使用自动填充功能，根据预定义的模式自动填充内容。按照本指南高效地在项目中实现自动填充功能。
+description: 了解如何在 Intlayer 中使用自动填充功能，根据预定义模式自动填充内容。按照本说明文档高效实现自动填充功能。
 keywords:
   - 自动填充
   - 内容自动化
@@ -19,19 +19,19 @@ slugs:
 
 # 自动填充内容声明文件翻译
 
-**自动填充内容声明文件** 是加快开发工作流程的一种方式。  
-自动填充机制通过内容声明文件之间的“主从”关系来实现。当主（master）文件被更新时，Intlayer 会自动将这些更改应用到派生（自动填充）的声明文件中。
+**自动填充内容声明文件** 是加快开发工作流程的一种方式。
+
+自动填充机制通过内容声明文件之间的 _主从_ 关系来实现。当主（master）文件被更新时，Intlayer 会自动将这些更改应用到派生的（自动填充的）声明文件中。
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
 
-// 定义示例内容字典
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
   autoFill: "./example.content.json",
   content: {
-    contentExample: "This is an example of content", // 这是内容示例
+    contentExample: "这是一个内容示例",
   },
 } satisfies Dictionary;
 
@@ -46,7 +46,7 @@ export default exampleContent;
 npx intlayer fill --file 'src/components/example/example.content.ts'
 ```
 
-Intlayer 将自动生成派生的声明文件，路径为 `src/components/example/example.content.json`，填充所有主文件中尚未声明的语言环境。
+Intlayer 将自动生成派生的声明文件，路径为 `src/components/example/example.content.json`，并填充主文件中尚未声明的所有语言环境。
 
 ```json5 fileName="src/components/example/example.content.json"
 {
@@ -63,11 +63,11 @@ Intlayer 将自动生成派生的声明文件，路径为 `src/components/exampl
 }
 ```
 
-之后，两个声明文件将合并为一个字典，可以通过标准的 `useIntlayer("example")` 钩子（React）/ 组合函数（Vue）访问。
+之后，这两个声明文件将合并为一个字典，可以通过标准的 `useIntlayer("example")` 钩子（React）或组合函数（Vue）访问。
 
 ## 自动填充文件格式
 
-自动填充声明文件推荐的格式是 **JSON**，这有助于避免格式限制。然而，Intlayer 也支持 `.ts`、`.js`、`.mjs`、`.cjs` 以及其他格式。
+推荐的自动填充声明文件格式是 **JSON**，这有助于避免格式限制。然而，Intlayer 也支持 `.ts`、`.js`、`.mjs`、`.cjs` 及其他格式。
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
@@ -87,8 +87,8 @@ src/components/example/example.filled.content.ts
 
 > `.js`、`.ts` 及类似文件的生成方式如下：
 >
-> - 如果文件已存在，Intlayer 将使用 AST（抽象语法树）解析它，以定位每个字段并插入任何缺失的翻译。
-> - 如果文件不存在，Intlayer 将使用默认内容声明文件模板生成该文件。
+> - 如果文件已存在，Intlayer 将使用 AST（抽象语法树）解析文件，定位每个字段并插入任何缺失的翻译。
+> - 如果文件不存在，Intlayer 将使用默认的内容声明文件模板生成它。
 
 ## 绝对路径
 
@@ -122,7 +122,7 @@ const exampleContent = {
     es: "./example.es.content.json",
   },
   content: {
-    // 你的内容
+    // 您的内容
   },
 };
 ```
@@ -132,9 +132,11 @@ const exampleContent = {
 - `src/components/example/example.fr.content.json`
 - `src/components/example/example.es.content.json`
 
-## 过滤特定语言自动填充
+> 在这种情况下，如果对象不包含所有语言，Intlayer 将跳过剩余语言的生成。
 
-使用对象作为 `autoFill` 字段允许你应用过滤器，只生成特定语言的文件。
+## 过滤特定语言的自动填充
+
+为 `autoFill` 字段使用对象可以让您应用过滤器，只生成特定语言的文件。
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
@@ -143,7 +145,7 @@ const exampleContent = {
     fr: "./example.fr.content.json",
   },
   content: {
-    // 你的内容
+    // 您的内容
   },
 };
 ```
@@ -152,14 +154,15 @@ const exampleContent = {
 
 ## 路径变量
 
-你可以在 `autoFill` 路径中使用变量，动态解析生成文件的目标路径。
+您可以在 `autoFill` 路径中使用变量，以动态解析生成文件的目标路径。
 
 **可用变量：**
 
 - `{{locale}}` – 语言代码（例如 `fr`，`es`）
+- `{{fileName}}` – 文件名（例如 `index`）
 - `{{key}}` – 字典键（例如 `example`）
 
-```ts fileName="src/components/example/example.content.ts"
+```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
   autoFill: "/messages/{{locale}}/{{key}}.content.json",
@@ -174,6 +177,25 @@ const exampleContent = {
 - `/messages/fr/example.content.json`
 - `/messages/es/example.content.json`
 
+```ts fileName="src/components/example/index.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "./{{fileName}}.content.json",
+  content: {
+    // 您的内容
+  },
+};
+```
+
+这将生成：
+
+- `./index.content.json`
+- `./index.content.json`
+
 ## 文档历史
 
-- 5.5.10 - 2025-06-29: 初始化历史记录
+| 版本   | 日期       | 变更内容                   |
+| ------ | ---------- | -------------------------- |
+| 6.0.0  | 2025-09-20 | 添加全局配置               |
+| 6.0.0  | 2025-09-17 | 添加 `{{fileName}}` 变量   |
+| 5.5.10 | 2025-06-29 | 初始化历史                 |