@intlayer/docs 9.4.4 → 9.5.0

package/docs/ru/migration_from_i18next_to_intlayer.md

@@ -32,7 +32,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -40,25 +39,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)** (self-hosted) и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -66,8 +61,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегии миграции
 
 Существует две дополняющие друг друга стратегии миграции с `i18next` на Intlayer:
@@ -78,20 +71,15 @@ Intlayer также является **наиболее активно разв
 
 В этом руководстве сначала рассматривается **Стратегия 1** (адаптер совместимости), а затем опциональная полная миграция.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это минимум, необходимый для запуска вашего существующего приложения `i18next` с использованием Intlayer без внесения изменений в бизнес-логику кода.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптер совместимости:
@@ -135,7 +123,6 @@ bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
 > Вы можете смело оставить установленным `i18next` — адаптер совместимости использует его как `devDependency` / `peerDependency` для типов TypeScript.
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает файл `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы переводов (messages):
@@ -170,7 +157,6 @@ export default config;
 > **`source`** сопоставляет локаль с путем к файлу JSON. **`location`** сообщает вотчеру (watcher) Intlayer, за какой папкой следить на предмет изменений. Опция `format: 'i18next'` гарантирует, что плейсхолдеры вроде `{{name}}` будут обработаны правильно.
 
 </Step>
-
 <Step number={3} title="Обновление алиасов сборщика (опционально)">
 
 Если вы используете сборщик (Vite, Webpack, esbuild), вы можете внедрить алиас модуля, чтобы `import ... from 'i18next'` автоматически разрешался в `@intlayer/i18next`. Это избавит от необходимости изменять пути импорта вручную по всей кодовой базе.
@@ -194,14 +180,11 @@ export default defineConfig({
 
 На этом быстрая миграция завершена. Теперь ваше приложение работает на Intlayer, а все ваши импорты и API `i18next` остались нетронутыми.
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Если вы предпочитаете сделать зависимость явной в исходных файлах или не используете плагин сборщика для подмены (aliasing) импортов, вы можете переименовать пути импорта вручную:
@@ -215,7 +198,6 @@ export default defineConfig({
 Это **прямая замена** — никаких изменений в сигнатурах вызовов, аргументах или возвращаемых типах не требуется.
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов:
@@ -277,8 +259,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки адаптера совместимости следующий стандартный бойлерплейт `i18next` можно удалить:
@@ -291,8 +271,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `my-component.content.ts` прямо рядом с вашим кодом, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -307,8 +285,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -318,8 +294,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)

package/docs/ru/migration_from_next-i18next_to_intlayer.md

@@ -35,7 +35,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -43,25 +42,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)** (self-hosted) и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -69,8 +64,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегии миграции
 
 Поскольку `next-i18next` использует "под капотом" `react-i18next` и `i18next`, существует две дополняющие друг друга стратегии миграции на Intlayer:
@@ -81,20 +74,15 @@ Intlayer также является **наиболее активно разв
 
 В этом руководстве сначала рассматривается **Стратегия 1** (адаптер совместимости без существенных изменений), а затем — опциональная полная миграция.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это необходимый минимум для запуска вашего приложения Next.js (Pages Router) с Intlayer, не меняя код ни одной страницы или компонента.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптеры совместимости:
@@ -138,7 +126,6 @@ bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/r
 > Вы можете безопасно оставить установленными пакеты `next-i18next`, `react-i18next` и `i18next` во время миграции, пока все алиасы не будут настроены.
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает базовый файл конфигурации `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы сообщений `next-i18next` (обычно расположенные в `public/locales`):
@@ -173,7 +160,6 @@ export default config;
 > **`source`** сопоставляет локаль и namespace (`key`) с путем к вашему JSON-файлу. **`location`** сообщает вотчеру (watcher) Intlayer, за какой папкой нужно следить для отслеживания изменений. Настройка `format: 'i18next'` гарантирует правильную обработку плейсхолдеров, используемых в `next-i18next`.
 
 </Step>
-
 <Step number={3} title="Обновление конфигурации Next.js">
 
 Оберните ваш текущий `next.config.ts` (или `.js`) функцией `createNextI18nPlugin` из `@intlayer/next-i18next/plugin`. Эта функция-обертка применяет `withIntlayer` **и одновременно** настраивает алиасы для `next-i18next` / `react-i18next` / `i18next` → `@intlayer/*`. Таким образом, во время сборки ваши импорты вроде `import { useTranslation } from 'next-i18next'` будут прозрачно перенаправлены. Вносить изменения в исходный код не требуется.
@@ -217,14 +203,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ строгая типизация
 > ```
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Плагин Intlayer уже справляется с подменой алиасов на уровне сборщика. Если вы хотите сделать зависимости явными в ваших исходных файлах, вы можете переименовать импорты вручную:
@@ -239,7 +222,6 @@ export default withIntlayer(nextConfig);
 Это **прямые замены** — вам не нужно менять сигнатуры функций, передаваемые аргументы или возвращаемые типы.
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов:
@@ -301,8 +283,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки адаптера совместимости следующий стандартный бойлерплейт `next-i18next` можно удалить:
@@ -315,8 +295,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `my-component.content.ts` прямо рядом с вашим кодом `MyComponent.tsx`, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -331,8 +309,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -342,8 +318,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)

package/docs/ru/migration_from_next-intl_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)** (self-hosted) и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -67,8 +62,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегия миграции
 
 Рекомендуемый подход для существующих приложений — использовать **адаптер совместимости**: Установите `@intlayer/next-intl`. Этот пакет предоставляет **точно такой же API**, что и `next-intl`, но делегирует всю работу по переводу "под капотом" в Intlayer.
@@ -77,20 +70,15 @@ Intlayer также является **наиболее активно разв
 
 Со временем вы можете выборочно переводить отдельные файлы на формат `.content.ts` от Intlayer, чтобы раскрыть возможности визуального редактора, CMS и локализации на уровне компонента, но этот шаг не является обязательным и может быть выполнен постепенно.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это минимум, необходимый для запуска вашего существующего приложения `next-intl` с использованием Intlayer без внесения изменений в бизнес-логику кода.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптер совместимости `@intlayer/next-intl`:
@@ -134,7 +122,6 @@ bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
 > Сохраните `next-intl` установленным — он всё еще требуется для **маршрутизации (URL-роутинга)** (`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`). Адаптер совместимости **не** заменяет слой маршрутизации.
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает базовый файл `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы сообщений:
@@ -171,7 +158,6 @@ export default config;
 > См. [Документацию по Конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md) для ознакомления со всеми доступными настройками.
 
 </Step>
-
 <Step number={3} title="Внедрение плагина Intlayer в Next.js">
 
 Оберните вашу текущую конфигурацию Next.js функцией `createNextIntlPlugin` из `@intlayer/next-intl/plugin`. Это применяет `withIntlayer` **и одновременно** настраивает подмену алиаса `next-intl` → `@intlayer/next-intl`:
@@ -212,14 +198,11 @@ export default withIntlayer(nextConfig);
 > t("counter.label"); // ✓ типизация
 > ```
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Обертка `createNextIntlPlugin()` уже обрабатывает подмену (aliasing) `next-intl` → `@intlayer/next-intl` на стороне сборщика. Если вы хотите сделать зависимости явными в ваших исходных файлах (и использовать чистый `withIntlayer` плагин), вы можете изменить пути импортов вручную:
@@ -246,7 +229,6 @@ export default withIntlayer(nextConfig);
 > Либо использование `defineRouting` из `@intlayer/next-intl/routing` позволит вам автоматически импортировать среды (environments), заданные в `intlayer.config.ts`.
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов с помощью выбранной вами LLM:
@@ -308,8 +290,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки `@intlayer/next-intl` следующий стандартный бойлерплейт `next-intl` можно удалить:
@@ -322,8 +302,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `about.content.ts` прямо рядом с вашим кодом `about/page.tsx`, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -338,8 +316,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -349,8 +325,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)

package/docs/ru/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). Intlayer также предоставляет набор инструментов, таких как **CLI** для тестирования отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)** (self-hosted) и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -68,8 +63,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегии миграции
 
 Поскольку `@nuxtjs/i18n` работает поверх `vue-i18n`, существуют две взаимодополняющие стратегии миграции на Intlayer:
@@ -80,20 +73,15 @@ Intlayer также является **наиболее активно разв
 
 В этом руководстве сначала рассматривается **Стратегия 1** (адаптер совместимости без существенных изменений), а затем — опциональная полная миграция.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это необходимый минимум для запуска вашего приложения Nuxt с Intlayer без изменений в коде компонентов.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптер совместимости:
@@ -137,7 +125,6 @@ bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-js
 > Вы можете безопасно оставить установленным пакет `@nuxtjs/i18n` во время миграции (мы удалим его из конфигурации Nuxt позже).
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает базовый файл `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы сообщений:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** сопоставляет локаль с путем к соответствующему JSON-файлу. **`location`** сообщает вотчеру (watcher) Intlayer, за какой папкой нужно следить для отслеживания изменений. Настройка `format: 'icu'` гарантирует правильную обработку плейсхолдеров `vue-i18n`.
 
 </Step>
-
 <Step number={3} title="Обновление конфигурации Nuxt">
 
 Замените модуль `@nuxtjs/i18n` на `nuxt-intlayer` в файле `nuxt.config.ts`. Плагин Intlayer автоматически внедряет алиасы модулей, так что ваши текущие импорты `import { useI18n } from 'vue-i18n'` прозрачно перенаправляются в `@intlayer/vue-i18n`.
@@ -192,14 +178,11 @@ export default defineNuxtConfig({
 
 На этом быстрая миграция завершена. Теперь ваше приложение Nuxt работает на Intlayer, при этом все ваши вызовы `$t` и `useI18n()` остаются без изменений.
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Плагин Intlayer уже справляется с подменой алиасов на уровне сборщика. Если вы хотите сделать зависимости явными в ваших исходных файлах, вы можете переименовать импорты вручную:
@@ -211,7 +194,6 @@ export default defineNuxtConfig({
 Это **прямая замена** — вам не нужно менять сигнатуры вызовов, аргументы или возвращаемые типы.
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов:
@@ -273,8 +255,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки адаптера совместимости следующий стандартный бойлерплейт `@nuxtjs/i18n` можно удалить:
@@ -287,8 +267,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `my-component.content.ts` прямо рядом с вашим кодом `MyComponent.vue`, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -303,8 +281,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -314,8 +290,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)