@intlayer/docs 8.3.0-canary.4 → 8.3.1

package/docs/tr/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-07
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Vue i18n - Vue uygulamasını çevirme 2026
 description: Vite ve Vue web sitenizi çok dilli hale getirmeyi öğrenin. Dokümantasyonu takip ederek uluslararasılaştırma (i18n) ve çevirisini yapın.
 keywords:
@@ -1049,6 +1049,162 @@ Uzantıyı kullanma hakkında daha fazla ayrıntı için [Intlayer VS Code Uzant
 
 ---
 
+### (İsteğe bağlı) Adım 12 : Bileşenlerinizin içeriğini çıkarın
+
+Mevcut bir kod tabanınız varsa, binlerce dosyayı dönüştürmek zaman alıcı olabilir.
+
+Bu süreci kolaylaştırmak için Intlayer, bileşenlerinizi dönüştürmek ve içeriği çıkarmak için bir [derleyici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compiler.md) / [çıkarıcı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/extract.md) sunar.
+
+Kurulum için `intlayer.config.ts` dosyanıza bir `compiler` bölümü ekleyebilirsiniz:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Yapılandırmanızın geri kalanı
+  compiler: {
+    /**
+     * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
+     */
+    enabled: true,
+
+    /**
+     * Çıktı dosyalarının yolunu tanımlar
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir. Bu sayede derleyici, uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
+     */
+    saveComponents: false,
+
+    /**
+     * Sözlük anahtarı öneki
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Yapılandırmanızın geri kalanı
+  compiler: {
+    /**
+     * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
+     */
+    enabled: true,
+
+    /**
+     * Çıktı dosyalarının yolunu tanımlar
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir. Bu sayede derleyici, uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
+     */
+    saveComponents: false,
+
+    /**
+     * Sözlük anahtarı öneki
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Yapılandırmanızın geri kalanı
+  compiler: {
+    /**
+     * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
+     */
+    enabled: true,
+
+    /**
+     * Çıktı dosyalarının yolunu tanımlar
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir. Bu sayede derleyici, uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
+     */
+    saveComponents: false,
+
+    /**
+     * Sözlük anahtarı öneki
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='Çıkarma komutu'>
+
+Bileşenlerinizi dönüştürmek ve içeriği çıkarmak için çıkarıcıyı çalıştırın
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Babel derleyicisi'>
+
+`vite.config.ts` dosyanızı `intlayerCompiler` eklentisini içerecek şekilde güncelleyin:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // Derleyici eklentisini ekler
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # Veya npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # Or pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # Or yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### Daha Fazla İlerle
 
 Daha fazla ilerlemek için [görsel düzenleyici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) veya içeriğinizi [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) kullanarak dışa aktarmayı uygulayabilirsiniz.

package/docs/uk/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-10
+updatedAt: 2026-03-12
 title: Intlayer Compiler | Автоматизоване витягування контенту для i18n
 description: Автоматизуйте процес інтернаціоналізації за допомогою Intlayer Compiler. Витягуйте контент безпосередньо з ваших компонентів для швидшого та ефективнішого i18n у Vite, Next.js та інших.
 keywords:
@@ -22,7 +22,7 @@ slugs:
 history:
   - version: 8.2.0
     date: 2026-03-09
-    changes: Update compiler options, add FilePathPattern support
+    changes: Оновлення опцій компілятора, додана підтримка FilePathPattern
   - version: 8.1.7
     date: 2026-02-25
     changes: Оновлення опцій компілятора
@@ -35,27 +35,27 @@ history:
 
 ## Що таке Intlayer Compiler?
 
-The **Intlayer Compiler**, потужний інструмент, створений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, у той час як Intlayer займається керуванням та синхронізацією ваших словників.
+**Intlayer Compiler** — це потужний інструмент, розроблений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, тоді як Intlayer займається керуванням та синхронізацією ваших словників.
 
 ## Чому використовувати Intlayer Compiler?
 
-- **Automation**: Усуває ручне копіювання та вставляння контенту у словники.
-- **Speed**: Оптимізоване витягування контенту, яке забезпечує швидкість процесу збірки.
-- **Developer Experience**: Тримайте декларації контенту там, де вони використовуються, що покращує підтримуваність.
-- **Live Updates**: Підтримує Hot Module Replacement (HMR) для миттєвого зворотного зв'язку під час розробки.
+- **Автоматизація**: Усуває ручне копіювання та вставляння контенту у словники.
+- **Швидкість**: Оптимізоване витягування контенту забезпечує швидкість процесу збірки.
+- **Досвід розробника**: Тримайте декларації контенту там, де вони використовуються, що покращує підтримуваність.
+- **Оновлення в реальному часі**: Підтримує Hot Module Replacement (HMR) для миттєвого зворотного зв'язку під час розробки.
 
-Див. публікацію в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md) для детальнішого порівняння.
+Див. статтю в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md) для глибшого порівняння.
 
 ## Чому не використовувати Intlayer Compiler?
 
-Хоча компілятор надає відмінний досвід «just works», він також запроваджує певні компроміси, про які слід знати:
+Хоча компілятор пропонує чудовий досвід «just works», він також вносить певні компроміси, про які варто знати:
 
-- **Heuristic ambiguity**: Компилятор має вгадувати, який контент призначений для користувача, а що, логіка додатка (наприклад, `className="active"`, коди статусу, ідентифікатори продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатимуть ручних анотацій та винятків.
-- **Static-only extraction**: Екстракція на основі компілятора спирається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені лише компілятором, тому вам усе одно потрібна додаткова стратегія i18n на рівні виконання.
+- **Евристична неоднозначність**: Компілятор має вгадувати, що є контентом для користувача, а що — логікою додатка (наприклад, `className="active"`, коди статусів, ID продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатиме ручних анотацій та винятків.
+- **Тільки статична екстракція**: Екстракція на основі компілятора покладається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені лише компілятором, тому вам усе одно знадобиться додаткова стратегія i18n під час виконання.
 
-Для більш глибокого архітектурного порівняння див. публікацію в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md).
+Для глибшого архітектурного порівняння див. статтю в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md).
 
-Як альтернативу, щоб автоматизувати ваш процес i18n і зберегти повний контроль над контентом, Intlayer також надає команду автоматичної екстракції `intlayer extract` (див. [Документація CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md)), або команду `Intlayer: extract content to Dictionary` з розширення Intlayer для VS Code (див. [Документація розширення VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md)).
+Як альтернативу, щоб автоматизувати ваш процес i18n і зберегти повний контроль над контентом, Intlayer також пропонує команду автоматичної екстракції `intlayer extract` (див. [документацію CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md)), або команду `Intlayer: extract content to Dictionary` з розширення Intlayer для VS Code (див. [документацію розширення VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md)).
 
 ## Використання
 
@@ -64,7 +64,7 @@ The **Intlayer Compiler**, потужний інструмент, створен
 
 ### Vite
 
-Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор, через плагін `vite-intlayer`.
+Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор — через плагін `vite-intlayer`.
 
 #### Встановлення
 
@@ -121,7 +121,7 @@ npm install @intlayer/svelte-compiler
 npm install @intlayer/babel
 ```
 
-#### Конфігурація
+#### Налаштування
 
 Оновіть ваш `babel.config.js` (або `babel.config.json`), щоб додати плагін для екстракції. Ми надаємо хелпер `getExtractPluginOptions`, який автоматично завантажує вашу конфігурацію Intlayer.
 
@@ -144,78 +144,90 @@ module.exports = {
 };
 ```
 
-Ця конфігурація гарантує, що контент, оголошений у ваших компонентах, автоматично витягується й використовується для генерації словників під час процесу збірки.
+Ця конфігурація гарантує, що контент, оголошений у ваших компонентах, буде автоматично витягнутий і використаний для генерації словників під час процесу збірки.
 
 See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
 
  </Tab>
+</Tabs>
 
 ### Користувацька конфігурація
 
 Щоб налаштувати поведінку компілятора, ви можете оновити файл `intlayer.config.ts` у корені вашого проєкту.
 
-```ts fileName="intlayer.config.ts"
+````ts fileName="intlayer.config.ts"
 import { type IntlayerConfig, Locales } from "intlayer";
 
 const config: IntlayerConfig = {
   compiler: {
     /**
+     * Вказує, чи має бути увімкнено компілятор.
      * Встановіть значення 'build-only', щоб пропустити компілятор під час розробки та прискорити запуск.
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
-     */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
-
-    /**
-     * Pattern to exclude from the optimization.
+     * Визначає шлях до вихідних файлів. Замінює `outputDir`.
+     *
+     * - Шляхи, що починаються з `./`, розв'язуються відносно каталогу компонента.
+     * - Шляхи, що починаються з `/`, розв'язуються відносно кореня проєкту (`baseDir`).
+     *
+     * - Включення змінної `{{locale}}` у шлях дозволить генерувати словники, розділені за локалями.
+     *
+     * Приклади:
+     * ```ts
+     * {
+     *   // Створює багатомовні файли .content.ts поруч із компонентом
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // Еквівалент з використанням рядкового шаблону
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // Створює централізовані JSON-файли за локалями в корені проєкту
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Еквівалент з використанням рядкового шаблону
+     * }
+     * ```
+     *
+     * Список змінних:
+     *   - `fileName`: Назва файлу.
+     *   - `key`: Ключ контенту.
+     *   - `locale`: Локаль контенту.
+     *   - `extension`: Розширення файлу.
+     *   - `componentFileName`: Назва файлу компонента.
+     *   - `componentExtension`: Розширення файлу компонента.
+     *   - `format`: Формат словника.
+     *   - `componentFormat`: Формат словника компонента.
+     *   - `componentDirPath`: Шлях до каталогу компонента.
      */
-    excludePattern: ["**/node_modules/**"],
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Вихідний каталог для оптимізованих словників.
+     * Вказує, чи мають компоненти зберігатися після трансформації.
+     * Таким чином компілятор можна запустити лише один раз для трансформації додатка, а потім видалити.
      */
-    output: ({ key }) => `compiler/${key}.content.json`,
+    saveComponents: false,
 
     /**
-     * Вставте лише вміст у згенерований файл, без ключа.
+     * Вставляє лише контент у згенерований файл. Корисно для виводу JSON для i18next або ICU MessageFormat для кожної локалі.
+     *
+     * - `output: ({ locale, key }) => `./locale/${locale}/${key}.json`,`
      */
     noMetadata: false,
 
     /**
      * Префікс ключа словника
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * Вказує, чи мають компоненти зберігатися після трансформації.
-     * Таким чином компілятор можна запустити лише один раз для трансформації додатка, а потім видалити.
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // Додає необов'язковий префікс для витягнутих ключів словника
   },
 };
 
 export default config;
-```
-
-### Заповнити відсутні переклади
-
-Intlayer надає інструмент CLI, який допоможе вам заповнити відсутні переклади. Ви можете використовувати команду `intlayer` для тестування та заповнення відсутніх перекладів у вашому коді.
-
-```bash
-npx intlayer test         # Перевірити наявність відсутніх перекладів
-```
-
-```bash
-npx intlayer fill         # Заповнити відсутні переклади
-```
-
-> Для отримання додаткової інформації зверніться до [документації CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md)
+````
 
 ### Довідник з конфігурації компілятора
 
@@ -225,36 +237,37 @@ npx intlayer fill         # Заповнити відсутні переклад
   - _Тип_: `boolean | 'build-only'`
   - _Типово_: `true`
   - _Опис_: Вказує, чи має бути увімкнено компілятор.
+
 - **dictionaryKeyPrefix**:
   - _Тип_: `string`
-  - _Типово_: `'comp-'`
+  - _Типово_: `''`
   - _Опис_: Префікс для витягнутих ключів словника.
+
 - **transformPattern**:
   - _Тип_: `string | string[]`
   - _Типово_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
-  - _Опис_: Шаблони для обходу коду для оптимізації.
+  - _Опис_: (Застаріло: використовуйте `build.traversePattern`) Шаблони для обходу коду для оптимізації.
+
 - **excludePattern**:
   - _Тип_: `string | string[]`
   - _Типово_: `['**/node_modules/**']`
-  - _Опис_: Шаблони для виключення з оптимізації.
-- **outputDir** (Deprecated):
-  - _Тип_: `string`
-  - _Типово_: `'compiler'`
-  - _Опис_: Каталог, у якому зберігатимуться витягнуті словники.
+  - _Опис_: (Застаріло: використовуйте `build.traversePattern`) Шаблони для виключення з оптимізації.
 
 - **output**:
   - _Тип_: `FilePathPattern`
   - _Типово_: `({ key }) => 'compiler/${key}.content.json'`
   - _Опис_: Визначає шлях до вихідних файлів. Замінює `outputDir`. Обробляє динамічні змінні, такі як `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}` та `{{componentFormat}}`. Можна встановити як рядок у форматі `'my/{{var}}/path'` або як функцію.
   - _Примітка_: Шляхи `./**/*` розв'язуються відносно компонента. Шляхи `/**/*` розв'язуються відносно `baseDir` Intlayer.
+  - _Примітка_: Якщо локаль визначена в шляху, словники будуть генеруватися для кожної локалі.
   - _Приклад_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
 
 - **noMetadata**:
   - _Тип_: `boolean`
   - _Типово_: `false`
-  - _Опис_: Вказує, чи мають метадані зберігатися у файлі. Якщо true, компілятор не зберігатиме метадані словників (ключ, оболонка вмісту).
+  - _Опис_: Вказує, чи мають метадані зберігатися у файлі. Якщо true, компілятор не зберігатиме метадані словників (ключ, оболонка вмісту). Корисно для виводу JSON для i18next або ICU MessageFormat для кожної локалі.
   - _Примітка_: Корисно при використанні з плагіном `loadJSON`.
-  - _Приклад_: Якщо `true`:
+  - _Приклад_:
+    Якщо `true`:
     ```json
     {
       "key": "value"
@@ -274,3 +287,25 @@ npx intlayer fill         # Заповнити відсутні переклад
   - _Тип_: `boolean`
   - _Типово_: `false`
   - _Опис_: Вказує, чи мають компоненти зберігатися після трансформації.
+
+### Заповнення відсутніх перекладів
+
+Intlayer надає CLI-інструмент, який допоможе заповнити відсутні переклади. Ви можете використовувати команду `intlayer` для перевірки та заповнення відсутніх перекладів у вашому коді.
+
+```bash
+npx intlayer test         # Перевірити наявність відсутніх перекладів
+```
+
+```bash
+npx intlayer fill         # Заповнити відсутні переклади
+```
+
+### Екстракція
+
+Intlayer надає CLI-інструмент, який допоможе вам витягти контент із вашого коду. Ви можете використовувати команду `intlayer extract`, щоб витягти контент із вашого коду.
+
+```bash
+npx intlayer extract
+```
+
+> Для отримання детальнішої інформації див. [документацію CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md)