@intlayer/docs 5.7.8 → 5.8.0

package/blog/ru/intlayer_with_next-intl.md

@@ -23,7 +23,6 @@ slugs:
 Они делят три основных понятия:
 
 1. **Декларация содержимого**: Метод определения переводимого содержимого вашего приложения.
-
    - Называется `content declaration file` в Intlayer, что может быть JSON, JS или TS файлом, экспортирующим структурированные данные. Смотрите [документацию Intlayer](https://intlayer.org/fr/doc/concept/content) для получения дополнительной информации.
    - Называется `messages` или `locale messages` в next-intl, обычно в JSON-файлах. Смотрите [документацию next-intl](https://github.com/amannn/next-intl) для получения дополнительной информации.
 
@@ -170,8 +169,8 @@ const content = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
@@ -188,8 +187,8 @@ const content = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -205,8 +204,8 @@ module.exports = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };

package/blog/ru/intlayer_with_react-i18next.md

@@ -247,8 +247,8 @@ const content = {
     // Каждый вызов "t" - это отдельный узел перевода
     heading: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     description: t({
       en: "My i18n description text...",

package/blog/ru/intlayer_with_react-intl.md

@@ -118,8 +118,8 @@ const content = {
     // Каждый вызов t() объявляет переводимое поле
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     description: t({
       en: "This is a description",

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

@@ -1,14 +1,14 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: next-i18next vs next-intl vs Intlayer
-description: Сравнить next-i18next с next-intl и Intlayer для интернационализации (i18n) приложения Next.js
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: next-i18next против next-intl и Intlayer
+description: Сравнение next-i18next с next-intl и Intlayer для интернационализации (i18n) приложения Next.js
 keywords:
   - next-intl
   - next-i18next
   - Intlayer
   - Интернационализация
-  - Документация
+  - Блог
   - Next.js
   - JavaScript
   - React
@@ -17,269 +17,146 @@ slugs:
   - next-i18next-vs-next-intl-vs-intlayer
 ---
 
-# next-i18next VS next-intl VS Intlayer | Internationalization (i18n) на Next.js
+# next-i18next ПРОТИВ next-intl ПРОТИВ intlayer | Интернационализация (i18n) Next.js
 
-Ниже представлено краткое сравнение **трех популярных библиотек** для интернационализации (i18n) приложения на Next.js: **next-intl**, **next-i18next** и **Intlayer**.
+Это руководство сравнивает три широко используемых варианта i18n для **Next.js**: **next-intl**, **next-i18next** и **Intlayer**.
+Мы сосредотачиваемся на **Next.js 13+ App Router** (с **React Server Components**) и оцениваем:
 
-Этот документ подчеркивает ключевые критерии:
+1. **Архитектуру и организацию контента**
+2. **TypeScript и безопасность**
+3. **Обработку отсутствующих переводов**
+4. **Маршрутизация и промежуточное ПО**
+5. **Производительность и поведение загрузки**
+6. **Опыт разработчика (DX), инструменты и сопровождение**
+7. **SEO и масштабируемость для крупных проектов**
 
-1. **Архитектура** (сохранение переводов рядом с компонентами)
-2. **Поддержка TypeScript**
-3. **Управление отсутствующими переводами**
-4. **Поддержка серверных компонентов**
-5. **Улучшенный роутинг и промежуточное ПО** для Next.js
-6. **Простота настройки**
-
-Руководство также предлагает **углубленный обзор Intlayer**, показывая, почему это может быть сильным выбором, особенно для Next.js 13+, включая **App Router** и **Server Components**.
+> **кратко**: Все три решения могут локализовать приложение Next.js. Если вам нужен **контент, ограниченный компонентом**, **строгая типизация TypeScript**, **проверки отсутствующих ключей на этапе сборки**, **дерево-стряхиваемые словари** и **первоклассная поддержка App Router и SEO**, то **Intlayer** - самый полный и современный выбор.
 
 ---
 
-## Обзор каждой библиотеки
-
-### 1. next-intl
+## Общее позиционирование
 
-**Основное внимание**: Быстрая и простая настройка с легким подходом к локализации.
+- **next-intl** - Легковесное, простое форматирование сообщений с надежной поддержкой Next.js. Централизованные каталоги распространены; опыт разработчика (DX) простой, но безопасность и сопровождение крупных проектов в основном остаются вашей ответственностью.
+- **next-i18next** - i18next в обертке Next.js. Зрелая экосистема и функции через плагины (например, ICU), но конфигурация может быть многословной, а каталоги имеют тенденцию к централизации по мере роста проектов.
+- **Intlayer** - Контентная модель, ориентированная на компоненты для Next.js, **строгая типизация TS**, **проверки на этапе сборки**, **дерево-стряхивание**, **встроенное промежуточное ПО и SEO помощники**, опциональный **Визуальный редактор/CMS** и **переводы с помощью ИИ**.
 
-- **Архитектура**: Предлагает расположение переводов в одной папке (например, `locales/`), но также допускает несколько стратегий. Не строго требует архитектуры «перевод на компонент».
-- **Поддержка TypeScript**: Базовая интеграция TypeScript. Некоторые определения типов существуют, но они не сильно ориентированы на авто-генерацию определений TypeScript из файлов перевода.
-- **Отсутствующие переводы**: Базовый механизм резервного копирования. По умолчанию возвращает ключ или строку локали по умолчанию. Нет надежных инструментов «из коробки» для проверки отсутствующих переводов.
-- **Поддержка серверных компонентов**: Работает с Next.js 13+ в общем плане, но шаблон менее специализирован для глубокого серверного использования (например, серверные компоненты с комплексным динамическим роутингом).
-- **Роутинг и промежуточное ПО**: Поддержка промежуточного ПО возможна, но ограничена. Обычно полагается на `Middleware` Next.js для определения локали или ручную настройку для переписывания локальных путей.
-- **Простота настройки**: Очень просто. Минимальный шаблон необходим.
+---
 
-**Используйте, когда**: Вам нужен более простой подход или вы комфортно управляете переводами более традиционными способами (например, одна папка с файлами локалей JSON).
+## Сравнение функций бок о бок (с фокусом на Next.js)
+
+| Особенность                                               | `next-intlayer` (Intlayer)                                                                                                                           | `next-intl`                                                                                                                      | `next-i18next`                                                                                                                   |
+| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| **Переводы рядом с компонентами**                         | ✅ Да, контент расположен рядом с каждым компонентом                                                                                                 | ❌ Нет                                                                                                                           | ❌ Нет                                                                                                                           |
+| **Интеграция с TypeScript**                               | ✅ Продвинутая, автоматически сгенерированные строгие типы                                                                                           | ✅ Хорошая                                                                                                                       | ⚠️ Базовая                                                                                                                       |
+| **Обнаружение отсутствующих переводов**                   | ✅ Подсветка ошибок TypeScript и ошибки/предупреждения во время сборки                                                                               | ⚠️ Запасной вариант во время выполнения                                                                                          | ⚠️ Запасной вариант во время выполнения                                                                                          |
+| **Богатый контент (JSX/Markdown/компоненты)**             | ✅ Прямая поддержка                                                                                                                                  | ❌ Не предназначено для сложных узлов                                                                                            | ⚠️ Ограничено                                                                                                                    |
+| **Перевод с использованием ИИ**                           | ✅ Да, поддерживает нескольких поставщиков ИИ. Используется с вашими собственными API-ключами. Учитывает контекст вашего приложения и объем контента | ❌ Нет                                                                                                                           | ❌ Нет                                                                                                                           |
+| **Визуальный редактор**                                   | ✅ Да, локальный визуальный редактор + опциональная CMS; может выносить содержимое кодовой базы; встраиваемый                                        | ❌ Нет / доступно через внешние платформы локализации                                                                            | ❌ Нет / доступно через внешние платформы локализации                                                                            |
+| **Локализованная маршрутизация**                          | ✅ Да, поддерживает локализованные пути из коробки (работает с Next.js и Vite)                                                                       | ✅ Встроенная, App Router поддерживает сегмент `[locale]`                                                                        | ✅ Встроенная                                                                                                                    |
+| **Динамическая генерация маршрутов**                      | ✅ Да                                                                                                                                                | ✅ Да                                                                                                                            | ✅ Да                                                                                                                            |
+| **Множественное число**                                   | ✅ Шаблоны на основе перечислений                                                                                                                    | ✅ Хорошо                                                                                                                        | ✅ Хорошо                                                                                                                        |
+| **Форматирование (даты, числа, валюты)**                  | ✅ Оптимизированные форматтеры (Intl под капотом)                                                                                                    | ✅ Хорошо (помощники Intl)                                                                                                       | ✅ Хорошо (помощники Intl)                                                                                                       |
+| **Формат контента**                                       | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml в разработке)                                                                                            | ✅ .json, .js, .ts                                                                                                               | ⚠️ .json                                                                                                                         |
+| **Поддержка ICU**                                         | ⚠️ В разработке                                                                                                                                      | ✅ Да                                                                                                                            | ⚠️ Через плагин (`i18next-icu`)                                                                                                  |
+| **SEO помощники (hreflang, sitemap)**                     | ✅ Встроенные инструменты: помощники для sitemap, robots.txt, метаданных                                                                             | ✅ Хорошо                                                                                                                        | ✅ Хорошо                                                                                                                        |
+| **Экосистема / Сообщество**                               | ⚠️ Меньше, но быстро растет и активно развивается                                                                                                    | ✅ Среднего размера, ориентировано на Next.js                                                                                    | ✅ Среднего размера, ориентировано на Next.js                                                                                    |
+| **Серверный рендеринг и серверные компоненты**            | ✅ Да, оптимизировано для SSR / React Server Components                                                                                              | ⚠️ Поддерживается на уровне страницы, но необходимо передавать t-функции в дерево компонентов для дочерних серверных компонентов | ⚠️ Поддерживается на уровне страницы, но необходимо передавать t-функции в дерево компонентов для дочерних серверных компонентов |
+| **Tree-shaking (загрузка только используемого контента)** | ✅ Да, по компонентам во время сборки через плагины Babel/SWC                                                                                        | ⚠️ Частично                                                                                                                      | ⚠️ Частично                                                                                                                      |
+| **Отложенная загрузка**                                   | ✅ Да, по локали / по словарю                                                                                                                        | ✅ Да (по маршруту/по локали), требуется управление пространствами имён                                                          | ✅ Да (по маршруту/по локали), требуется управление пространствами имён                                                          |
+| **Удаление неиспользуемого контента**                     | ✅ Да, по словарю во время сборки                                                                                                                    | ❌ Нет, можно управлять вручную с помощью управления пространствами имён                                                         | ❌ Нет, можно управлять вручную с помощью управления пространствами имён                                                         |
+| **Управление крупными проектами**                         | ✅ Поощряет модульность, подходит для дизайн-систем                                                                                                  | ✅ Модульный с настройкой                                                                                                        | ✅ Модульный с настройкой                                                                                                        |
 
 ---
 
-### 2. next-i18next
+## Подробное сравнение
 
-**Основное внимание**: Проверенное временем решение, использующее `i18next` под капотом, широко принято для проектов на Next.js.
+### 1) Архитектура и масштабируемость
 
-- **Архитектура**: Обычно организует переводы в папке `public/locales`. Не специально разработано для сохранения переводов «рядом» с каждым компонентом, хотя вы можете вручную принять другую структуру.
-- **Поддержка TypeScript**: Разумное покрытие TypeScript, но требует пользовательской настройки для типизированных переводов и типизированных хуков.
-- **Отсутствующие переводы**: i18next предлагает интерполяцию/резервные копии. Однако определение отсутствующих переводов обычно требует дополнительной настройки или сторонних плагинов.
-- **Поддержка серверных компонентов**: Документировано базовое использование с Next.js 13, но расширенное использование (например, глубокая интеграция с серверными компонентами, генерация динамических маршрутов) может быть затруднительным.
-- **Роутинг и промежуточное ПО**: В значительной степени полагается на `Middleware` Next.js и переписывания для подмаршрутов локали. Для более сложных настроек, возможно, вам нужно будет углубиться в продвинутую конфигурацию i18next.
-- **Простота настройки**: Знакомый подход для тех, кто привык к i18next. Однако он может стать более громоздким, когда требуются продвинутые функции i18n (пространства имен, несколько локалей по умолчанию и т. д.).
+- **next-intl / next-i18next**: По умолчанию используют **централизованные каталоги** по локалям (плюс **пространства имён** в i18next). Хорошо работает на начальном этапе, но часто становится большой общей областью с ростом связанности и изменчивости ключей.
+- **Intlayer**: Поощряет использование словарей **на уровне компонентов** (или функций), **расположенных рядом** с кодом, который они обслуживают. Это снижает когнитивную нагрузку, облегчает дублирование/миграцию элементов интерфейса и уменьшает конфликты между командами. Неиспользуемый контент естественным образом легче обнаружить и удалить.
 
-**Используйте, когда**: Вы уже привержены экосистеме `i18next` или имеете существующие переводы на основе i18next.
+**Почему это важно:** В больших кодовых базах или при настройке дизайн-систем **модульный контент** масштабируется лучше, чем монолитные каталоги.
 
 ---
 
-### 3. Intlayer
-
-**Основное внимание**: Современная, открытая библиотека i18n, специально адаптированная для Next.js **App Router** (12, 13, 14 и 15) с встроенной поддержкой **Server Components** и **Turbopack**.
+### 2) TypeScript и безопасность
 
-#### Ключевые преимущества
+- **next-intl**: Надежная поддержка TypeScript, но **ключи по умолчанию не строго типизированы**; вам придется самостоятельно поддерживать паттерны безопасности.
+- **next-i18next**: Базовые типы для хуков; **строгая типизация ключей требует дополнительного инструментария/конфигурации**.
+- **Intlayer**: **Генерирует строгие типы** из вашего контента. **Автодополнение в IDE** и **ошибки на этапе компиляции** ловят опечатки и отсутствующие ключи до деплоя.
 
-1. **Архитектура**
+**Почему это важно:** Сильная типизация сдвигает ошибки **налево** (CI/сборка), а не **направо** (время выполнения).
 
-   - Поощряет размещение **переводов прямо рядом с их компонентами**. Каждая страница или компонент может иметь свой собственный файл `.content.ts` (или JSON), никакого более копания в гигантской папке с переводами.
-   - Это делает ваш код более **модульным и поддерживаемым**, особенно в больших кодовых базах.
-
-2. **Поддержка TypeScript**
-
-   - **Авто-генерируемые определения типов**: В момент, когда вы определяете свой контент, Intlayer генерирует типы, которые обеспечивают автозаполнение и ловят ошибки перевода.
-   - Минимизирует ошибки выполнения, такие как отсутствующие ключи, и предлагает расширенное **автозаполнение** прямо в вашей IDE.
-
-3. **Управление отсутствующими переводами**
+---
 
-   - Во время сборки Intlayer может **обнаружить отсутствующие ключи перевода** и выдать предупреждения или ошибки.
-   - Это обеспечивает, чтобы вы никогда случайно не отправляли язык с отсутствующим текстом.
+### 3) Обработка отсутствующих переводов
 
-4. **Оптимизирован для серверных компонентов**
+- **next-intl / next-i18next**: Полагаются на **запасные варианты во время выполнения** (например, показывают ключ или локаль по умолчанию). Сборка не падает.
+- **Intlayer**: **Обнаружение на этапе сборки** с **предупреждениями/ошибками** для отсутствующих локалей или ключей.
 
-   - Полностью совместим с **App Router** Next.js и новым парадигмой **Server Components**.
-   - Предоставляет специализированные провайдеры (`IntlayerServerProvider`, `IntlayerClientProvider`), чтобы **изолировать серверный контекст** (что важно при работе с Next.js 13+).
+**Почему это важно:** Выявление пробелов во время сборки предотвращает появление «загадочных строк» в продакшене и соответствует строгим требованиям к релизу.
 
-5. **Улучшенный роутинг и промежуточное ПО**
+---
 
-   - Включает специальное [**`intlayerMiddleware`**](#) для **автоматического определения локали** (через cookies или заголовки браузера) и расширенной генерации маршрутов.
-   - Динамически обрабатывает локализованные пути (например, `/en-US/about` против `/fr/about`) с минимальной конфигурацией.
-   - Предлагает вспомогательные методы, такие как `getMultilingualUrls` для генерации альтернативных языковых ссылок (отлично для **SEO**).
+### 4) Маршрутизация, middleware и стратегия URL
 
-6. **Упрощенная настройка**
-   - Один конфигурационный файл (`intlayer.config.ts`), чтобы определить ваши локали, локаль по умолчанию и предпочтения интеграции.
-   - Плагин-обертка `withIntlayer(nextConfig)`, который **внедряет** все переменные окружения и наблюдатели за вашим контентом.
-   - **Нет больших конфигураций по умолчанию**, система построена так, чтобы «просто работать» с минимальным трением.
+- Все три работают с **локализованной маршрутизацией Next.js** на App Router.
+- **Intlayer** идет дальше с **i18n middleware** (определение локали через заголовки/куки) и **хелперами** для генерации локализованных URL и тегов `<link rel="alternate" hreflang="…">`.
 
-> **В конце концов**: Intlayer является современным решением, которое стремится **продвигать лучшие практики**: от **сохранения переводов рядом** с каждым компонентом React до предложений **надежной поддержки TS** и **легкого серверного** использования, в то время как **значительно уменьшает количество шаблонного кода**.
+**Почему это важно:** Меньше кастомных прослоек; **последовательный UX** и **чистое SEO** для всех локалей.
 
 ---
 
-## Сравнение функций бок о бок
-
-| **Функция**                                   | **next-intl**                                 | **next-i18next**                                                     | **Intlayer**                                             |
-| --------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------- |
-| **Сохранение переводов рядом с компонентами** | Частично – обычно одна папка локалей          | Не по умолчанию – часто в `public/locales`                           | **Да – рекомендуется и просто**                          |
-| **Авто-генерация TypeScript**                 | Базовые определения TS                        | Базовая поддержка TS                                                 | **Да – продвинутая «из коробки»**                        |
-| **Обнаружение отсутствующих переводов**       | В основном строки резервных копий             | В основном строки резервных копий                                    | **Да – проверки на этапе сборки**                        |
-| **Поддержка серверных компонентов**           | Работает, но не специализирован               | Поддерживается, но может быть многословно                            | **Полная поддержка с специализированными провайдерами**  |
-| **Роутинг и промежуточное ПО**                | Интегрируется вручную с промежуточным ПО Next | Предоставляется с помощью конфигурации переписывания                 | **Специальное i18n промежуточное ПО + продвинутые хуки** |
-| **Сложность настройки**                       | Простой, минимальная конфигурация             | Традиционный, может быть многословным для продвинутого использования | **Один файл конфигурации и плагин**                      |
-
----
+### 5) Совместимость с серверными компонентами (RSC)
 
-## Почему Intlayer?
+- **Все** поддерживают Next.js 13+.
+- **Intlayer** упрощает **границу между сервером и клиентом** с помощью единого API и провайдеров, разработанных для RSC, чтобы вам не приходилось передавать форматтеры или функции t через дерево компонентов.
 
-Для команд, переходящих на или строящих на основе **Next.js App Router** (версии 13, 14 или 15) с **Server Components**, Intlayer предоставляет:
+**Почему это важно:** Более чистая модель мышления и меньше крайних случаев в гибридных деревьях.
 
-1. **Упрощенная архитектура**
+---
 
-   - Каждый маршрут или компонент содержит свои переводы. Это способствует ясности и поддерживаемости.
+### 6) Производительность и поведение загрузки
 
-2. **Мощная интеграция TypeScript**
+- **next-intl / next-i18next**: Частичный контроль через **пространства имён** и **разделение по маршрутам**; существует риск включения в сборку неиспользуемых строк, если не соблюдать дисциплину.
+- **Intlayer**: Выполняет **tree-shaking** на этапе сборки и **ленивую загрузку по словарям/локалям**. Неиспользуемый контент не попадает в сборку.
 
-   - Вы получаете безопасность на уровне компилятора, избегая «ошибок-описок» или отсутствующих ключей перевода.
+**Почему это важно:** Меньшие размеры бандлов и более быстрая загрузка, особенно на сайтах с несколькими локалями.
 
-3. **Реальные предупреждения о отсутствующих переводах**
+---
 
-   - Если вы забудете ключ или перевод языка, вы будете предупреждены на этапе сборки (а не отправляя неполный UI).
+### 7) Опыт разработчика (DX), инструменты и сопровождение
 
-4. **Встроенный продвинутый роутинг**
+- **next-intl / next-i18next**: Обычно вы подключаете внешние платформы для переводов и редакционных процессов.
+- **Intlayer**: В комплекте поставляется **бесплатный визуальный редактор** и **опциональная CMS** (дружелюбная к Git или внешняя). Плюс **расширение для VSCode** для создания контента и **переводы с помощью ИИ** с использованием ваших собственных ключей провайдера.
 
-   - Автоматическое определение локали, генерация динамических маршрутов и легкое управление локализованными URL включены.
-   - Стандартное `intlayerMiddleware` не требует глубоких пользовательских переписываний.
+**Почему это важно:** Снижает операционные затраты и сокращает цикл взаимодействия между разработчиками и авторами контента.
 
-5. **Упрощенная настройка**
+---
 
-   - Минимальное количество шаблона: просто определите ваш `intlayer.config.ts`, оберните `next.config` с `withIntlayer` и добавьте официальное промежуточное ПО.
-   - Четкое и простое использование как для **серверных**, так и для **клиентских** компонентов через `IntlayerServerProvider` и `IntlayerClientProvider`.
+## Когда что выбирать?
 
-6. **Дружественный к SEO**
-   - Встроенные вспомогательные функции (`getMultilingualUrls`, атрибуты `hrefLang` и т. д.) облегчают создание страниц и карт сайтов, соответствующих требованиям SEO.
+- **Выбирайте next-intl**, если вам нужно **минималистичное** решение, вы комфортно работаете с централизованными каталогами, и ваше приложение **малое или среднего размера**.
+- **Выбирайте next-i18next**, если вам нужна **экосистема плагинов i18next** (например, расширенные правила ICU через плагины), и ваша команда уже знакома с i18next, готовая принять **больше конфигурации** ради гибкости.
+- **Выбирайте Intlayer**, если вы цените **контент, привязанный к компонентам**, **строгий TypeScript**, **гарантии на этапе сборки**, **tree-shaking** и **встроенные инструменты** для маршрутизации/SEO/редактирования - особенно для **Next.js App Router** и **больших, модульных кодовых баз**.
 
 ---
 
-## Пример: Intlayer в действии
-
-Ниже приведен _очень_ сокращенный фрагмент, иллюстрирующий, как использовать Intlayer в проекте на Next.js 15. Для получения всех деталей и примеров кода, [посмотрите полное руководство Intlayer](#).
-
-<details>
-<summary>Пошаговый пример</summary>
-
-1. **Установка и настройка**
-
-   ```bash
-   npm install intlayer next-intlayer
-   ```
-
-   ```ts
-   // intlayer.config.ts
-   import { Locales, type IntlayerConfig } from "intlayer";
-
-   const config: IntlayerConfig = {
-     internationalization: {
-       locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-       defaultLocale: Locales.ENGLISH,
-     },
-   };
-   export default config;
-   ```
-
-2. **Используйте плагин**
-
-   ```ts
-   // next.config.mjs
-   import { withIntlayer } from "next-intlayer/server";
-
-   /** @type {import('next').NextConfig} */
-   const nextConfig = {};
-
-   export default withIntlayer(nextConfig);
-   ```
-
-3. **Добавьте промежуточное ПО**
-
-   ```ts
-   // src/middleware.ts
-   export { intlayerMiddleware as middleware } from "next-intlayer/middleware";
-
-   export const config = {
-     matcher:
-       "/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\..*|_next).*)",
-   };
-   ```
-
-4. **Создайте локализованный макет**
-
-   ```tsx
-   // src/app/[locale]/layout.tsx
-   import { getHTMLTextDir } from "intlayer";
-   import { NextLayoutIntlayer } from "next-intlayer";
-
-   const LocaleLayout: NextLayoutIntlayer = async ({ children, params }) => {
-     const { locale } = params;
-     return (
-       <html lang={locale} dir={getHTMLTextDir(locale)}>
-         <body>{children}</body>
-       </html>
-     );
-   };
-
-   export { generateStaticParams } from "next-intlayer";
-   export default LocaleLayout;
-   ```
-
-5. **Объявите и используйте контент**
-
-   ```tsx
-   // src/app/[locale]/page.content.ts
-   import { t } from "intlayer";
-
-   export default {
-     key: "page",
-     content: {
-       getStarted: {
-         main: t({
-           en: "Get started by editing",
-           fr: "Commencez par éditer",
-           es: "Comience por editar",
-         }),
-         pageLink: "src/app/page.tsx",
-       },
-     },
-   };
-   ```
-
-   ```tsx
-   // src/app/[locale]/page.tsx
-   import { IntlayerServerProvider } from "next-intlayer/server";
-   import { IntlayerClientProvider, useIntlayer } from "next-intlayer";
-
-   const PageContent = () => {
-     const { content } = useIntlayer("page");
-     return (
-       <>
-         <p>{content.getStarted.main}</p>
-         <code>{content.getStarted.pageLink}</code>
-       </>
-     );
-   };
-
-   export default function Page({ params }) {
-     return (
-       <IntlayerServerProvider locale={params.locale}>
-         <IntlayerClientProvider locale={params.locale}>
-           <PageContent />
-         </IntlayerClientProvider>
-       </IntlayerServerProvider>
-     );
-   }
-   ```
-
-   </details>
+## Практические заметки по миграции (next-intl / next-i18next → Intlayer)
+
+- **Начинайте по функциям**: Переносите по одному маршруту или компоненту за раз в **локальные словари**.
+- **Сохраняйте старые каталоги параллельно**: Используйте мост во время миграции; избегайте большого «взрыва» изменений.
+- **Включайте строгие проверки**: Позвольте обнаружению на этапе сборки выявлять пробелы на раннем этапе.
+- **Используйте middleware и вспомогательные функции**: Стандартизируйте определение локали и SEO-теги по всему сайту.
+- **Измеряйте размер бандлов**: Ожидайте **сокращения размера бандлов** по мере удаления неиспользуемого контента.
 
 ---
 
 ## Заключение
 
-Каждое решение, **next-intl**, **next-i18next** и **Intlayer**, оказалось эффективным для многоязычных проектов на Next.js. Однако **Intlayer** идет дальше, предлагая:
+Все три библиотеки успешно справляются с основной локализацией. Разница в том, **сколько работы вам придется выполнить**, чтобы добиться надежной и масштабируемой настройки в **современном Next.js**:
 
-- **Сильное поощрение архитектуры перевода на уровне компонентов**
-- Бесшовную интеграцию с **Next.js 13+ и Server Components**
-- Предложения **мощного авто-генерации TypeScript** для безопасного кода
-- Обработку **отсутствующих переводов** на этапе сборки
-- Предоставление **упрощенного, единого подхода к конфигурации** с расширенным роутингом и промежуточным ПО
+- С **Intlayer** **модульный контент**, **строгая типизация TS**, **безопасность на этапе сборки**, **оптимизация бандлов с tree-shaking** и **первоклассный App Router + SEO-инструменты** являются **стандартом**, а не рутиной.
+- Если ваша команда ценит **поддерживаемость и скорость** в многоязычном приложении, построенном на компонентах, Intlayer предлагает сегодня **самый полный** опыт.
 
-Если вы хотите **современные** функции i18n, адаптированные к Next.js App Router, и ищете **полностью типизированный** опыт без ручного настройки логики резервного копирования, переписывания маршрутов или сложных шагов сборки, **Intlayer** является убедительным выбором. Он не только сокращает время настройки, но и обеспечивает более поддерживаемый, масштабируемый подход к переводам для вашей команды.
+Обратитесь к документу ['Почему Intlayer?'](https://intlayer.org/doc/why) для получения дополнительной информации.