@intlayer/docs 7.0.5 → 7.0.6

package/blog/ru/intlayer_with_next-i18next.md

@@ -16,12 +16,15 @@ slugs:
   - blog
   - intlayer-with-next-i18next
 history:
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Добавлен плагин loadJSON
   - version: 7.0.0
     date: 2025-10-29
-    changes: Переход на плагин syncJSON и полное переписывание
+    changes: Переход на плагин syncJSON и полный переписанный код
 ---
 
-# Интернационализация (i18n) Next.js с next-i18next и Intlayer
+# Интернационализация Next.js (i18n) с next-i18next и Intlayer
 
 ## Содержание
 
@@ -29,12 +32,12 @@ history:
 
 ## Что такое next-i18next?
 
-**next-i18next** — одна из самых популярных библиотек для интернационализации (i18n) в приложениях Next.js. Построенная на мощной экосистеме **i18next**, она предоставляет комплексное решение для управления переводами, локализацией и переключением языков в проектах Next.js.
+**next-i18next** — это один из самых популярных фреймворков для интернационализации (i18n) в приложениях Next.js. Построенный на мощной экосистеме **i18next**, он предоставляет комплексное решение для управления переводами, локализацией и переключением языков в проектах Next.js.
 
 Однако next-i18next имеет некоторые сложности:
 
-- **Сложная конфигурация**: Настройка next-i18next требует нескольких конфигурационных файлов и тщательной настройки i18n как на стороне сервера, так и на стороне клиента.
-- **Разрозненные переводы**: Файлы переводов обычно хранятся в отдельных директориях, отличных от компонентов, что затрудняет поддержание согласованности.
+- **Сложная конфигурация**: Настройка next-i18next требует нескольких конфигурационных файлов и тщательной настройки экземпляров i18n на стороне сервера и клиента.
+- **Разрозненные переводы**: Файлы переводов обычно хранятся в отдельных директориях от компонентов, что затрудняет поддержание согласованности.
 - **Ручное управление пространствами имён**: Разработчикам необходимо вручную управлять пространствами имён и обеспечивать правильную загрузку ресурсов переводов.
 - **Ограниченная типобезопасность**: Поддержка TypeScript требует дополнительной настройки и не обеспечивает автоматическую генерацию типов для переводов.
 
@@ -50,11 +53,11 @@ history:
 
 1. **Существующая кодовая база**: У вас уже есть реализованная система next-i18next, и вы хотите постепенно перейти на улучшенный опыт разработки с Intlayer.
 2. **Требования наследия**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами i18next.
-3. **Знакомство команды**: Ваша команда привыкла к next-i18next, но хочет улучшенного управления контентом.
+3. **Знакомство команды**: Ваша команда привыкла к next-i18next, но хочет лучшее управление контентом.
 
 **Для этого Intlayer может быть реализован как адаптер для next-i18next, чтобы помочь автоматизировать ваши JSON-переводы в CLI или CI/CD пайплайнах, тестировать ваши переводы и многое другое.**
 
-В этом руководстве показано, как использовать превосходную систему декларации контента Intlayer, сохраняя совместимость с next-i18next.
+В этом руководстве показано, как использовать превосходную систему декларации контента Intlayer, сохраняя при этом совместимость с next-i18next.
 
 ---
 
@@ -62,7 +65,7 @@ history:
 
 ### Шаг 1: Установка зависимостей
 
-Установите необходимые пакеты, используя предпочитаемый менеджер пакетов:
+Установите необходимые пакеты с помощью предпочитаемого менеджера пакетов:
 
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin
@@ -76,20 +79,20 @@ pnpm add intlayer @intlayer/sync-json-plugin
 yarn add intlayer @intlayer/sync-json-plugin
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin
+```
+
 **Объяснение пакетов:**
 
 - **intlayer**: Основная библиотека для декларации и управления контентом
-- **next-intlayer**: Слой интеграции с Next.js с плагинами сборки
-- **i18next**: Основной фреймворк для интернационализации
-- **next-i18next**: Обертка Next.js для i18next
-- **i18next-resources-to-backend**: Динамическая загрузка ресурсов для i18next
-- **@intlayer/sync-json-plugin**: Плагин для синхронизации деклараций контента Intlayer в формат JSON для i18next
+- **@intlayer/sync-json-plugin**: Плагин для синхронизации деклараций контента Intlayer с форматом JSON i18next
 
-### Шаг 2: Реализация плагина Intlayer для обертки JSON
+### Шаг 2: Реализация плагина Intlayer для обёртывания JSON
 
-Создайте конфигурационный файл Intlayer для определения поддерживаемых локалей:
+Создайте файл конфигурации Intlayer для определения поддерживаемых локалей:
 
-**Если вы также хотите экспортировать JSON-словари для i18next**, добавьте плагин `syncJSON`:
+**Если вы также хотите экспортировать JSON-словарь для i18next**, добавьте плагин `syncJSON`:
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -102,7 +105,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+      source: ({ key, locale }) => `./public/locales/${locale}/${key}.json`,
     }),
   ],
 };
@@ -112,13 +115,58 @@ export default config;
 
 Плагин `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-файл с новыми переводами.
 
+Для получения дополнительной информации о плагине `syncJSON` обратитесь к [документации плагина syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md).
+
+---
+
+### (Необязательно) Шаг 3: Реализация перевода JSON по компонентам
+
+По умолчанию Intlayer загрузит, объединит и синхронизирует как JSON, так и файлы декларации контента. Подробнее смотрите в [документации по декларации контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md). Но если вы предпочитаете, используя плагин Intlayer, вы также можете реализовать управление локализованным JSON по компонентам в любом месте вашей кодовой базы.
+
+Для этого вы можете использовать плагин `loadJSON`.
+
+```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,
+  },
+
+  // Поддерживайте синхронизацию ваших текущих JSON-файлов с словарями Intlayer
+  plugins: [
+    /**
+     * Загрузит все JSON-файлы в src, которые соответствуют шаблону {key}.i18n.json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Обеспечивает приоритет этих JSON-файлов над файлами в `./public/locales/en/${key}.json`
+    }),
+    /**
+     * Загрузит, а также запишет результаты и переводы обратно в JSON-файлы в директории локалей
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./public/locales/${locale}/${key}.json`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Это загрузит все JSON-файлы в директории `src`, которые соответствуют шаблону `{key}.i18n.json`, и загрузит их как словари Intlayer.
+
 ---
 
 ## Конфигурация Git
@@ -131,12 +179,10 @@ export default config;
 intl
 ```
 
-Эти файлы автоматически пересоздаются в процессе сборки и не требуют коммита в ваш репозиторий.
+Эти файлы автоматически пересоздаются во время процесса сборки и не требуют коммита в ваш репозиторий.
 
 ### Расширение VS Code
 
-Для улучшения опыта разработчика установите официальное **расширение Intlayer для VS Code**:
-
-[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+Для улучшения опыта разработчика установите официальное расширение **Intlayer для VS Code**:
 
-[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+[Установить из магазина расширений VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)

package/blog/ru/intlayer_with_next-intl.md

@@ -7,9 +7,12 @@ slugs:
   - blog
   - intlayer-with-next-intl
 history:
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Добавлен плагин loadJSON
   - version: 7.0.0
     date: 2025-10-29
-    changes: Переход на плагин syncJSON
+    changes: Изменение на плагин syncJSON
 ---
 
 # Как автоматизировать перевод JSON для next-intl с помощью Intlayer
@@ -22,10 +25,10 @@ history:
 
 ## Почему стоит сочетать Intlayer с next-intl?
 
-Хотя Intlayer предоставляет отличное автономное решение для i18n (см. наше [руководство по интеграции с Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_16.md)), вы можете захотеть объединить его с next-intl по нескольким причинам:
+Хотя Intlayer предоставляет отличное самостоятельное решение для i18n (см. наше [руководство по интеграции с Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_16.md)), вы можете захотеть объединить его с next-intl по нескольким причинам:
 
 1. **Существующая кодовая база**: У вас уже есть реализованный next-intl, и вы хотите постепенно перейти на улучшенный опыт разработчика с Intlayer.
-2. **Требования к наследию**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами next-intl.
+2. **Требования наследия**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами next-intl.
 3. **Знакомство команды**: Ваша команда привыкла работать с next-intl, но хочет улучшить управление контентом.
 
 **Для этого Intlayer может быть реализован как адаптер для next-intl, чтобы помочь автоматизировать ваши JSON-переводы в CLI или CI/CD пайплайнах, тестировать переводы и многое другое.**
@@ -54,6 +57,10 @@ pnpm add intlayer @intlayer/sync-json-plugin
 yarn add intlayer @intlayer/sync-json-plugin
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin
+```
+
 **Описание пакетов:**
 
 - **intlayer**: Основная библиотека для управления интернационализацией, декларации контента и сборки
@@ -63,7 +70,7 @@ yarn add intlayer @intlayer/sync-json-plugin
 
 Создайте файл конфигурации Intlayer для определения поддерживаемых локалей:
 
-**Если вы также хотите экспортировать JSON-словарь для next-intl**, добавьте плагин `syncJSON`:
+**Если вы также хотите экспортировать JSON-словари для next-intl**, добавьте плагин `syncJSON`:
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -89,10 +96,54 @@ export default config;
 Если вы хотите, чтобы 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/ru/plugins/sync-json.md).
+
+### (Необязательно) Шаг 3: Реализация переводов JSON для каждого компонента
+
+По умолчанию Intlayer загружает, объединяет и синхронизирует как JSON, так и файлы декларации контента. Подробнее смотрите в [документации по декларации контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md). Но если вы предпочитаете, используя плагин Intlayer, вы также можете реализовать управление JSON-переводами на уровне компонентов, расположенных в любом месте вашего кода.
+
+Для этого вы можете использовать плагин `loadJSON`.
+
+```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,
+  },
+
+  // Синхронизируйте ваши текущие JSON-файлы с словарями Intlayer
+  plugins: [
+    /**
+     * Загрузит все JSON-файлы в папке src, которые соответствуют шаблону {key}.i18n.json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Обеспечивает приоритет этих JSON-файлов над файлами в `./locales/en/${key}.json`
+    }),
+    /**
+     * Загрузит и запишет результаты и переводы обратно в JSON-файлы в директории locales
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Это загрузит все JSON-файлы в директории `src`, которые соответствуют шаблону `{key}.i18n.json`, и загрузит их как словари Intlayer.
+
 ## Конфигурация Git
 
 Рекомендуется игнорировать автоматически сгенерированные файлы Intlayer:
@@ -102,12 +153,10 @@ export default config;
 .intlayer
 ```
 
-Эти файлы могут быть восстановлены в процессе сборки и не требуют коммита в систему контроля версий.
+Эти файлы могут быть восстановлены во время процесса сборки и не требуют добавления в систему контроля версий.
 
 ### Расширение VS Code
 
 Для улучшения опыта разработчика установите официальное **расширение Intlayer для VS Code**:
 
 [Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)

package/blog/ru/intlayer_with_react-i18next.md

@@ -18,6 +18,9 @@ slugs:
   - blog
   - intlayer-with-react-i18next
 history:
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Добавлен плагин loadJSON
   - version: 7.0.0
     date: 2025-10-29
     changes: Переход на плагин syncJSON
@@ -27,21 +30,22 @@ history:
 
 ## Что такое Intlayer?
 
-**Intlayer** — это инновационная, открытая библиотека интернационализации, разработанная для устранения недостатков традиционных решений i18n. Она предлагает современный подход к управлению контентом в React-приложениях.
+**Intlayer** — это инновационная, с открытым исходным кодом библиотека интернационализации, разработанная для устранения недостатков традиционных решений i18n. Она предлагает современный подход к управлению контентом в React-приложениях.
 
 Смотрите конкретное сравнение с react-i18next в нашем блоге [react-i18next vs. react-intl vs. Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/react-i18next_vs_react-intl_vs_intlayer.md).
 
 ## Почему стоит сочетать Intlayer с react-i18next?
 
-Хотя Intlayer предоставляет отличное самостоятельное решение i18n (см. наше [руководство по интеграции с React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)), вы можете захотеть объединить его с react-i18next по нескольким причинам:
+Хотя Intlayer предоставляет отличное самостоятельное решение для i18n (см. наше [руководство по интеграции с React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)), вы можете захотеть сочетать его с react-i18next по нескольким причинам:
 
-1. **Существующая кодовая база**: У вас уже есть реализованная система на react-i18next, и вы хотите постепенно перейти на улучшенный опыт разработки с Intlayer.
-2. **Требования к совместимости**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами react-i18next.
+1. **Существующая кодовая база**: У вас уже есть реализованная система react-i18next, и вы хотите постепенно перейти на улучшенный опыт разработчика с Intlayer.
+2. **Требования наследия**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами react-i18next.
 3. **Знакомство команды**: Ваша команда привыкла к react-i18next, но хочет улучшить управление контентом.
+4. **Использование возможностей Intlayer**: Вы хотите использовать функции Intlayer, такие как декларация контента, автоматизация переводов, тестирование переводов и многое другое.
 
 **Для этого Intlayer может быть реализован как адаптер для react-i18next, чтобы помочь автоматизировать ваши JSON-переводы в CLI или CI/CD пайплайнах, тестировать переводы и многое другое.**
 
-В этом руководстве показано, как использовать превосходную систему декларации контента Intlayer, сохраняя при этом совместимость с react-i18next.
+Это руководство показывает, как использовать превосходную систему декларации контента Intlayer, сохраняя при этом совместимость с react-i18next.
 
 ## Содержание
 
@@ -65,14 +69,18 @@ pnpm add intlayer @intlayer/sync-json-plugin
 yarn add intlayer @intlayer/sync-json-plugin
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin
+```
+
 **Описание пакетов:**
 
 - **intlayer**: Основная библиотека для управления интернационализацией, декларации контента и сборки
 - **@intlayer/sync-json-plugin**: Плагин для экспорта деклараций контента Intlayer в JSON-формат, совместимый с react-i18next
 
-### Шаг 2: Реализация плагина Intlayer для обёртывания JSON
+### Шаг 2: Реализация плагина Intlayer для обёртки JSON
 
-Создайте конфигурационный файл Intlayer для определения поддерживаемых локалей:
+Создайте файл конфигурации Intlayer для определения поддерживаемых локалей:
 
 **Если вы также хотите экспортировать JSON-словари для react-i18next**, добавьте плагин `syncJSON`:
 
@@ -87,7 +95,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],
 };
@@ -95,16 +103,57 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Плагин `syncJSON` автоматически обернет JSON. Он будет читать и записывать JSON-файлы без изменения архитектуры контента.
+Плагин `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/ru/plugins/sync-json.md).
 
-Если вы хотите, чтобы JSON сосуществовал с файлами декларации контента intlayer (`.content` файлы), Intlayer будет работать следующим образом:
+### (Необязательно) Шаг 3: Реализация перевода JSON по компонентам
+
+По умолчанию Intlayer загружает, объединяет и синхронизирует как JSON, так и файлы деклараций контента. Подробнее смотрите в [документации по декларации контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md). Но если вы предпочитаете, используя плагин Intlayer, вы также можете реализовать управление локализованным JSON по компонентам в любом месте вашей кодовой базы.
+
+Для этого вы можете использовать плагин `loadJSON`.
+
+```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,
+  },
 
-    1. загрузить как JSON, так и файлы декларации контента и преобразовать их в словарь intlayer.
-    2. если возникают конфликты между JSON и файлами декларации контента, Intlayer выполнит слияние всех этих словарей. В зависимости от приоритета плагинов и файла декларации контента (все настраивается).
+  // Синхронизируйте ваши текущие JSON-файлы с словарями Intlayer
+  plugins: [
+    /**
+     * Загрузит все JSON-файлы в папке src, соответствующие шаблону {key}.i18n.json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Обеспечивает приоритет этих JSON-файлов над файлами в `./locales/en/${key}.json`
+    }),
+    /**
+     * Загрузит и запишет результат и переводы обратно в JSON-файлы в директории locales
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+    }),
+  ],
+};
 
-Если изменения внесены с помощью CLI для перевода JSON или с использованием CMS, Intlayer обновит JSON-файл с новыми переводами.
+export default config;
+```
 
-Для получения дополнительной информации о плагине `syncJSON` обратитесь к [документации плагина syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md).
+Это загрузит все JSON-файлы в каталоге `src`, которые соответствуют шаблону `{key}.i18n.json`, и загрузит их как словари Intlayer.
 
 ## Конфигурация Git
 
@@ -115,10 +164,10 @@ export default config;
 .intlayer
 ```
 
-Эти файлы могут быть сгенерированы заново в процессе сборки и не требуют добавления в систему контроля версий.
+Эти файлы могут быть восстановлены во время процесса сборки и не требуют добавления в систему контроля версий.
 
 ### Расширение VS Code
 
-Для улучшения опыта разработчика установите официальное **Расширение Intlayer для VS Code**:
+Для улучшения опыта разработчика установите официальное **расширение Intlayer для VS Code**:
 
 [Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)

package/blog/ru/intlayer_with_react-intl.md

@@ -16,13 +16,20 @@ slugs:
   - blog
   - intlayer-with-react-intl
 history:
+  - version: 7.0.6
+    date: 2025-11-01
+    changes: Добавлен плагин loadJSON
   - version: 7.0.0
     date: 2025-10-29
-    changes: Переход на плагин syncJSON
+    changes: Изменён на плагин syncJSON
 ---
 
 # Как автоматизировать ваши JSON-переводы react-intl с помощью Intlayer
 
+## Содержание
+
+<TOC/>
+
 ## Что такое Intlayer?
 
 **Intlayer** — это инновационная, открытая библиотека интернационализации, разработанная для устранения недостатков традиционных решений i18n. Она предлагает современный подход к управлению контентом в React-приложениях.
@@ -31,15 +38,16 @@ history:
 
 ## Почему стоит сочетать Intlayer с react-intl?
 
-Хотя Intlayer предоставляет отличное самостоятельное решение для i18n (см. наше [руководство по интеграции с React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)), вы можете захотеть сочетать его с react-intl по нескольким причинам:
+Хотя Intlayer предоставляет отличное самостоятельное решение для i18n (см. наше [руководство по интеграции с React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)), вы можете захотеть использовать его вместе с react-intl по нескольким причинам:
 
-1. **Существующая кодовая база**: У вас уже есть реализованная система react-intl, и вы хотите постепенно перейти на улучшенный опыт разработчика с Intlayer.
+1. **Существующая кодовая база**: У вас уже есть реализованная система на react-intl, и вы хотите постепенно перейти на улучшенный опыт разработки с Intlayer.
 2. **Требования наследия**: Ваш проект требует совместимости с существующими плагинами или рабочими процессами react-intl.
 3. **Знакомство команды**: Ваша команда привыкла к react-intl, но хочет улучшить управление контентом.
+4. **Использование возможностей Intlayer**: Вы хотите использовать функции Intlayer, такие как декларация контента, автоматизация перевода, тестирование переводов и многое другое.
 
 **Для этого Intlayer может быть реализован как адаптер для react-intl, чтобы помочь автоматизировать ваши JSON-переводы в CLI или CI/CD пайплайнах, тестировать переводы и многое другое.**
 
-Это руководство покажет вам, как использовать превосходную систему декларации контента Intlayer, сохраняя при этом совместимость с react-intl.
+Это руководство показывает, как использовать превосходную систему декларации контента Intlayer, сохраняя при этом совместимость с react-intl.
 
 ## Содержание
 
@@ -63,16 +71,20 @@ pnpm add intlayer @intlayer/sync-json-plugin
 yarn add intlayer @intlayer/sync-json-plugin
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin
+```
+
 **Описание пакетов:**
 
 - **intlayer**: Основная библиотека для управления интернационализацией, декларации контента и сборки
-- **@intlayer/sync-json-plugin**: Плагин для экспорта деклараций контента Intlayer в JSON-формат, совместимый с react-intl
+- **@intlayer/sync-json-plugin**: Плагин для экспорта деклараций контента Intlayer в формат JSON, совместимый с react-intl
 
-### Шаг 2: Реализация плагина Intlayer для обёртки JSON
+### Шаг 2: Реализация плагина Intlayer для обертки JSON
 
-Создайте конфигурационный файл Intlayer для определения поддерживаемых локалей:
+Создайте файл конфигурации Intlayer для определения поддерживаемых локалей:
 
-**Если вы также хотите экспортировать JSON-словари для react-intl**, добавьте плагин `syncJSON`:
+**Если вы также хотите экспортировать словари JSON для react-intl**, добавьте плагин `syncJSON`:
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -93,16 +105,57 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Плагин `syncJSON` автоматически обернет JSON. Он будет читать и записывать JSON-файлы без изменения архитектуры контента.
+Плагин `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/ru/plugins/sync-json.md).
+
+### (Необязательно) Шаг 3: Реализация переводов JSON по компонентам
+
+По умолчанию Intlayer загрузит, объединит и синхронизирует как JSON, так и файлы деклараций контента. Подробнее смотрите в [документации по декларации контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md). Но если вы предпочитаете, используя плагин Intlayer, вы также можете реализовать управление локализованным JSON по компонентам в любом месте вашей кодовой базы.
+
+Для этого вы можете использовать плагин `loadJSON`.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
 
-Если вы хотите, чтобы JSON сосуществовал с файлами декларации контента intlayer (`.content` файлы), Intlayer будет работать следующим образом:
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
 
-    1. загрузит как JSON, так и файлы декларации контента и преобразует их в словарь intlayer.
-    2. если возникают конфликты между JSON и файлами декларации контента, Intlayer выполнит слияние всех словарей. В зависимости от приоритета плагинов и файла декларации контента (все настраивается).
+  // Синхронизируйте ваши текущие JSON-файлы с словарями Intlayer
+  plugins: [
+    /**
+     * Загрузит все JSON-файлы в папке src, соответствующие шаблону {key}.i18n.json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Обеспечивает приоритет этих JSON-файлов над файлами в `./locales/en/${key}.json`
+    }),
+    /**
+     * Загрузит и запишет результат и переводы обратно в JSON-файлы в директории locales
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
+      priority: 0,
+    }),
+  ],
+};
 
-Если изменения вносятся с помощью CLI для перевода JSON или с использованием CMS, Intlayer обновит JSON-файл с новыми переводами.
+export default config;
+```
 
-Для получения дополнительной информации о плагине `syncJSON` обратитесь к [документации плагина syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md).
+Это загрузит все JSON-файлы в каталоге `src`, которые соответствуют шаблону `{key}.i18n.json`, и загрузит их как словари Intlayer.
 
 ## Конфигурация Git
 
@@ -117,6 +170,6 @@ export default config;
 
 ### Расширение VS Code
 
-Для улучшения опыта разработчика установите официальное **Расширение Intlayer для VS Code**:
+Для улучшения опыта разработчика установите официальное **расширение Intlayer для VS Code**:
 
-[Установить из магазина расширений VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+[Установить из VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)