@intlayer/docs 5.5.10 → 5.5.12

package/docs/ru/how_works_intlayer.md

@@ -0,0 +1,251 @@
+---
+createdAt: 2024-08-12
+updatedAt: 2025-06-29
+title: Как работает Intlayer
+description: Узнайте, как Intlayer работает внутри. Поймите архитектуру и компоненты, которые делают Intlayer мощным.
+keywords:
+  - Intlayer
+  - Как работает
+  - Архитектура
+  - Компоненты
+  - Внутренние процессы
+slugs:
+  - doc
+  - concept
+  - how-works-intlayer
+---
+
+# Как работает Intlayer
+
+## Обзор
+
+Основная идея Intlayer заключается в использовании управления контентом на уровне компонентов. Идея Intlayer состоит в том, чтобы позволить вам объявлять ваш контент в любом месте вашего кода, например, в той же директории, что и ваш компонент.
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+Для этого роль Intlayer заключается в том, чтобы находить все ваши `файлы с объявлением контента` во всех различных форматах, присутствующих в вашем проекте, а затем генерировать из них `словари`.
+
+Таким образом, есть два основных этапа:
+
+- Этап сборки
+- Этап интерпретации
+
+### Этап сборки словарей
+
+Этап сборки может быть выполнен тремя способами:
+
+- с использованием CLI с помощью `npx intlayer build`
+- с использованием [расширения vscode](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)
+- с использованием плагинов приложения, таких как пакет [`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` проекта.
+   - Эти словари генерируются в различных форматах, чтобы удовлетворить все потребности и оптимизировать производительность приложения.
+
+3. Генерация типов словарей
+   На основе ваших `словарей` Intlayer будет генерировать типы, чтобы сделать их пригодными для использования в вашем приложении.
+
+- Типы словарей генерируются из `файлов декларации контента` Intlayer. По умолчанию типы словарей Intlayer генерируются в директории `.intlayer/types` проекта.
+
+- [Расширение модулей](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) Intlayer — это функция TypeScript, которая позволяет вам определять дополнительные типы для Intlayer. Это упрощает процесс разработки, предлагая доступные или обязательные аргументы.
+  Среди сгенерированных типов добавляются типы словарей Intlayer или даже типы конфигурации языка в файл `types/intlayer.d.ts` и используются другими пакетами. Для этого необходимо, чтобы файл `tsconfig.json` был настроен на включение директории `types` проекта.
+
+### Этап интерпретации словарей
+
+С помощью Intlayer вы получите доступ к вашему контенту в приложении, используя хук `useIntlayer`.
+
+```tsx
+const MyComponent = () => {
+  const content = useIntlayer("my-component");
+  return <div>{content.title}</div>;
+};
+```
+
+Этот хук будет управлять обнаружением локали за вас и возвращать контент для текущей локали. Используя этот хук, вы также сможете интерпретировать markdown, управлять множественным числом и многое другое.
+
+> Чтобы увидеть все возможности Intlayer, вы можете прочитать [документацию по словарям](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/get_started.md).
+
+## Удалённый контент
+
+Intlayer позволяет объявлять контент локально, а затем экспортировать его в CMS, чтобы ваша нетехническая команда могла редактировать его.
+
+Таким образом, вы сможете отправлять и получать контент из CMS в ваше приложение, аналогично тому, как вы работаете с Git для вашего кода.
+
+Для внешних словарей, использующих CMS, Intlayer выполняет базовую операцию fetch для получения удалённых словарей и объединяет их с вашими локальными. Если это настроено в вашем проекте, Intlayer будет автоматически управлять загрузкой контента из CMS при запуске приложения (dev) / сборке (prod).
+
+## Визуальный редактор
+
+Intlayer также предоставляет визуальный редактор, позволяющий редактировать ваш контент визуально. Этот [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) доступен в отдельном пакете `intlayer-editor`.
+
+![визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+- Сервер — это простое приложение на Express, которое прослушивает запросы от клиента и получает контент вашего приложения, такой как `dictionaries` и конфигурация, чтобы сделать его доступным на стороне клиента.
+- С другой стороны, клиент — это приложение на React, которое используется для взаимодействия с вашим контентом через визуальный интерфейс.
+  Когда вы вызываете ваш контент с помощью `useIntlayer` и редактор включен, строки автоматически оборачиваются в объект Proxy с именем `IntlayerNode`. Этот узел использует `window.sendMessage` для связи с обернутым iframe, содержащим интерфейс визуального редактора.  
+  Со стороны редактора, редактор прослушивает эти сообщения и имитирует реальное взаимодействие с вашим контентом, позволяя редактировать текст напрямую в контексте вашего приложения.
+
+## Оптимизация сборки приложения
+
+Для оптимизации размера сборки вашего приложения Intlayer предоставляет два плагина для оптимизации сборки: плагины `@intlayer/babel` и `@intlayer/swc`.
+Плагины Babel и SWC работают, анализируя абстрактное синтаксическое дерево (AST) вашего приложения, чтобы заменить вызовы функций Intlayer на оптимизированный код. Этот процесс делает финальный бандл легче в продакшене, гарантируя, что импортируются только действительно используемые словари, оптимизируя разбиение на чанки и уменьшая размер сборки.
+
+В режиме разработки Intlayer использует централизованный статический импорт для словарей, чтобы упростить процесс разработки.
+
+Активировав опцию `activateDynamicImport` в [конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md), Intlayer будет использовать динамический импорт для загрузки словарей. Эта опция отключена по умолчанию, чтобы избежать асинхронной обработки при рендеринге приложения.
+
+> `@intlayer/babel` доступен по умолчанию в пакете `vite-intlayer`,
+
+> `@intlayer/swc` не установлен по умолчанию в пакете `next-intlayer`, так как плагины SWC все еще являются экспериментальными в Next.js.
+
+Чтобы узнать, как настроить сборку вашего приложения, вы можете прочитать [документацию по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
+
+## Пакеты
+
+Intlayer состоит из нескольких пакетов, каждый из которых выполняет определенную роль в процессе перевода. Вот графическое представление структуры этого пакета:
+
+![пакеты intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/packages_dependency_graph.svg)
+
+### intlayer
+
+Пакет `intlayer` используется в приложениях для объявления контента в файлах контента.
+
+### react-intlayer
+
+Пакет `react-intlayer` используется для интерпретации словарей Intlayer и их использования в React-приложениях.
+
+### next-intlayer
+
+Пакет `next-intlayer` используется как слой поверх `react-intlayer`, чтобы сделать словари Intlayer пригодными для использования в приложениях Next.js. Он интегрирует основные функции для работы Intlayer в среде Next.js, такие как промежуточное ПО для перевода, маршрутизация или конфигурация файла `next.config.js`.
+
+### vue-intlayer
+
+Пакет `vue-intlayer` используется для интерпретации словарей Intlayer и их использования в приложениях Vue.
+
+### nuxt-intlayer
+
+Пакет `nuxt-intlayer` используется как модуль Nuxt для использования словарей Intlayer в приложениях Nuxt. Он интегрирует необходимые функции для работы Intlayer в среде Nuxt, такие как промежуточное ПО для перевода, маршрутизация и конфигурация файла `nuxt.config.js`.
+
+### svelte-intlayer (в разработке)
+
+Пакет `svelte-intlayer` используется для интерпретации словарей Intlayer и их использования в приложениях Svelte.
+
+### solid-intlayer (в разработке)
+
+Пакет `solid-intlayer` используется для интерпретации словарей Intlayer и их использования в приложениях Solid.js.
+
+### preact-intlayer
+
+Пакет `preact-intlayer` используется для интерпретации словарей Intlayer и их использования в приложениях Preact.
+
+### angular-intlayer (в разработке)
+
+Пакет `angular-intlayer` используется для интерпретации словарей Intlayer и их использования в приложениях Angular.
+
+### express-intlayer
+
+Пакет `express-intlayer` используется для работы с Intlayer на серверной стороне Express.js.
+
+### react-native-intlayer
+
+Пакет `react-native-intlayer` предоставляет инструменты, которые интегрируют плагины для работы Intlayer с Metro bundler.
+
+### lynx-intlayer
+
+Пакет `lynx-intlayer` предоставляет инструменты, которые интегрируют плагины для работы Intlayer с Lynx bundler.
+
+### vite-intlayer
+
+Включает плагин Vite для интеграции Intlayer с [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production), а также промежуточное ПО для определения предпочтительной локали пользователя, управления cookies и обработки перенаправления URL.
+
+### react-scripts-intlayer
+
+Включает команды и плагины `react-scripts-intlayer` для интеграции Intlayer с приложением на основе Create React App. Эти плагины основаны на [craco](https://craco.js.org/) и включают дополнительную конфигурацию для сборщика [Webpack](https://webpack.js.org/).
+
+### intlayer-editor
+
+Пакет `intlayer-editor` используется для обеспечения работы визуального редактора. Этот пакет, опциональный, может быть установлен в приложениях и будет использоваться пакетом `react-intlayer`.
+Он состоит из двух частей: сервера и клиента.
+
+Клиент содержит элементы пользовательского интерфейса, которые будут использоваться `react-intlayer`.
+
+Сервер, основанный на Express, используется для получения запросов визуального редактора и управления или изменения файлов контента.
+
+### intlayer-cli
+
+Пакет `intlayer-cli` может быть использован для генерации словарей с помощью команды `npx intlayer dictionaries build`. Если `intlayer` уже установлен, CLI автоматически устанавливается, и этот пакет не требуется.
+
+### @intlayer/core
+
+Пакет `@intlayer/core` является основным пакетом Intlayer. Он содержит функции управления переводами и словарями. `@intlayer/core` является мультиплатформенным и используется другими пакетами для интерпретации словарей.
+
+### @intlayer/config
+
+Пакет `@intlayer/config` используется для настройки параметров Intlayer, таких как доступные языки, параметры промежуточного программного обеспечения Next.js или настройки интегрированного редактора.
+
+### @intlayer/webpack
+
+Пакет `@intlayer/webpack` используется для предоставления конфигурации Webpack, чтобы приложение на основе Webpack работало с Intlayer. Пакет также предоставляет плагин для добавления в существующее приложение Webpack.
+
+### @intlayer/cli
+
+Пакет `@intlayer/cli` является пакетом NPM, который используется для объявления скриптов, связанных с интерфейсами командной строки Intlayer. Он обеспечивает единообразие всех команд CLI Intlayer. Этот пакет, в частности, используется пакетами [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/ru/packages/intlayer-cli/index.md) и [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/ru/packages/intlayer/index.md).
+
+### @intlayer/mcp
+
+Пакет `@intlayer/mcp` предоставляет сервер MCP (Model Context Protocol), который обеспечивает поддержку IDE с ИИ, адаптированную для экосистемы Intlayer. Он автоматически загружает документацию и интегрируется с Intlayer CLI.
+
+### @intlayer/dictionaries-entry & @intlayer/unmerged-dictionaries-entry & @intlayer/dynamic-dictionaries-entry
+
+Пакеты `@intlayer/dictionaries-entry`, `@intlayer/unmerged-dictionaries-entry` и `@intlayer/dynamic-dictionaries-entry` возвращают путь к точке входа словарей Intlayer. Поскольку поиск по файловой системе из браузера невозможен, использование сборщиков вроде Webpack или Rollup для получения пути к словарям также невозможно. Эти пакеты предназначены для использования с псевдонимами, что позволяет оптимизировать сборку с различными сборщиками, такими как Vite, Webpack и Turbopack.
+
+### @intlayer/chokidar
+
+Пакет `@intlayer/chokidar` используется для отслеживания файлов контента и повторной генерации изменённого словаря при каждом изменении.
+
+### @intlayer/editor
+
+Пакет `@intlayer/editor` предоставляет утилиты, связанные с редактором словаря. В частности, он включает API для интеграции приложения с редактором Intlayer и утилиты для работы со словарями. Этот пакет является кроссплатформенным.
+
+### @intlayer/editor-react
+
+Пакет `@intlayer/editor-react` предоставляет состояния, контексты, хуки и компоненты для интеграции React-приложения с редактором Intlayer.
+
+### @intlayer/babel
+
+Пакет `@intlayer/babel` предоставляет инструменты, которые оптимизируют сборку словарей для приложений на основе Vite и Webpack.
+
+### @intlayer/swc
+
+Пакет `@intlayer/swc` предоставляет инструменты, которые оптимизируют сборку словарей для приложений Next.js.
+
+### @intlayer/api
+
+Пакет `@intlayer/api` является SDK API для взаимодействия с бэкендом.
+
+### @intlayer/design-system
+
+Пакет `@intlayer/design-system` используется для совместного использования элементов дизайна между CMS и визуальным редактором.
+
+### @intlayer/backend
+
+Пакет `@intlayer/backend` экспортирует типы бэкенда и в будущем предложит бэкенд как автономный пакет.
+
+## Общайтесь с нашей умной документацией
+
+- [Задайте свои вопросы нашей умной документации](https://intlayer.org/doc/chat)
+
+## История документации
+
+- 5.5.10 - 2025-06-29: Инициализация истории

package/docs/ru/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: Документация Intlayer - Полное руководство по i18n для JavaScript
+description: Полная документация по Intlayer, современной библиотеке интернационализации для JavaScript, React, Next.js, Express и других фреймворков.
+keywords:
+  - intlayer
+  - интернационализация
+  - i18n
+  - JavaScript
+  - React
+  - Next.js
+  - документация
+  - перевод
+  - многоязычность
+slugs:
+  - doc
+  - index
+---
+
+# Документация Intlayer
+
+Добро пожаловать в официальную документацию **Intlayer**! Здесь вы найдете все необходимое для интеграции, настройки и освоения Intlayer для всех ваших задач интернационализации (i18n), будь то работа с **Next.js**, **React**, **Vite**, **Express** или другой средой JavaScript.
+
+Intlayer предлагает гибкий, современный подход к переводу вашего приложения. Наши документы проведут вас от установки и настройки до продвинутых функций, таких как **перевод с помощью ИИ**, определения **TypeScript** и поддержка **серверных компонентов**, позволяя создавать бесшовный многоязычный опыт.
+
+---
+
+## Начало работы
+
+- **[Введение](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/introduction.md)**  
+  Получите обзор того, как работает Intlayer, его основных функций и почему он меняет правила игры в области i18n.
+
+- **[Как работает Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/how_works_intlayer.md)**  
+  Погрузитесь в архитектурный дизайн и узнайте, как Intlayer обрабатывает все — от объявления контента до доставки перевода.
+
+- **[Конфигурация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)**  
+  Настройте Intlayer под нужды вашего проекта. Изучите варианты промежуточного программного обеспечения, структуру каталогов и расширенные настройки.
+
+- **[Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_cli.md)**  
+  Управляйте контентом и переводами с помощью нашего инструмента командной строки. Узнайте, как отправлять и получать контент, автоматизировать переводы и многое другое.
+
+- **[Редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)**  
+  Упростите сотрудничество с неразработчиками и улучшите свои переводы с помощью ИИ прямо в нашей бесплатной, интуитивно понятной CMS.
+
+---
+
+## Основные концепции
+
+### Словарь
+
+Организуйте ваш многоязычный контент рядом с кодом, чтобы всё оставалось последовательным и удобным для поддержки.
+
+- **[Начало работы](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/get_started.md)**  
+  Изучите основы объявления контента в Intlayer.
+
+- **[Перевод](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md)**  
+  Поймите, как создаются, хранятся и используются переводы в вашем приложении.
+
+- **[Перечисление](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/enumeration.md)**  
+  Легко управляйте повторяющимися или фиксированными наборами данных на разных языках.
+
+- **[Условие](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/conditional.md)**  
+  Узнайте, как использовать условную логику в Intlayer для создания динамического контента.
+
+- **[Вставка](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md)**  
+  Узнайте, как вставлять значения в строку с помощью заполнителей вставки.
+
+- **[Получение функций](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/function_fetching.md)**  
+  Узнайте, как динамически получать контент с помощью пользовательской логики, чтобы соответствовать рабочему процессу вашего проекта.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md)**  
+  Узнайте, как использовать Markdown в Intlayer для создания насыщенного контента.
+
+- **[Встраивание файлов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/file_embeddings.md)**  
+  Узнайте, как встраивать внешние файлы в Intlayer для использования их в редакторе контента.
+
+- **[Вложенность](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/nesting.md)**  
+  Поймите, как создавать вложенный контент в Intlayer для построения сложных структур.
+
+---
+
+## Окружения и интеграции
+
+Мы создали Intlayer с учетом гибкости, предлагая бесшовную интеграцию с популярными фреймворками и инструментами сборки:
+
+- **[Intlayer с Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_15.md)**
+- **[Intlayer с Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_14.md)**
+- **[Intlayer с Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer с React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_create_react_app.md)**
+- **[Intlayer с Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)**
+- **[Intlayer с React Native и Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react_native+expo.md)**
+- **[Intlayer с Lynx и React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_lynx+react.md)**
+- **[Intlayer с Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_express.md)**
+
+Каждое руководство по интеграции включает лучшие практики использования возможностей Intlayer, таких как **рендеринг на стороне сервера**, **динамическая маршрутизация** или **рендеринг на стороне клиента**, чтобы вы могли поддерживать быстрое, SEO-оптимизированное и высокомасштабируемое приложение.
+
+---
+
+## Пакеты
+
+Модульная архитектура Intlayer предлагает специализированные пакеты для конкретных сред и задач:
+
+### `intlayer`
+
+Основные утилиты для настройки и управления вашей i18n-конфигурацией.
+
+- **[getConfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getConfiguration.md)**
+- **[getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getHTMLTextDir.md)**
+- **[getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocaleLang.md)**
+- **[getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocaleName.md)**
+- **[getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocalizedUrl.md)**
+- **[getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getMultilingualUrls.md)**
+- **[getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getPathWithoutLocale.md)**
+- **[getTranslation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getTranslation.md)**
+- **[getEnumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getEnumeration.md)**
+
+### `express-intlayer`
+
+Используйте Intlayer в приложениях на базе **Express**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/express-intlayer/t.md)**  
+  Минималистичный и простой помощник для перевода ваших серверных маршрутов и представлений.
+
+### `react-intlayer`
+
+Улучшите ваши приложения на **React** с помощью мощных хуков:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/react-intlayer/useLocale.md)**
+
+### `next-intlayer`
+
+Бесшовная интеграция с **Next.js**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/useLocale.md)**
+
+---
+
+## Дополнительные ресурсы
+
+- **[Блог: Intlayer и i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_i18next.md)**  
+  Узнайте, как Intlayer дополняет и сравнивается с популярной библиотекой **i18next**.
+
+- **[Прямой урок на YouTube](https://youtu.be/W2G7KxuSD4c?si=GyU_KpVhr61razRw)**  
+  Посмотрите подробную демонстрацию и узнайте, как интегрировать Intlayer в реальном времени.
+
+---
+
+## Вклад и обратная связь
+
+Мы ценим силу открытого исходного кода и развитие, основанное на сообществе. Если вы хотите предложить улучшения, добавить новое руководство или исправить любые ошибки в нашей документации, не стесняйтесь отправить Pull Request или открыть issue в нашем [репозитории GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Готовы переводить ваше приложение быстрее и эффективнее?** Погрузитесь в нашу документацию и начните использовать Intlayer уже сегодня. Ощутите надежный и упрощенный подход к интернационализации, который помогает организовать ваш контент и повысить продуктивность вашей команды.
+
+## История документации
+
+- 5.5.10 - 2025-06-29: Инициализация истории

package/docs/ru/interest_of_intlayer.md

@@ -0,0 +1,154 @@
+---
+createdAt: 2024-08-14
+updatedAt: 2025-06-29
+title: Преимущества Intlayer
+description: Узнайте о преимуществах и достоинствах использования Intlayer в ваших проектах. Поймите, почему Intlayer выделяется среди других фреймворков.
+keywords:
+  - Преимущества
+  - Достоинства
+  - Intlayer
+  - Фреймворк
+  - Сравнение
+slugs:
+  - doc
+  - concept
+  - interest
+---
+
+# Intlayer: Индивидуальный способ перевода вашего сайта
+
+**Intlayer** — это библиотека интернационализации, разработанная специально для разработчиков на JavaScript. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+
+## Пример использования
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```bash codeFormat="esm"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.mjs
+        └── index.js
+```
+
+```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", // испанский
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World", // английский
+      fr: "Bonjour le monde", // французский
+      es: "Hola Mundo", // испанский
+    }),
+  },
+};
+
+export default componentExampleContent;
+```
+
+```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", // испанский
+    }),
+  },
+};
+
+module.exports = componentExampleContent;
+```
+
+```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+import { useIntlayer } from "react-intlayer";
+
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Почему стоит выбрать 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: Инициализация истории