@intlayer/docs 5.7.8 → 5.8.0

package/docs/ru/how_works_intlayer.md

@@ -25,8 +25,8 @@ slugs:
 .
 └── Components
     └── MyComponent
-        ├── index.content.cjs
-        └── index.mjs
+        ├── index.content.ts
+        └── index.tsx
 ```
 
 Для этого роль Intlayer заключается в том, чтобы находить все ваши `файлы с объявлением контента` во всех различных форматах, присутствующих в вашем проекте, а затем генерировать из них `словари`.
@@ -45,12 +45,10 @@ slugs:
 - с использованием плагинов приложения, таких как пакет [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/index.md), или их эквивалентов для [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/index.md). При использовании одного из этих плагинов Intlayer автоматически создаст ваши словари при запуске (dev) или сборке (prod) вашего приложения.
 
 1. Объявление файлов контента
-
    - Файлы контента могут быть определены в различных форматах, таких как TypeScript, ECMAScript, CommonJS или JSON.
    - Файлы контента могут быть определены в любом месте проекта, что позволяет улучшить обслуживание и масштабируемость. Важно соблюдать соглашения о расширениях файлов для файлов контента. По умолчанию это расширение `*.content.{js|cjs|mjs|ts|tsx|json}`, но его можно изменить в [файле конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 2. Генерация `словарей`
-
    - Словари генерируются из файлов контента. По умолчанию словари Intlayer генерируются в директории `.intlayer/dictionaries` проекта.
    - Эти словари генерируются в различных форматах, чтобы удовлетворить все потребности и оптимизировать производительность приложения.
 
@@ -59,7 +57,7 @@ slugs:
 
 - Типы словарей генерируются из `файлов декларации контента` Intlayer. По умолчанию типы словарей Intlayer генерируются в директории `.intlayer/types` проекта.
 
-- [Расширение модулей](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) Intlayer — это функция TypeScript, которая позволяет вам определять дополнительные типы для Intlayer. Это упрощает процесс разработки, предлагая доступные или обязательные аргументы.
+- [Расширение модулей](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) Intlayer - это функция TypeScript, которая позволяет вам определять дополнительные типы для Intlayer. Это упрощает процесс разработки, предлагая доступные или обязательные аргументы.
   Среди сгенерированных типов добавляются типы словарей Intlayer или даже типы конфигурации языка в файл `types/intlayer.d.ts` и используются другими пакетами. Для этого необходимо, чтобы файл `tsconfig.json` был настроен на включение директории `types` проекта.
 
 ### Этап интерпретации словарей
@@ -91,8 +89,8 @@ Intlayer также предоставляет визуальный редакт
 
 ![визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
 
-- Сервер — это простое приложение на Express, которое прослушивает запросы от клиента и получает контент вашего приложения, такой как `dictionaries` и конфигурация, чтобы сделать его доступным на стороне клиента.
-- С другой стороны, клиент — это приложение на React, которое используется для взаимодействия с вашим контентом через визуальный интерфейс.
+- Сервер - это простое приложение на Express, которое прослушивает запросы от клиента и получает контент вашего приложения, такой как `dictionaries` и конфигурация, чтобы сделать его доступным на стороне клиента.
+- С другой стороны, клиент - это приложение на React, которое используется для взаимодействия с вашим контентом через визуальный интерфейс.
   Когда вы вызываете ваш контент с помощью `useIntlayer` и редактор включен, строки автоматически оборачиваются в объект Proxy с именем `IntlayerNode`. Этот узел использует `window.postMessage` для связи с обернутым iframe, содержащим интерфейс визуального редактора.  
   Со стороны редактора, редактор прослушивает эти сообщения и имитирует реальное взаимодействие с вашим контентом, позволяя редактировать текст напрямую в контексте вашего приложения.
 

package/docs/ru/index.md

@@ -32,7 +32,7 @@ Intlayer предлагает гибкий, современный подход
   Получите обзор того, как работает Intlayer, его основных функций и почему он меняет правила игры в области i18n.
 
 - **[Как работает Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/how_works_intlayer.md)**  
-  Погрузитесь в архитектурный дизайн и узнайте, как Intlayer обрабатывает все — от объявления контента до доставки перевода.
+  Погрузитесь в архитектурный дизайн и узнайте, как Intlayer обрабатывает все - от объявления контента до доставки перевода.
 
 - **[Конфигурация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)**  
   Настройте Intlayer под нужды вашего проекта. Изучите варианты промежуточного программного обеспечения, структуру каталогов и расширенные настройки.

package/docs/ru/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-06-29
+updatedAt: 2025-08-20
 title: Преимущества Intlayer
 description: Узнайте о преимуществах и достоинствах использования Intlayer в ваших проектах. Поймите, почему Intlayer выделяется среди других фреймворков.
 keywords:
@@ -11,58 +11,122 @@ keywords:
   - Сравнение
 slugs:
   - doc
-  - concept
-  - interest
+  - why
 ---
 
-# Intlayer: Индивидуальный способ перевода вашего сайта
+# Почему стоит рассмотреть Intlayer?
 
-**Intlayer** — это библиотека интернационализации, разработанная специально для разработчиков на JavaScript. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+## Что такое Intlayer?
 
-## Пример использования
+**Intlayer** - это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+
+## Почему был создан Intlayer?
+
+Intlayer был создан для решения общей проблемы, которая затрагивает все популярные библиотеки i18n, такие как `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` и `vue-i18n`.
+
+Все эти решения используют централизованный подход для перечисления и управления вашим контентом. Например:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── fr.json
+│   └── es.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+Или здесь с использованием пространств имён:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+Такой тип архитектуры замедляет процесс разработки и усложняет поддержку кода по нескольким причинам:
+
+1. **Для каждого нового созданного компонента необходимо:**
+   - Создать новый ресурс/пространство имён в папке `locales`
+   - Не забыть импортировать новое пространство имён на вашей странице
+   - Перевести ваш контент (часто выполняется вручную путём копирования/вставки из AI-сервисов)
+
+2. **Для любых изменений в ваших компонентах необходимо:**
+   - Найти соответствующий ресурс/пространство имён (которое находится далеко от компонента)
+   - Перевести ваш контент
+   - Убедиться, что ваш контент актуален для всех локалей
+   - Проверить, что в вашем пространстве имён нет неиспользуемых ключей/значений
+   - Убедиться, что структура ваших JSON-файлов одинакова для всех локалей
+
+В профессиональных проектах, использующих эти решения, часто применяются платформы локализации для управления переводом вашего контента. Однако для крупных проектов это может быстро стать дорогостоящим.
+
+Для решения этой проблемы Intlayer использует подход, при котором контент ограничивается областью компонента и хранится рядом с вашим компонентом, как это часто делается с CSS (`styled-components`), типами, документацией (`storybook`) или модульными тестами (`jest`).
 
 ```bash codeFormat="typescript"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
         └── index.tsx
 ```
 
 ```bash codeFormat="commonjs"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.cjs
-        └── index.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
 ```bash codeFormat="esm"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.mjs
-        └── index.js
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
-```tsx fileName="./Components/MyComponent/index.content.ts" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat="typescript"
 import { t, type Dictionary } from "intlayer";
 
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
 
+// Экспортируем контент компонента по умолчанию
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { t } from "intlayer";
 
 /** @type {import('intlayer').Dictionary} */
@@ -70,9 +134,9 @@ const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -80,25 +144,27 @@ const componentExampleContent = {
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { t } = require("intlayer");
 
 /** @type {import('intlayer').Dictionary} */
+// Определение контента компонента с переводами
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
 
+// Экспортируем контент компонента для CommonJS
 module.exports = componentExampleContent;
 ```
 
-```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat="typescript"
 import { useIntlayer } from "react-intlayer";
 
 export const ComponentExample = () => {
@@ -108,7 +174,7 @@ export const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { useIntlayer } from "react-intlayer";
 
 const ComponentExample = () => {
@@ -118,7 +184,7 @@ const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { useIntlayer } = require("react-intlayer");
 
 const ComponentExample = () => {
@@ -128,27 +194,76 @@ const ComponentExample = () => {
 };
 ```
 
-## Почему стоит выбрать Intlayer?
-
-| Особенность                                 | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Управление контентом на базе JavaScript** | Используйте гибкость JavaScript для эффективного определения и управления вашим контентом.                                                                                                                                                                                                                                                                                                                                                                                 |
-| **Типобезопасная среда**                    | Используйте TypeScript, чтобы гарантировать точность и отсутствие ошибок во всех ваших определениях контента.                                                                                                                                                                                                                                                                                                                                                              |
-| **Интегрированные файлы контента**          | Держите ваши переводы рядом с соответствующими компонентами, что повышает удобство поддержки и ясность.                                                                                                                                                                                                                                                                                                                                                                    |
-| **Упрощённая настройка**                    | Быстрый запуск с минимальной конфигурацией, особенно оптимизирован для проектов на Next.js.                                                                                                                                                                                                                                                                                                                                                                                |
-| **Поддержка серверных компонентов**         | Идеально подходит для серверных компонентов Next.js, обеспечивая плавный рендеринг на стороне сервера.                                                                                                                                                                                                                                                                                                                                                                     |
-| **Расширенная маршрутизация**               | Полная поддержка маршрутизации приложений Next.js, плавно адаптирующаяся к сложным структурам приложений.                                                                                                                                                                                                                                                                                                                                                                  |
-| **Организованная кодовая база**             | Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке.                                                                                                                                                                                                                                                                                                                                                                              |
-| **Автоматический перевод в CI**             | Автоматически заполняйте ваши переводы в CI, используя собственный API-ключ OpenAI, исключая необходимость в платформе локализации (L10n).                                                                                                                                                                                                                                                                                                                                 |
-| **Интеграция MCP сервера**                  | Обеспечивает MCP (Model Context Protocol) сервер для автоматизации IDE, позволяя бесшовно управлять контентом и рабочими процессами интернационализации (i18n) непосредственно в вашей среде разработки. [Узнать больше](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md).                                                                                                                                                                     |
-| **Поддержка Markdown**                      | Импорт и интерпретация файлов markdown для многоязычного контента, такого как политики конфиденциальности.                                                                                                                                                                                                                                                                                                                                                                 |
-| **Бесплатный визуальный редактор и CMS**    | Бесплатный визуальный редактор и CMS доступны, если вам нужно работать с авторами контента для ваших переводов, что вновь устраняет необходимость в платформе локализации и позволяет вынести контент за пределы кодовой базы.                                                                                                                                                                                                                                             |
-| **Упрощённый доступ к контенту**            | Нет необходимости вызывать функцию `t` для каждого элемента контента; получите весь ваш контент напрямую, используя один хук.                                                                                                                                                                                                                                                                                                                                              |
-| **Последовательная реализация**             | Одинаковая реализация как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию `t` через каждый серверный компонент.                                                                                                                                                                                                                                                                                                                      |
-| **Контент с возможностью tree-shaking**     | Контент поддерживает tree-shaking, что уменьшает размер итогового бандла.                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **Неблокирующий статический рендеринг**     | Intlayer не блокирует статический рендеринг, в отличие от `next-intl`.                                                                                                                                                                                                                                                                                                                                                                                                     |
-| **Взаимодействие**                          | Обеспечивает взаимодействие с [react-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react-i18next.md), [next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-i18next.md), [next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-intl.md) и [react-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react-intl.md). |
-
-## История документации
-
-- 5.5.10 - 2025-06-29: Инициализация истории
+Этот подход позволяет вам:
+
+1. **Увеличить скорость разработки**
+   - Файлы `.content.{{ts|mjs|cjs|json}}` можно создавать с помощью расширения для VSCode
+   - Инструменты автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot) могут помочь вам объявлять ваш контент, уменьшая необходимость копирования/вставки
+
+2. **Очистить вашу кодовую базу**
+   - Снизить сложность
+   - Повысить поддерживаемость
+
+3. **Проще дублировать ваши компоненты и связанный с ними контент (например: компоненты входа/регистрации и т.д.)**
+   - Ограничивая риск влияния на контент других компонентов
+   - Копируя и вставляя ваш контент из одного приложения в другое без внешних зависимостей
+
+4. **Избегать загрязнения кодовой базы неиспользуемыми ключами/значениями для неиспользуемых компонентов**
+   - Если вы не используете компонент, Intlayer не будет импортировать его связанный контент
+   - Если вы удаляете компонент, вам будет проще не забыть удалить связанный с ним контент, так как он будет находиться в той же папке
+
+5. **Снизить затраты на размышления для ИИ-агентов при объявлении вашего многоязычного контента**
+   - ИИ-агенту не нужно сканировать всю вашу кодовую базу, чтобы понять, где реализовать ваш контент
+   - Переводы легко выполняются с помощью инструментов автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot)
+
+## Дополнительные возможности Intlayer
+
+| Функция                                                                                                                   | Описание                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Поддержка нескольких фреймворков**<br><br>Intlayer совместим со всеми основными фреймворками и библиотеками, включая Next.js, React, Vite, Vue.js, Nuxt, Preact, Express и другие.                                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true)       | **Управление контентом на основе JavaScript**<br><br>Используйте гибкость JavaScript для эффективного определения и управления вашим контентом. <br><br> - [Объявление контента](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Файл объявления контента для каждого локалитета**<br><br>Ускорьте разработку, объявляя ваш контент один раз, до автоматической генерации.<br><br> - [Файл объявления контента для каждого локалитета](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Типобезопасная среда**<br><br>Используйте TypeScript, чтобы гарантировать отсутствие ошибок в определениях контента и коде, а также получать преимущества автозаполнения в IDE.<br><br> - [Настройка TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Упрощённая настройка**<br><br>Быстрый старт с минимальной конфигурацией. Легко настраивайте параметры интернационализации, маршрутизации, ИИ, сборки и обработки контента.<br><br> - [Изучите интеграцию с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **Упрощённый доступ к контенту**<br><br>Нет необходимости вызывать функцию `t` для каждого элемента контента. Получайте весь ваш контент напрямую с помощью одного хука.<br><br> - [Интеграция с React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **Единообразная реализация серверных компонентов**<br><br>Идеально подходит для серверных компонентов Next.js, используйте одну и ту же реализацию как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию `t` через каждый серверный компонент. <br><br> - [Серверные компоненты](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **Организованная кодовая база**<br><br>Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке. Переводы, расположенные рядом с соответствующими компонентами, повышают удобство сопровождения и ясность. <br><br> - [Как работает Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **Расширенная маршрутизация**<br><br>Полная поддержка маршрутизации приложений, плавно адаптирующаяся к сложным структурам приложений для Next.js, React, Vite, Vue.js и других.<br><br> - [Изучите интеграцию с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Поддержка Markdown**<br><br>Импортируйте и интерпретируйте локализационные файлы и удалённый Markdown для многоязычного контента, такого как политики конфиденциальности, документация и др. Интерпретируйте и делайте метаданные Markdown доступными в вашем коде.<br><br> - [Файлы контента](https://intlayer.org/doc/concept/content/file)                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **Бесплатный визуальный редактор и CMS**<br><br>Для авторов контента доступен бесплатный визуальный редактор и CMS, что устраняет необходимость в платформе локализации. Сохраняйте синхронизацию контента с помощью Git или полностью/частично внешне управляйте им через CMS.<br><br> - [Редактор Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Контент с поддержкой tree-shaking**<br><br>Контент с поддержкой tree-shaking, уменьшающий размер итогового бандла. Загружает контент по компонентам, исключая неиспользуемый контент из вашего бандла. Поддерживает ленивую загрузку для повышения эффективности загрузки приложения. <br><br> - [Оптимизация сборки приложения](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **Статическая отрисовка**<br><br>Не блокирует статическую отрисовку. <br><br> - [Интеграция с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **Перевод с использованием ИИ**<br><br>Преобразуйте ваш сайт на 231 язык всего одним кликом с помощью продвинутых инструментов перевода на базе ИИ от Intlayer, используя вашего собственного поставщика ИИ/ключ API. <br><br> - [Интеграция CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [CLI Intlayer](https://intlayer.org/doc/concept/cli) <br> - [Автозаполнение](https://intlayer.org/doc/concept/auto-fill) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **Интеграция сервера MCP**<br><br>Обеспечивает сервер MCP (Model Context Protocol) для автоматизации IDE, позволяя бесшовно управлять контентом и процессами интернационализации (i18n) непосредственно в вашей среде разработки. <br><br> - [Сервер MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)                                                                                      |
+| ![Функция](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **Расширение VSCode**<br><br>Intlayer предоставляет расширение для VSCode, которое поможет вам управлять вашим контентом и переводами, создавать словари, переводить ваш контент и многое другое. <br><br> - [Расширение VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **Взаимодействие**<br><br>Обеспечивает взаимодействие с react-i18next, next-i18next, next-intl и react-intl. <br><br> - [Intlayer и react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer и next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer и next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                                 |
+
+## Сравнение Intlayer с другими решениями
+
+| Функция                                                   | Intlayer                                                                                                                                         | React-i18next / i18next                                                          | React-Intl (FormatJS)                              | LinguiJS                                           | next-intl                                          | next-i18next                                       | vue-i18n                                                            |
+| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------- |
+| **Переводы рядом с компонентами**                         | Да, контент расположен рядом с каждым компонентом                                                                                                | Нет                                                                              | Нет                                                | Нет                                                | Нет                                                | Нет                                                | Да - с использованием `Single File Components` (SFCs)               |
+| **Интеграция с TypeScript**                               | Продвинутая, автоматически сгенерированные строгие типы                                                                                          | Базовая; дополнительная конфигурация для безопасности                            | Хорошая, но менее строгая                          | Типы, требуется конфигурация                       | Хорошая                                            | Базовая                                            | Хорошая (типы доступны; требуется настройка безопасности ключей)    |
+| **Обнаружение отсутствующих переводов**                   | Ошибка/предупреждение во время сборки                                                                                                            | В основном строки-заменители во время выполнения                                 | Строки-заменители                                  | Требуется дополнительная настройка                 | Строки-заменители во время выполнения              | Строки-заменители во время выполнения              | Строки-заменители/предупреждения во время выполнения (настраиваемо) |
+| **Обогащённый контент (JSX/Markdown/компоненты)**         | Прямая поддержка, включая React-узлы                                                                                                             | Ограничено / только интерполяция                                                 | Синтаксис ICU, не настоящий JSX                    | Ограничено                                         | Не предназначено для сложных узлов                 | Ограничено                                         | Ограничено (компоненты через `<i18n-t>`, Markdown через плагины)    |
+| **Перевод с использованием ИИ**                           | Да, поддерживает нескольких поставщиков ИИ. Можно использовать с собственными API-ключами. Учитывает контекст вашего приложения и объем контента | Нет                                                                              | Нет                                                | Нет                                                | Нет                                                | Нет                                                | Нет                                                                 |
+| **Визуальный редактор**                                   | Да, локальный визуальный редактор + опциональная CMS; может вынести содержимое кодовой базы; встраиваемый                                        | Нет / доступно через внешние платформы локализации                               | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации                  |
+| **Локализованная маршрутизация**                          | Встроенная, поддержка middleware                                                                                                                 | Плагины или ручная настройка                                                     | Не встроена                                        | Плагин/ручная настройка                            | Встроена                                           | Встроена                                           | Вручную через Vue Router (обрабатывается Nuxt i18n)                 |
+| **Динамическая генерация маршрутов**                      | Да                                                                                                                                               | Плагин/экосистема или ручная настройка                                           | Не предоставляется                                 | Плагин/ручная настройка                            | Да                                                 | Да                                                 | Не предоставляется (предоставляется Nuxt i18n)                      |
+| **Множественное число**                                   | Шаблоны на основе перечислений; см. документацию                                                                                                 | Настраиваемо (плагины, такие как i18next-icu)                                    | Продвинутое (ICU)                                  | Продвинутое (ICU/messageformat)                    | Хорошо                                             | Хорошо                                             | Продвинутое (встроенные правила множественного числа)               |
+| **Форматирование (даты, числа, валюты)**                  | Оптимизированные форматтеры (Intl под капотом)                                                                                                   | Через плагины или пользовательское использование Intl                            | Продвинутые ICU форматтеры                         | Помощники ICU/CLI                                  | Хорошо (помощники Intl)                            | Хорошо (помощники Intl)                            | Встроенные форматтеры даты/числа (Intl)                             |
+| **Формат содержимого**                                    | .tsx, .ts, .js, .json, .md, .txt                                                                                                                 | .json                                                                            | .json, .js                                         | .po, .json                                         | .json, .js, .ts                                    | .json                                              | .json, .js                                                          |
+| **Поддержка ICU**                                         | В разработке (родной ICU)                                                                                                                        | Через плагин (i18next-icu)                                                       | Да                                                 | Да                                                 | Да                                                 | Через плагин (i18next-icu)                         | Через пользовательский форматтер/компилятор                         |
+| **SEO помощники (hreflang, sitemap)**                     | Встроенные инструменты: помощники для sitemap, **robots.txt**, метаданные                                                                        | Плагины сообщества/ручное управление                                             | Не является ядром                                  | Не является ядром                                  | Хорошо                                             | Хорошо                                             | Не является ядром (Nuxt i18n предоставляет помощники)               |
+| **Экосистема / Сообщество**                               | Меньше, но быстро растет и активно реагирует                                                                                                     | Самое большое и зрелое                                                           | Большое, корпоративное                             | Растущее, меньше                                   | Среднего размера, ориентировано на Next.js         | Среднего размера, ориентировано на Next.js         | Большое в экосистеме Vue                                            |
+| **Серверный рендеринг и серверные компоненты**            | Да, оптимизировано для SSR / React Server Components                                                                                             | Поддерживается, требуется некоторая настройка                                    | Поддерживается в Next.js                           | Поддерживается                                     | Полная поддержка                                   | Полная поддержка                                   | SSR через Nuxt/Vue SSR (без RSC)                                    |
+| **Tree-shaking (загрузка только используемого контента)** | Да, на уровне компонентов во время сборки с помощью плагинов Babel/SWC                                                                           | Обычно загружает всё (можно улучшить с помощью пространств имён/разделения кода) | Обычно загружает всё                               | Не по умолчанию                                    | Частично                                           | Частично                                           | Частично (с разделением кода/ручной настройкой)                     |
+| **Ленивая загрузка**                                      | Да, по локалям/по компонентам                                                                                                                    | Да (например, бэкенды/пространства имён по требованию)                           | Да (разделение пакетов локалей)                    | Да (динамический импорт каталогов)                 | Да (по маршрутам/локалям)                          | Да (по маршрутам/локалям)                          | Да (асинхронные сообщения локалей)                                  |
+| **Управление крупными проектами**                         | Поощряет модульность, подходит для дизайн-систем                                                                                                 | Требует хорошей дисциплины в работе с файлами                                    | Центральные каталоги могут стать большими          | Может стать сложным                                | Модульный с настройкой                             | Модульный с настройкой                             | Модульный с настройкой Vue Router/Nuxt i18n                         |
+
+## История документа
+
+| Версия | Дата       | Изменения                        |
+| ------ | ---------- | -------------------------------- |
+| 5.8.0  | 2025-08-19 | Обновление сравнительной таблицы |
+| 5.5.10 | 2025-06-29 | Инициализация истории            |

package/docs/ru/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: Intlayer CMS | Вынесите свой контент в Intlayer CMS
 description: Вынесите свой контент в Intlayer CMS, чтобы делегировать управление вашим контентом вашей команде.
 keywords:
@@ -23,7 +23,7 @@ youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 
 <iframe title="Visual Editor + CMS для вашего веб-приложения: объяснение Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
-Intlayer CMS — это приложение, которое позволяет вам выносить контент из проекта Intlayer.
+Intlayer CMS - это приложение, которое позволяет вам выносить контент из проекта Intlayer.
 
 Для этого Intlayer вводит концепцию «удалённых словарей».
 
@@ -33,15 +33,15 @@ Intlayer CMS — это приложение, которое позволяет
 
 Intlayer различает «локальные» и «удалённые» словари.
 
-- 'Локальный' словарь — это словарь, который объявлен в вашем проекте Intlayer. Например, файл объявления кнопки или вашей навигационной панели. Вынесение такого контента не имеет смысла, так как этот контент не предполагается часто изменять.
+- 'Локальный' словарь - это словарь, который объявлен в вашем проекте Intlayer. Например, файл объявления кнопки или вашей навигационной панели. Вынесение такого контента не имеет смысла, так как этот контент не предполагается часто изменять.
 
-- 'Удалённый' словарь — это словарь, который управляется через Intlayer CMS. Это может быть полезно, чтобы позволить вашей команде управлять контентом напрямую на вашем сайте, а также использовать функции A/B тестирования и автоматической оптимизации SEO.
+- 'Удалённый' словарь - это словарь, который управляется через Intlayer CMS. Это может быть полезно, чтобы позволить вашей команде управлять контентом напрямую на вашем сайте, а также использовать функции A/B тестирования и автоматической оптимизации SEO.
 
 ## Визуальный редактор vs CMS
 
-[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) — это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для локальных словарей. После внесения изменений контент будет заменён в кодовой базе. Это означает, что приложение будет пересобрано, и страница будет перезагружена для отображения нового контента.
+[Визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) - это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для локальных словарей. После внесения изменений контент будет заменён в кодовой базе. Это означает, что приложение будет пересобрано, и страница будет перезагружена для отображения нового контента.
 
-В отличие от этого, Intlayer CMS — это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для удалённых словарей. После внесения изменений контент **не** повлияет на вашу кодовую базу. И сайт автоматически отобразит изменённый контент.
+В отличие от этого, Intlayer CMS - это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для удалённых словарей. После внесения изменений контент **не** повлияет на вашу кодовую базу. И сайт автоматически отобразит изменённый контент.
 
 ## Интеграция
 
@@ -345,7 +345,6 @@ module.exports = config;
 - Приложение запущено.
 
 - Конфигурация [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) правильно настроена в вашем файле конфигурации Intlayer.
-
   - Обязательные поля:
     - URL приложения должен совпадать с тем, который вы указали в конфигурации редактора (`applicationURL`).
     - URL CMS.

package/docs/ru/intlayer_cli.md

@@ -243,7 +243,7 @@ npx intlayer fill
 
 - **`--output-locales [outputLocales...]`**: Целевые локали для перевода. Если не указано, будут использованы все локали из вашей конфигурации, кроме исходной локали.
 
-- **`--mode [mode]`**: Режим перевода: 'complete' (полный), 'review' (проверка) или 'missing-only' (только отсутствующие). По умолчанию — 'missing-only'.
+- **`--mode [mode]`**: Режим перевода: 'complete' (полный), 'review' (проверка) или 'missing-only' (только отсутствующие). По умолчанию - 'missing-only'.
 
 **Опции Git:**
 
@@ -267,7 +267,7 @@ npx intlayer fill
 - **`--custom-prompt [prompt]`**: Укажите пользовательский запрос для инструкций по переводу.
 - **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для перевода ИИ.
 
-  > Пример: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение — магазин для кошек"`
+  > Пример: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение - магазин для кошек"`
 
 **Опции переменных окружения:**
 
@@ -365,7 +365,6 @@ npx intlayer doc translate
   > Пример: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
 
 - **`--skip-if-modified-before [skipIfModifiedBefore]`**: Пропустить файл, если он был изменён до указанного времени.
-
   - Может быть абсолютным временем, например "2025-12-05" (строка или объект Date)
   - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
   - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
@@ -373,7 +372,6 @@ npx intlayer doc translate
   > Пример: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
 
 - **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустить файл, если он был изменён в течение указанного времени.
-
   - Может быть абсолютным временем, например "2025-12-05" (строка или объект Date)
   - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
   - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
@@ -405,7 +403,7 @@ npx intlayer doc translate
 - **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для перевода ИИ.
 - **`--custom-prompt [prompt]`**: Настроить базовый запрос, используемый для перевода. (Примечание: для большинства случаев рекомендуется использовать опцию `--custom-instructions`, так как она обеспечивает лучший контроль над поведением перевода.)
 
-  > Пример: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение — магазин для кошек"`
+  > Пример: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение - магазин для кошек"`
 
 **Опции переменных окружения:**
 
@@ -424,7 +422,6 @@ npx intlayer doc translate
 **Опции пользовательских инструкций:**
 
 - **`--custom-instructions [customInstructions]`**: Пользовательские инструкции, добавляемые в запрос. Полезно для применения специфических правил по форматированию, переводу URL и т.д.
-
   - Может быть абсолютное время, например "2025-12-05" (строка или объект Date)
   - Может быть относительное время в миллисекундах `1 * 60 * 60 * 1000` (1 час)
   - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
@@ -495,7 +492,7 @@ npx intlayer doc review
 
 ## CLI SDK
 
-CLI SDK — это библиотека, которая позволяет использовать Intlayer CLI в вашем собственном коде.
+CLI SDK - это библиотека, которая позволяет использовать Intlayer CLI в вашем собственном коде.
 
 ```bash packageManager="npm"
 npm install @intlayer/cli --save-dev

package/docs/ru/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: Intlayer визуальный редактор | Изменяйте свой контент, используя визуальный редактор
 description: Узнайте, как использовать редактор Intlayer для управления вашим многоязычным веб-сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить ваш проект за несколько минут.
 keywords:
@@ -22,7 +22,7 @@ youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 
 <iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
-Intlayer Visual Editor — это инструмент, который оборачивает ваш веб-сайт для взаимодействия с файлами декларации контента с использованием визуального редактора.
+Intlayer Visual Editor - это инструмент, который оборачивает ваш веб-сайт для взаимодействия с файлами декларации контента с использованием визуального редактора.
 
 ![Интерфейс Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
 
@@ -30,9 +30,9 @@ Intlayer Visual Editor — это инструмент, который обор
 
 ## Визуальный редактор vs CMS
 
-Intlayer Visual Editor — это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для локальных словарей. После внесения изменений контент будет заменён в кодовой базе. Это означает, что приложение будет пересобрано, и страница будет перезагружена для отображения нового контента.
+Intlayer Visual Editor - это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для локальных словарей. После внесения изменений контент будет заменён в кодовой базе. Это означает, что приложение будет пересобрано, и страница будет перезагружена для отображения нового контента.
 
-В отличие от этого, [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) — это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для удалённых словарей. После внесения изменений контент **не** повлияет на вашу кодовую базу. И веб-сайт автоматически отобразит изменённый контент.
+В отличие от этого, [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) - это инструмент, который позволяет управлять вашим контентом в визуальном редакторе для удалённых словарей. После внесения изменений контент **не** повлияет на вашу кодовую базу. И веб-сайт автоматически отобразит изменённый контент.
 
 ## Интеграция Intlayer в ваше приложение
 
@@ -257,7 +257,6 @@ pnpm intlayer-editor start -e development
 - Визуальный редактор и приложение работают.
 
 - Конфигурация [`editor`](https://intlayer.org/ru/doc/concept/configuration#editor-configuration) правильно настроена в вашем файле конфигурации Intlayer.
-
   - Обязательные поля:
     - URL приложения должен совпадать с тем, который вы указали в конфигурации редактора (`applicationURL`).
 

package/docs/ru/intlayer_with_angular.md

@@ -24,7 +24,7 @@ slugs:
 
 ## Что такое Intlayer?
 
-**Intlayer** — это инновационная, открытая библиотека интернационализации (i18n), созданная для упрощения поддержки многоязычности в современных веб-приложениях.
+**Intlayer** - это инновационная, открытая библиотека интернационализации (i18n), созданная для упрощения поддержки многоязычности в современных веб-приложениях.
 
 С помощью Intlayer вы можете: