@intlayer/docs 7.5.12 → 7.5.13

package/blog/uk/intlayer_with_next-i18next.md

@@ -0,0 +1,202 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-11-06
+title: Intlayer та next-i18next
+description: Інтегруйте Intlayer з next-i18next для комплексного рішення інтернаціоналізації в Next.js
+keywords:
+  - i18next
+  - next-i18next
+  - Intlayer
+  - Інтернаціоналізація
+  - Блог
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - blog
+  - intlayer-with-next-i18next
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 7.0.7
+    date: 2025-11-06
+    changes: Додано документацію про підтримку AI-провайдерів
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Додано плагін loadJSON
+  - version: 7.0.0
+    date: 2025-10-29
+    changes: Заміна на плагін syncJSON та повний перепис
+---
+
+# Як автоматизувати JSON-переклади next-i18next за допомогою Intlayer
+
+<iframe title="Як автоматизувати JSON-переклади next-i18next за допомогою 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=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+## Зміст
+
+<TOC/>
+
+## Що таке Intlayer?
+
+**Intlayer** — інноваційна open-source бібліотека для інтернаціоналізації, створена для усунення недоліків традиційних i18n-рішень. Вона пропонує сучасний підхід до управління контентом у додатках Next.js.
+
+Перегляньте конкретне порівняння з next-intl у нашому дописі в блозі [next-i18next vs. next-intl vs. Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md).
+
+## Чому поєднувати Intlayer з next-i18next?
+
+Хоча **Intlayer** є відмінним самостійним i18n-рішенням (див. наш [гайд по інтеграції з Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_16.md)), ви можете захотіти поєднати його з next-i18next з кількох причин:
+
+Intlayer пропонує широкий набір **розширених можливостей**, що виходять за рамки традиційних i18n-інструментів. Воно допомагає вам:
+
+- **Автоматично виявляти та заповнювати відсутні переклади**, щоб спростити локалізацію.
+- **Тестувати та валідувати ваші переклади** безпосередньо у ваших workflow для розробки або CI/CD.
+- **Керуйте контентом на рівні компонентів**, що забезпечує чисту, масштабовану та підтримувану структуру в усьому вашому додатку.
+- **Виносьте контент зовні**, роблячи його легко редагованим для всієї вашої команди (розробників, перекладачів та контент-менеджерів).
+
+Однак **i18next** залишається відмінним та широко застосовуваним рішенням для i18n завдяки своїй **зрілій екосистемі**, **широкій підтримці спільноти** та **великій сумісності з плагінами**.
+
+Поєднавши **Intlayer** з **i18next**, ви отримуєте найкраще з обох світів — стабільність та зрілість екосистеми i18next разом із сучасним керуванням контентом, автоматизацією та покращеним досвідом розробника від Intlayer.
+
+Цей посібник пояснює, як використовувати Intlayer як **адаптер для i18next**, що дозволяє вам:
+
+- Поступово мігрувати з i18next на Intlayer.
+- Зберігайте наявні плагіни та робочі процеси i18next.
+- Автоматизуйте переклади JSON через CLI або CI/CD конвеєри.
+- Тестуйте, синхронізуйте та керуйте перекладами ефективніше.
+
+---
+
+## Покроковий посібник із налаштування Intlayer з next-i18next
+
+### Крок 1: Встановлення залежностей
+
+Встановіть необхідні пакети, використовуючи ваш улюблений пакетний менеджер:
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
+**Пояснення пакетів:**
+
+- **intlayer**: Основна бібліотека для декларації та управління контентом
+- **@intlayer/sync-json-plugin**: Плагін для синхронізації декларацій контенту Intlayer у формат JSON для i18next
+
+### Крок 2: Реалізація плагіна Intlayer для обгортання JSON
+
+Створіть файл конфігурації Intlayer, щоб визначити підтримувані локалі:
+
+**Якщо ви також хочете експортувати JSON-словники для i18next**, додайте плагін `syncJSON`:
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./public/locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Плагін `syncJSON` автоматично обгортає JSON. Він читає та записує JSON-файли без зміни архітектури контенту.
+
+Якщо ви хочете, щоб ці JSON-файли співіснували з файлами декларації контенту Intlayer (`.content` файли), Intlayer працюватиме таким чином:
+
+    1. завантажити як JSON-файли, так і файли декларації контенту й перетворити їх на словник Intlayer.
+    2. якщо виникають конфлікти між JSON та файлами декларації контенту, Intlayer виконає злиття всіх словників. Результат залежить від пріоритету плагінів та пріоритету файлу декларації контенту — обидва параметри конфігуровані.
+
+Якщо зміни вносяться за допомогою CLI для перекладу JSON або через CMS, Intlayer оновить JSON-файл новими перекладами.
+
+Щоб дізнатися більше про плагін `syncJSON`, див. [документацію плагіна syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md).
+
+### Крок 4: Налаштування AI-провайдера
+
+Intlayer відкриває набір розширених автоматизацій та зручних для розробника функцій для вашого робочого процесу i18next.
+
+- **Автоматичне виявлення та заповнення відсутніх перекладів**: Intlayer сканує ваші JSON-словники, знаходить неперекладені або відсутні ключі й перекладає лише їх, тож 99% вашого JSON залишається незмінним.
+- **Порційний (chunked) переклад для великих JSON-файлів**: Коли ваші файли перекладу дуже великі, Intlayer автоматично розбиває обробку на керовані порції, перекладаючи їх незалежно, щоб уникнути лімітів API та проблем із пам'яттю.
+- **Паралелізація namespace-ів**: Якщо у вас сотні namespace-ів (або файлів), Intlayer паралелізує задачі перекладу, ефективно прискорюючи ваші CI/CD або масові операції перекладу.
+- **Гнучка підтримка AI-провайдерів**: Оберіть бажаного AI-провайдера (наприклад, OpenAI, Claude, Gemini), просто налаштувавши облікові дані. Використовуйте власний API-ключ і перемикайте провайдерів за потреби.
+- **Стійка обробка відповідей AI**: Intlayer вміє обробляти крайові випадки, коли ваш AI-провайдер повертає текст або як рядок, або як об'єкт, навіть автоматично повторюючи запит, якщо формат непослідовний.
+- **Готовий для CLI та CI/CD**: Запускайте перевірки Intlayer та автоматичне заповнення безпосередньо у ваших тестах або пайплайнах, роблячи процес локалізації надійним та автоматизованим.
+- **Інтегрується поверх вашої існуючої конфігурації**: Вам не потрібно змінювати ваш i18next або Next.js фундамент. Intlayer працює як додатковий плагін до вашої поточної конфігурації, надаючи всі ці переваги з мінімальною міграцією.
+
+Ось приклад налаштування AI-провайдера:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./public/locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Тоді ви можете виконати наступну команду, щоб заповнити ваші переклади:
+
+```bash
+npx intlayer fill
+```
+
+Це заповнить ваші переклади за допомогою AI-провайдера, який ви налаштували.
+
+> Дивіться всіх доступних AI-провайдерів у [документації Intlayer щодо конфігурації AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md#ai-configuration).
+> Дивіться всі доступні команди у [документації Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+
+---
+
+## Конфігурація Git
+
+Виключити згенеровані файли з контролю версій:
+
+```plaintext fileName=".gitignore"
+# Ігнорувати файли, згенеровані Intlayer
+.intlayer
+```
+
+Ці файли автоматично генеруються під час процесу збірки й не потребують коміту у ваш репозиторій.
+
+### Розширення для VS Code
+
+Для покращення досвіду розробника встановіть офіційне розширення **Intlayer для VS Code**:
+
+[Встановити з VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)

package/blog/uk/intlayer_with_next-intl.md

@@ -0,0 +1,203 @@
+---
+createdAt: 2025-01-02
+updatedAt: 2025-11-06
+title: Як автоматизувати JSON-переклади next-intl за допомогою Intlayer
+description: Автоматизуйте ваші JSON-переклади за допомогою Intlayer і next-intl для покращеної інтернаціоналізації у застосунках Next.js.
+keywords:
+  - Intlayer
+  - next-intl
+  - Інтернаціоналізація
+  - Блог
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - blog
+  - intlayer-with-next-intl
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 7.0.7
+    date: 2025-11-06
+    changes: Додано документацію про підтримку AI-провайдера
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Додано плагін loadJSON
+  - version: 7.0.0
+    date: 2025-10-29
+    changes: Перехід на плагін syncJSON
+---
+
+# Як автоматизувати JSON-переклади next-intl за допомогою Intlayer
+
+<iframe title="Як автоматизувати JSON-переклади next-intl за допомогою 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=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+# Зміст
+
+<TOC/>
+
+## Що таке Intlayer?
+
+**Intlayer** — інноваційна open-source бібліотека для інтернаціоналізації, створена щоб вирішити обмеження традиційних i18n-рішень. Вона пропонує сучасний підхід до управління контентом у додатках Next.js.
+
+Перегляньте конкретне порівняння з next-intl у нашому дописі в блозі [next-i18next vs. next-intl vs. Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/next-i18next_vs_next-intl_vs_intlayer.md).
+
+## Чому поєднувати Intlayer з next-intl?
+
+Intlayer пропонує широкий набір **розширених можливостей**, які виходять за межі традиційних інструментів i18n. Він допомагає вам:
+
+- **Автоматично визначати й заповнювати відсутні переклади** для спрощення локалізації.
+- **Тестувати й перевіряти ваші переклади** безпосередньо в робочих процесах розробки або CI/CD.
+- **Керувати контентом на рівні компонентів**, що забезпечує чисту, масштабовану та зручну для підтримки структуру в додатку.
+- **Виносити контент зовні**, роблячи його зручним для редагування всією командою (розробники, перекладачі та контент-менеджери).
+
+Однак **next-intl** залишається відмінним і широко поширеним рішенням для i18n завдяки своїй **зрілій екосистемі**, **широкій підтримці спільноти** та **великий сумісності з плагінами**.
+
+Поєднавши **Intlayer** з **next-intl**, ви отримуєте найкраще з обох світів — стабільність і зрілість екосистеми next-intl разом із сучасним управлінням контентом, автоматизацією та покращенням developer experience від Intlayer.
+
+Цей посібник пояснює, як використовувати Intlayer як **адаптер для next-intl**, що дозволяє вам:
+
+- Поступово мігрувати з next-intl на Intlayer.
+- Зберігати існуючі плагіни та робочі процеси next-intl.
+- Автоматизувати ваші JSON-переклади в CLI або конвеєрах CI/CD.
+- Тестувати, синхронізувати та ефективніше керувати перекладами.
+
+## Зміст
+
+<TOC/>
+
+## Крок за кроком: налаштування Intlayer з next-intl
+
+### Крок 1: Встановлення залежностей
+
+Встановіть необхідні пакети:
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
+**Опис пакетів:**
+
+- **intlayer**: Основна бібліотека для управління інтернаціоналізацією, декларації контенту та побудови
+- **@intlayer/sync-json-plugin**: Плагін для експорту декларацій контенту Intlayer у JSON-формат, сумісний з next-intl
+
+### Крок 2: Реалізуйте плагін Intlayer для обгортання JSON
+
+Створіть конфігураційний файл Intlayer, щоб визначити ваші підтримувані локалі:
+
+**Якщо ви також хочете експортувати JSON-словники для next-intl**, додайте плагін `syncJSON`:
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Плагін `syncJSON` автоматично обгортає JSON. Він читатиме та записуватиме JSON-файли, не змінюючи архітектуру вмісту.
+
+Якщо ви хочете співіснування цих JSON разом із файлами декларації вмісту Intlayer (`.content` файли), Intlayer працюватиме таким чином:
+
+    1. завантажити як JSON, так і файли декларації вмісту та перетворити їх на словник Intlayer.
+    2. якщо існують конфлікти між JSON і файлами декларації вмісту, Intlayer виконає злиття всіх цих словників. Це залежатиме від пріоритету плагінів і пріоритету файлу декларації вмісту (усе можна налаштувати).
+
+Якщо зміни внесені через CLI для перекладу JSON або через CMS, Intlayer оновить JSON-файл новими перекладами.
+
+Щоб дізнатися більше про плагін `syncJSON`, будь ласка, зверніться до [документації плагіна syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md).
+
+### Крок 4: Налаштування AI-провайдера
+
+Intlayer відкриває набір розширених автоматизаційних та зручних для розробника можливостей для вашого i18next workflow.
+
+- **Автоматичне виявлення та заповнення відсутніх перекладів**: Intlayer сканує ваші JSON-словники, знаходить неперекладені або відсутні ключі й перекладає лише їх, тож 99% вашого JSON залишається незмінним.
+- **Переклад чанками для великих JSON-файлів**: коли ваші файли перекладів дуже великі, Intlayer автоматично розбиває обробку на керовані частини (chunks), перекладаючи їх окремо, щоб уникнути обмежень API та проблем із пам'яттю.
+- **Паралелізація неймспейсів**: Якщо у вас сотні неймспейсів (або файлів), Intlayer паралелізує завдання перекладу, ефективно пришвидшуючи ваші CI/CD або масові операції перекладу.
+- **Гнучка підтримка AI-провайдерів**: Оберіть бажаного AI-провайдера (наприклад, OpenAI, Claude, Gemini), просто налаштувавши облікові дані. Використовуйте власний API-ключ і за потреби змінюйте провайдерів.
+- **Надійна обробка відповідей AI**: Intlayer може обробляти крайові випадки, коли ваш AI-провайдер повертає текст або як рядок, або як об'єкт, навіть автоматично повторюючи запит, якщо формат непослідовний.
+- **Готово для CLI та CI/CD**: Запускайте перевірки Intlayer і автоматичне заповнення безпосередньо у ваших тестах або pipelines, роблячи процес локалізації надійним і автоматизованим.
+- **Інтегрується поверх вашої існуючої конфігурації**: Вам не потрібно змінювати вашу основу i18next або Next.js. Intlayer працює як додатковий плагін до вашої поточної конфігурації, надаючи всі ці переваги з мінімальною міграцією.
+
+Ось приклад налаштування AI-провайдера:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Тоді ви можете виконати наступну команду, щоб заповнити ваші переклади:
+
+```bash
+npx intlayer fill
+```
+
+Це заповнить ваші переклади за допомогою AI-провайдера, якого ви налаштували.
+
+> Див. усіх доступних AI-провайдерів у [документації конфігурації AI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md#ai-configuration).
+> Див. усі доступні команди в [документації Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+
+---
+
+## Конфігурація Git
+
+Рекомендується ігнорувати файли, згенеровані Intlayer:
+
+```plaintext fileName=".gitignore"
+# Ігнорувати файли, згенеровані Intlayer
+.intlayer
+```
+
+Ці файли можуть бути згенеровані під час процесу збірки й їх не потрібно додавати до системи контролю версій.
+
+### Розширення для VS Code
+
+Для покращення досвіду розробника встановіть офіційне **Intlayer VS Code Extension**:
+
+[Встановити з VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)

package/blog/uk/intlayer_with_react-i18next.md

@@ -0,0 +1,200 @@
+---
+createdAt: 2025-01-02
+updatedAt: 2025-11-06
+title: Як автоматизувати ваші JSON-переклади для react-i18next за допомогою Intlayer
+description: Автоматизуйте свої JSON-переклади за допомогою Intlayer та react-i18next для покращеної інтернаціоналізації у React-додатках.
+keywords:
+  - react-i18next
+  - i18next
+  - Intlayer
+  - Інтернаціоналізація
+  - i18n
+  - Блог
+  - React
+  - JavaScript
+  - TypeScript
+  - Управління контентом
+slugs:
+  - blog
+  - intlayer-with-react-i18next
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 7.0.7
+    date: 2025-11-06
+    changes: Додано документацію щодо підтримки AI-провайдерів
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Додано плагін loadJSON
+  - version: 7.0.0
+    date: 2025-10-29
+    changes: Перехід на плагін syncJSON
+---
+
+# Як автоматизувати JSON-переклади react-i18next за допомогою Intlayer
+
+<iframe title="Як автоматизувати JSON-переклади react-i18next за допомогою 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=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+## Що таке Intlayer?
+
+**Intlayer** — інноваційна відкрита бібліотека для інтернаціоналізації, створена для вирішення недоліків традиційних i18n-рішень. Вона пропонує сучасний підхід до управління контентом в React-додатках.
+
+Дивіться конкретне порівняння з react-i18next у нашому дописі в блозі [react-i18next vs. react-intl vs. Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/react-i18next_vs_react-intl_vs_intlayer.md).
+
+## Чому варто поєднувати Intlayer з react-i18next?
+
+Хоча Intlayer забезпечує відмінне самостійне рішення для i18n (див. наше [керівництво з інтеграції з React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+react.md)), ви можете захотіти поєднати його з react-i18next з кількох причин.
+
+Intlayer пропонує широкий набір **просунутих функцій**, які виходять за межі традиційних i18n-інструментів. Воно допомагає вам:
+
+- **Автоматично виявляти та заповнювати відсутні переклади**, щоб спростити локалізацію.
+- **Тестуйте та перевіряйте свої переклади** безпосередньо у своїх робочих процесах розробки або CI/CD.
+- **Керуйте контентом на рівні компонентів**, що дозволяє мати чисту, масштабовану та підтримувану структуру по всьому застосунку.
+- **Винесіть контент назовні**, щоб його могли легко редагувати вся команда (розробники, перекладачі та контент-менеджери).
+
+Однак **i18next** залишається відмінним і широко використовуваним рішенням для i18n завдяки своїй **зрілої екосистемі**, **широкій підтримці спільноти** та **широкій сумісності з плагінами**.
+
+Поєднавши **Intlayer** з **i18next**, ви отримаєте найкраще з обох світів — стабільність та зрілість екосистеми i18next разом із сучасним content management, automation та покращеним developer experience від Intlayer.
+
+Цей посібник пояснює, як використовувати Intlayer як **адаптер для i18next**, що дозволяє вам:
+
+- Поступово переходити з i18next на Intlayer.
+- Зберегти існуючі плагіни та робочі процеси i18next.
+- Автоматизувати ваші JSON-переклади в CLI або в конвеєрах CI/CD.
+- Ефективніше тестувати, синхронізувати та керувати перекладами.
+
+## Зміст
+
+<TOC/>
+
+## Покроковий посібник із налаштування Intlayer з react-i18next
+
+### Крок 1: Встановлення залежностей
+
+Встановіть необхідні пакети:
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
+**Опис пакетів:**
+
+- **intlayer**: Базова бібліотека для керування інтернаціоналізацією, декларації контенту та збірки
+- **@intlayer/sync-json-plugin**: Плагін для експорту декларацій контенту Intlayer у JSON-формат, сумісний з react-i18next
+
+### Крок 2: Реалізуйте плагін Intlayer для обгортання JSON
+
+Створіть файл конфігурації Intlayer, щоб визначити підтримувані локалі:
+
+**Якщо ви також хочете експортувати JSON-словники для react-i18next**, додайте плагін `syncJSON`:
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Плагін `syncJSON` автоматично обгортатиме JSON. Він читатиме та записуватиме JSON-файли, не змінюючи архітектуру вмісту.
+
+Якщо ви хочете, щоб цей JSON співіснував із файлами декларації вмісту Intlayer (`.content` файли), Intlayer виконуватиме наступні кроки:
+
+    1. завантажити як JSON-файли, так і файли декларації вмісту та перетворити їх на словник Intlayer.
+    2. якщо виникнуть конфлікти між JSON та файлами декларації контенту, Intlayer виконає злиття всіх словників. Порядок злиття залежатиме від пріоритету плагінів та пріоритету файлу декларації контенту (усі ці параметри конфігуруються).
+
+Якщо зміни вносяться через CLI для перекладу JSON або через CMS, Intlayer оновить JSON-файл новими перекладами.
+
+Щоб дізнатися більше про плагін `syncJSON`, будь ласка, див. [документацію плагіна syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md).
+
+### Крок 4: Налаштування AI-провайдера
+
+Intlayer відкриває набір просунутих автоматизацій і функцій, орієнтованих на розробника, для вашого i18next workflow.
+
+- **Автоматичне виявлення та заповнення відсутніх перекладів**: Intlayer сканує ваші JSON-словники, знаходить неперекладені або відсутні ключі та перекладає лише їх, тож 99% вашого JSON залишається незмінним.
+- **Чанкований переклад для великих JSON-файлів**: Коли ваші файли перекладу дуже великі, Intlayer автоматично розбиває обробку на керовані частини (chunks), перекладаючи їх незалежно, щоб уникнути обмежень API та проблем з пам'яттю.
+- **Паралелізація namespace-ів**: Якщо у вас сотні namespace-ів (або файлів), Intlayer паралелізує завдання перекладу, ефективно пришвидшуючи ваші CI/CD або масові операції перекладу.
+- **Гнучка підтримка постачальників AI**: Вибирайте бажаного постачальника AI (наприклад, OpenAI, Claude, Gemini), просто налаштувавши облікові дані. Використовуйте власний API-ключ і перемикайте постачальників за потреби.
+- **Надійна обробка відповідей AI**: Intlayer може обробляти крайові випадки, коли ваш постачальник AI повертає текст або як рядок, або як об'єкт, навіть автоматично повторюючи запит, якщо формат непослідовний.
+- **Готово до CLI та CI/CD**: Виконуйте перевірки Intlayer і автоматичне заповнення безпосередньо в тестах або пайплайнах, роблячи процес локалізації надійним та автоматизованим.
+- **Інтегрується поверх вашої існуючої конфігурації**: Не потрібно змінювати вашу основу на i18next або Next.js. Intlayer працює як додатковий плагін до вашої поточної конфігурації, надаючи всі ці переваги з мінімальною міграцією.
+
+Ось приклад того, як налаштувати AI-провайдера:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Потім ви можете виконати наступну команду, щоб заповнити ваші переклади:
+
+```bash
+npx intlayer fill
+```
+
+Це заповнить ваші переклади за допомогою AI-провайдера, якого ви налаштували.
+
+> Перегляньте всі доступні AI-провайдери в [документації конфігурації Intlayer AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md#ai-configuration).
+> Перегляньте всі доступні команди в [документації CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+
+## Налаштування Git
+
+Рекомендується ігнорувати автоматично згенеровані файли Intlayer:
+
+```plaintext fileName=".gitignore"
+# Ігнорувати файли, згенеровані Intlayer
+.intlayer
+```
+
+Ці файли можуть бути відновлені під час процесу збірки й їх не потрібно додавати до системи контролю версій.
+
+### Розширення для VS Code
+
+Для покращення досвіду розробника встановіть офіційне **Intlayer VS Code Extension**:
+
+[Встановити з VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)