@intlayer/docs 9.4.4 → 9.5.0

package/docs/ru/intlayer_with_lynx+react.md

@@ -51,37 +51,31 @@ author: aymericzip
 Intlayer оптимизирован для идеальной работы с Lynx и React, предлагая **охват контента на уровне компонентов**, **поддержку TypeScript** и все функции, необходимые для масштабирования интернационализации (i18n).
 
 </Accordion>
-
 <Accordion header="Размер бандла">
 
 Вместо загрузки огромных файлов JSON на свои страницы загружайте только необходимый контент. Intlayer помогает **уменьшить размер бандла и страниц до 50 %**.
 
 </Accordion>
-
 <Accordion header="Удобство обслуживания">
 
 Определение области содержимого вашего приложения **облегчает обслуживание** крупномасштабных приложений. Вы можете дублировать или удалить отдельную папку функций, не утруждав себя мысленным бременем проверки всей кодовой базы контента. Кроме того, Intlayer **полностью типизирован**, что обеспечивает точность вашего контента.
 
 </Accordion>
-
 <Accordion header="Агент ИИ">
 
 Совместное размещение контента **уменьшает контекст, необходимый** для моделей большого языка (LLM). Intlayer также поставляется с набором инструментов, таких как **CLI** для проверки отсутствия переводов,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)**, и **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать работу разработчика (DX) еще более удобной для агентов ИИ.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Используйте автоматизацию для перевода в своем конвейере CI/CD, используя LLM по вашему выбору за счет вашего поставщика ИИ. Intlayer также предлагает **компилятор** для автоматизации извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), которая помогает **переводить в фоновом режиме**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Подключение больших файлов JSON к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента во время сборки (build time).
 
 </Accordion>
-
 <Accordion header="Масштабирование с помощью не-разработчиками">
 
 Intlayer — это больше, чем просто решение i18n. Он предоставляет **автономный [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** и **[полный CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, чтобы помочь вам управлять многоязычным контентом в **реальном времени**, упрощая сотрудничество с переводчиками, копирайтерами и другими членами команды. Контент может храниться локально и/или удаленно.
@@ -89,10 +83,7 @@ Intlayer — это больше, чем просто решение i18n. Он
 </Accordion>
 </AccordionGroup>
 
----
-
 <Steps>
-
 <Step number={1} title="Установите зависимости">
 
 Из вашего проекта Lynx установите следующие пакеты:
@@ -145,7 +136,6 @@ bun add intlayer react-intlayer lynx-intlayer
   Интеграция с Lynx, предоставляющая плагин для интеграции Intlayer с бандлером Lynx.
 
 </Step>
-
 <Step number={2} title="Создайте конфигурацию Intlayer">
 
 В корне вашего проекта (или в любом удобном месте) создайте файл **конфигурации Intlayer**. Он может выглядеть так:
@@ -176,7 +166,6 @@ export default config;
 - См. [документацию по конфигурации Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md) для получения дополнительной информации.
 
 </Step>
-
 <Step number={3} title="Добавьте плагин Intlayer в бандлер Lynx">
 
 Чтобы использовать Intlayer с Lynx, вам нужно добавить плагин в файл `lynx.config.ts`:
@@ -194,7 +183,6 @@ export default defineConfig({
 ```
 
 </Step>
-
 <Step number={4} title="Добавьте провайдер Intlayer">
 
 Чтобы синхронизировать язык пользователя по всему приложению, вам нужно обернуть ваш корневой компонент в компонент `IntlayerProvider` из `react-intlayer`.
@@ -222,7 +210,6 @@ if (import.meta.webpackHot) {
 ```
 
 </Step>
-
 <Step number={5} title="Объявите ваш контент">
 
 Создайте файлы **объявления контента** в любом месте вашего проекта (обычно в `src/`), используя любой из форматов расширений, поддерживаемых Intlayer:
@@ -339,7 +326,6 @@ export default appContent;
 > Для получения подробной информации о декларациях контента, см. [документацию по контенту Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
 
 </Step>
-
 <Step number={6} title="Используйте Intlayer в ваших компонентах">
 
 Используйте хук `useIntlayer` в дочерних компонентах для получения локализованного контента.
@@ -397,7 +383,6 @@ export const App = () => {
 > При использовании `content.someKey` в строковых свойствах (например, `title` кнопки или `children` компонента `Text`), **вызывайте `content.someKey.value`**, чтобы получить строку.
 
 </Step>
-
 <Step number={7} title="Измените локаль приложения">
 
 Для переключения локалей из ваших компонентов вы можете использовать метод `setLocale` из хука `useLocale`:
@@ -466,8 +451,6 @@ Intlayer генерирует определения типов в скрыто
 - **Автозаполнение** для ключей вашего словаря.
 - **Проверка типов**, которая предупреждает, если вы обращаетесь к несуществующему ключу или несовместимому типу.
 
----
-
 ## Конфигурация Git
 
 Чтобы избежать коммита автоматически сгенерированных файлов Intlayer, добавьте следующее в ваш `.gitignore`:
@@ -477,8 +460,6 @@ Intlayer генерирует определения типов в скрыто
 .intlayer
 ```
 
----
-
 ### Расширение VS Code
 
 Для улучшения вашего опыта разработки с Intlayer вы можете установить официальное **расширение Intlayer для VS Code**.
@@ -498,8 +479,6 @@ Intlayer генерирует определения типов в скрыто
 - **Быстрые действия** для лёгкого создания и обновления переводов.
   Для получения дополнительной информации о том, как использовать расширение, обратитесь к [документации по расширению Intlayer для VS Code](https://intlayer.org/doc/vs-code-extension).
 
----
-
 ## Узнайте больше
 
 - **Визуальный редактор**: Используйте [визуальный редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) для визуального управления переводами.

package/docs/ru/intlayer_with_nestjs.md

@@ -279,25 +279,21 @@ export default config;
 См. [почему Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/interest_of_intlayer.md).
 
 </Question>
-
 <Question title="Насколько i18n увеличивает размер бандла моего сервера NestJS?">
 
 Очень немного. Словари компилируются заранее, и включаются только те локали, которые вы объявляете, поэтому нет ни загрузки каталогов при старте, ни чтения файлов на пути запроса. Это важнее всего в serverless- и edge-развёртываниях, где размер бандла определяет время холодного старта. См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md).
 
 </Question>
-
 <Question title="Могу ли я мигрировать с `i18next`, не переписывая свои обработчики?">
 
 Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, но обслуживаемый словарями Intlayer, поэтому меняются импорты, а код обработчиков - нет.
 
 </Question>
-
 <Question title="Могу ли я сохранить свои существующие файлы переводов JSON?">
 
 Да. [Плагин синхронизации JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md) сохраняет ваши файлы `/messages/{locale}/{namespace}.json` как источник истины и генерирует из них словари Intlayer, в обоих направлениях. [Плагин синхронизации PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-po.md) делает то же самое для каталогов gettext, а [файлы по локали](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/per_locale_file.md) позволяют разделить контент по языкам вместо группировки локалей в одном файле.
 
 </Question>
-
 <Question title="Должен ли я переносить свой контент ключ за ключом?">
 
 Нет. Запустите `npx intlayer extract`, и Intlayer прочитает ваши исходные файлы, извлечёт строки, видимые пользователю, и запишет файл `.content` рядом с каждым из них, так что вы просматриваете diff вместо копирования строк в каталог по одной. См. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md).
@@ -305,7 +301,6 @@ export default config;
 На стороне фронтенда того же проекта [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) идёт дальше и генерирует словари во время сборки из вашего исходного кода JSX, TSX, Vue или Svelte, поэтому обе половины приложения делят один слой контента без ключей, поддерживаемых вручную.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -317,61 +312,51 @@ export default config;
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Как Intlayer узнаёт, на каком языке отвечать?">
 
 По умолчанию `express-intlayer` читает заголовок `Accept-Language` входящего запроса и выбирает ближайшую объявленную локаль, откатываясь к вашей локали по умолчанию. Вы можете изменить источник с помощью `routing.storage`, например пользовательский заголовок или cookie, установленный вашим фронтендом, чтобы API отвечал на языке, который пользователь действительно выбрал, а не на том, который рекламирует его браузер. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 </Question>
-
 <Question title="Изолирована ли локаль для каждого запроса?">
 
 Да. Middleware ограничивает активную локаль областью запроса, поэтому два параллельных запроса на разных языках никогда не читают локаль друг друга. Именно это делает безопасным вызов `t()` и `getIntlayer()` из сервиса без протаскивания аргумента локали через каждую функцию.
 
 </Question>
-
 <Question title="Как отправлять транзакционные письма на языке получателя?">
 
 Объявите контент письма в файле контента, как любой другой контент, затем разрешите его с помощью `getIntlayer` для сохранённой локали получателя, а не для локали запроса. Это важно для задач и очередей, где язык принадлежит записи пользователя и нет входящего запроса, из которого можно прочитать заголовок.
 
 </Question>
-
 <Question title="Как локализовать сообщения об ошибках API?">
 
 Оберните сообщение в `t()` в том месте, где строится ошибка. Активная локаль запроса разрешает его, поэтому клиент получает сообщение, которое может отобразить напрямую, и вашему фронтенду не нужен параллельный каталог кодов ошибок.
 
 </Question>
-
 <Question title="Могу ли я внедрять переводы в сервис или контроллер NestJS?">
 
 Да. Вызовите `getIntlayer("app")` внутри сервиса или контроллера, как показано выше. Нет модуля для регистрации на каждую функцию и нет токена для внедрения, потому что активная локаль берётся из контекста запроса, установленного middleware.
 
 </Question>
-
 <Question title="Как автоматически перевести контент бэкенда с помощью ИИ?">
 
 Запустите `npx intlayer fill`, которая заполняет недостающие переводы с помощью выбранной вами LLM, используя ваш собственный провайдер и API-ключ. Добавьте `--git-diff`, чтобы перевести только контент, изменённый в ветке. См. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md) и [интеграцию CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/CI_CD.md).
 
 </Question>
-
 <Question title="Поддерживает ли Intlayer множественное число, род и интерполированные значения на сервере?">
 
 Да: [формы множественного числа](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/plurial.md), [контент на основе рода](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/gender.md), условия, [вставки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md) для интерполированных значений, [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md) для тел писем и [форматтеры](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/formatters.md) для чисел, дат и валют.
 
 </Question>
-
 <Question title="Получаю ли я автодополнение TypeScript на сервере?">
 
 Да. Intlayer генерирует типы ваших словарей в `./types/intlayer.d.ts`, поэтому несуществующий ключ - это ошибка компиляции, а не пустая строка во время выполнения. Запустите `npx intlayer test` в CI, чтобы провалить сборку, когда объявленной локали не хватает контента.
 
 </Question>
-
 <Question title="Могут ли фронтенд и бэкенд использовать один и тот же контент?">
 
 Да, и это обычная настройка. `express-intlayer` работает вместе с `react-intlayer`, `next-intlayer` и `vite-intlayer` на одном объявленном контенте, поэтому надпись, используемая и в ответе API, и на странице, объявляется один раз. См. [как работает Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/how_works_intlayer.md).
 
 </Question>
-
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 
 Да, по лицензии Apache 2.0, включая коммерческое использование. Размещённая [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) - это необязательный платный сервис, который также можно [разместить самостоятельно](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).

package/docs/ru/intlayer_with_next-i18next.md

@@ -40,8 +40,6 @@ author: aymericzip
 > Примечание: next-i18next построен на основе i18next. В этом руководстве используются примитивы i18next, совместимые с next-i18next в App Router, при этом архитектура остаётся простой и готовой к продакшену.
 > Для более широкого сравнения смотрите [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/next-i18next_vs_next-intl_vs_intlayer.md).
 
----
-
 ## 1) Структура проекта
 
 Установите зависимости next-i18next -
@@ -93,8 +91,6 @@ bun add next-i18next i18next react-i18next i18next-resources-to-backend
 - Не централизуйте сообщения чрезмерно; используйте небольшие namespace, ограниченные страницей или функционалом
 - Избегайте одновременного импорта всех локалей; загружайте только то, что нужно
 
----
-
 ## 2) Установка зависимостей
 
 ```bash
@@ -108,8 +104,6 @@ pnpm add i18next react-i18next i18next-resources-to-backend
 pnpm add next-i18next
 ```
 
----
-
 ## 3) Основная конфигурация i18n
 
 Определите локали, локаль по умолчанию, RTL и вспомогательные функции для локализованных путей/URL.
@@ -136,8 +130,6 @@ export function abs(locale: string, path: string) {
 
 Важное замечание: если вы используете `next-i18next.config.js`, поддерживайте его в синхронизации с `i18n.config.ts`, чтобы избежать рассогласования.
 
----
-
 ## 4) Инициализация i18n на стороне сервера
 
 Инициализируйте i18next на сервере с динамическим backend, который импортирует только необходимые JSON-файлы локали/пространства имён.
@@ -176,8 +168,6 @@ export async function initI18next(
 
 Среднее замечание: Держите список пространств имён коротким для каждой страницы, чтобы ограничить объём загружаемых данных. Избегайте глобальных «ловящих всё» пакетов.
 
----
-
 ## 5) Провайдер клиента для React-компонентов
 
 Оборачивайте клиентские компоненты провайдером, который повторяет конфигурацию сервера и загружает только запрошенные пространства имён.
@@ -234,8 +224,6 @@ export default function I18nProvider({
 
 Совет для начинающих: вам не нужно передавать все сообщения клиенту. Начинайте только с пространств имён страницы.
 
----
-
 ## 6) Локализованный layout и маршруты
 
 Установите язык и направление, а также предварительно сгенерируйте маршруты для каждой локали, чтобы способствовать статической отрисовке.
@@ -271,8 +259,6 @@ export default function LocaleLayout({
 }
 ```
 
----
-
 ## 7) Пример страницы с использованием на сервере и клиенте
 
 ```tsx fileName="src/app/[locale]/about.tsx"
@@ -388,8 +374,6 @@ const ServerComponent = ({ t, locale, count }: ServerComponentProps) => {
 export default ServerComponent;
 ```
 
----
-
 ## 8) SEO: Метаданные, Hreflang, Sitemap, Robots
 
 Перевод контента, это способ расширить охват. Тщательно настройте многоязычное SEO.
@@ -484,8 +468,6 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
----
-
 ## 9) Middleware для маршрутизации локали
 
 Определяет локаль и перенаправляет на локализованный маршрут, если он отсутствует.
@@ -528,8 +510,6 @@ export const config = {
 };
 ```
 
----
-
 ## 10) Лучшие практики производительности и удобства разработки (DX)
 
 - **Установите атрибуты html `lang` и `dir`**: Выполнено в `src/app/[locale]/layout.tsx`.
@@ -540,8 +520,6 @@ export const config = {
 - **Мемоизируйте тяжёлые операции**: Особенно в клиентском коде для старых версий React.
 - **Кэш и заголовки**: Предпочитайте статический рендеринг или `revalidate` вместо динамического, когда это возможно.
 
----
-
 ## 11) Тестирование и CI
 
 - Добавьте unit-тесты для компонентов, использующих `t`, чтобы гарантировать наличие ключей.
@@ -550,8 +528,6 @@ export const config = {
 
 Intlayer автоматизирует большую часть этого (см. следующий раздел).
 
----
-
 ## 12) Добавление Intlayer сверху (автоматизация)
 
 Intlayer помогает поддерживать JSON-переводы в синхронизации, тестировать отсутствие ключей и заполнять их с помощью ИИ при необходимости.
@@ -637,8 +613,6 @@ export default config;
 
 > Вы можете передавать аргументы CLI; смотрите [документацию Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md).
 
----
-
 ## 13) Устранение неполадок
 
 - **Ключи не найдены**: Убедитесь, что страница/провайдер перечисляет правильные пространства имён, и что JSON-файл существует по пути `src/locales/<locale>/<namespace>.json`.
@@ -647,8 +621,6 @@ export default config;
 - **Отсутствуют SEO-альтернативы**: Проверьте, что `alternates.languages` включает все локали и `x-default`.
 - **Слишком большие бандлы**: Разбейте пространства имён на более мелкие и избегайте импорта всего дерева `locales` на клиенте.
 
----
-
 ## 14) Что дальше
 
 - Добавляйте больше локалей и пространств имён по мере роста функционала

package/docs/ru/intlayer_with_nextjs_14.md

@@ -44,37 +44,31 @@ Intlayer оптимизирован для работы с **Серверным
 > Для Next.js 12, 13, 14 и 15 с App Router обратитесь к этому [руководству] (https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_14.md).
 
 </Accordion>
-
 <Accordion header="Размер бандла">
 
 Вместо загрузки огромных файлов JSON на свои страницы загружайте только необходимый контент. Intlayer помогает **уменьшить размер бандла и страниц до 50 %**.
 
 </Accordion>
-
 <Accordion header="Удобство обслуживания">
 
 Определение области содержимого вашего приложения **облегчает обслуживание** крупномасштабных приложений. Вы можете дублировать или удалить отдельную папку функций, не утруждав себя мысленным бременем проверки всей кодовой базы контента. Кроме того, Intlayer **полностью типизирован**, что обеспечивает точность вашего контента.
 
 </Accordion>
-
 <Accordion header="Агент ИИ">
 
 Совместное размещение контента **уменьшает контекст, необходимый** для моделей большого языка (LLM). Intlayer также поставляется с набором инструментов, таких как **CLI** для проверки отсутствия переводов,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)**, и **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать работу разработчика (DX) еще более удобной для агентов ИИ.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Используйте автоматизацию для перевода в своем конвейере CI/CD, используя LLM по вашему выбору за счет вашего поставщика ИИ. Intlayer также предлагает **компилятор** для автоматизации извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), которая помогает **переводить в фоновом режиме**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Подключение больших файлов JSON к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента во время сборки (build time).
 
 </Accordion>
-
 <Accordion header="Масштабирование с помощью не-разработчиками">
 
 Intlayer — это больше, чем просто решение i18n. Он предоставляет **автономный [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** и **[полный CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, чтобы помочь вам управлять многоязычным контентом в **реальном времени**, упрощая сотрудничество с переводчиками, копирайтерами и другими членами команды. Контент может храниться локально и/или удаленно.
@@ -82,8 +76,6 @@ Intlayer — это больше, чем просто решение i18n. Он
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Пошаговое руководство по настройке Intlayer в приложении Next.js
 
 <Tabs defaultTab="code">
@@ -114,7 +106,6 @@ Intlayer — это больше, чем просто решение i18n. Он
 Смотрите [Application Template](https://github.com/aymericzip/intlayer-next-14-template) на GitHub.
 
 <Steps>
-
 <Step number={1} title="Установите зависимости">
 
 Установите необходимые пакеты с помощью npm:
@@ -164,7 +155,6 @@ bun add intlayer next-intlayer
   Пакет, интегрирующий Intlayer с Next.js. Он предоставляет провайдеры контекста и хуки для интернационализации в Next.js. Кроме того, он включает плагин Next.js для интеграции Intlayer с [Webpack](https://webpack.js.org/) или [Turbopack](https://nextjs.org/docs/app/api-reference/turbopack), а также middleware для определения предпочтительной локали пользователя, управления cookies и обработки перенаправлений URL.
 
 </Step>
-
 <Step number={2} title="Настройте ваш проект">
 
 Here is the final structure that we will make:
@@ -218,7 +208,6 @@ export default config;
 > С помощью этого файла конфигурации вы можете настроить локализованные URL, перенаправления middleware, имена cookies, расположение и расширение ваших деклараций контента, отключить логи Intlayer в консоли и многое другое. Для полного списка доступных параметров обратитесь к [документации по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 </Step>
-
 <Step number={3} title="Интеграция Intlayer в конфигурацию Next.js">
 
 Настройте ваш проект Next.js для использования Intlayer:
@@ -244,7 +233,6 @@ export default withIntlayer(nextConfig);
 > ```
 
 </Step>
-
 <Step number={4} title="Настройка Middleware для определения локали">
 
 Настройте middleware для определения предпочтительной локали пользователя:
@@ -280,7 +268,6 @@ export const middleware = multipleMiddlewares([
 ```
 
 </Step>
-
 <Step number={5} title="Определите динамические маршруты локали">
 
 Удалите все из `RootLayout` и замените следующим кодом:
@@ -372,7 +359,6 @@ export default LocaleLayout;
 > `generateStaticParams` гарантирует, что ваше приложение предварительно создает необходимые страницы для всех локалей, уменьшая вычисления во время выполнения и улучшая пользовательский опыт. Для получения дополнительной информации обратитесь к [документации Next.js о generateStaticParams](https://nextjs.org/docs/app/building-your-application/rendering/static-and-dynamic-rendering#generate-static-params).
 
 </Step>
-
 <Step number={6} title="Объявите ваш контент">
 
 Создайте и управляйте вашими декларациями контента для хранения переводов:
@@ -430,7 +416,6 @@ export default pageContent;
 > Для получения дополнительной информации обратитесь к [документации объявления контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
 
 </Step>
-
 <Step number={7} title="Используйте контент в вашем коде">
 
 Получите доступ к словарям контента в вашем приложении:
@@ -567,16 +552,15 @@ const ServerComponentExample: FC = () => {
 
 > Если вы хотите использовать ваш контент в атрибуте `string`, таком как `alt`, `title`, `href`, `aria-label` и т.д., вы должны вызвать значение функции, например:
 
-> ```html
-> <img src="{content.image.src.value}" alt="{content.image.value}" />
-> <img src="{content.image.src.toString()}" alt="{content.image.toString()}" />
-> <img src="{String(content.image.src)}" alt="{String(content.image)}" />
+> ```tsx
+> <img src={content.image.src.value} alt={content.image.value} />
+> <img src={content.image.src.toString()} alt={content.image.toString()} />
+> <img src={String(content.image.src)} alt={String(content.image)} />
 > ```
 
 > Чтобы узнать больше о хуке `useIntlayer`, обратитесь к [документации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/next-intlayer/useIntlayer.md).
 
 </Step>
-
 <Step number={8} title="Интернационализация ваших метаданных" isOptional={true}>
 
 Если вы хотите интернационализировать свои метаданные, такие как заголовок страницы, вы можете использовать функцию `generateMetadata`, предоставляемую Next.js. Внутри вы можете получить содержимое из функции `getIntlayer` для перевода ваших метаданных.
@@ -684,7 +668,6 @@ export const generateMetadata = ({ params: { locale } }) => {
 > Узнайте больше об оптимизации метаданных [в официальной документации Next.js](https://nextjs.org/docs/app/building-your-application/optimizing/metadata).
 
 </Step>
-
 <Step number={9} title="Интернационализация вашего sitemap.xml и robots.txt" isOptional={true}>
 
 Для интернационализации вашего `sitemap.xml` и `robots.txt` вы можете использовать функцию `getMultilingualUrls`, предоставляемую Intlayer. Эта функция позволяет генерировать мультиязычные URL для вашего sitemap.
@@ -765,7 +748,6 @@ export default robots;
 > Узнайте больше об оптимизации карты сайта [в официальной документации Next.js](https://nextjs.org/docs/app/api-reference/file-conventions/metadata/sitemap). Узнайте больше об оптимизации robots.txt [в официальной документации Next.js](https://nextjs.org/docs/app/api-reference/file-conventions/metadata/robots).
 
 </Step>
-
 <Step number={10} title="Изменение языка вашего контента" isOptional={true}>
 
 Чтобы изменить язык вашего контента в Next.js, рекомендуется использовать компонент `Link` для перенаправления пользователей на соответствующую локализованную страницу. Компонент `Link` позволяет предварительно загружать страницу, что помогает избежать полной перезагрузки страницы.
@@ -856,7 +838,6 @@ return (
 > - [`aria-current` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 </Step>
-
 <Step number={11} title="Создание локализованного компонента ссылки" isOptional={true}>
 
 Чтобы обеспечить, что навигация вашего приложения учитывает текущую локаль, вы можете создать пользовательский компонент `Link`. Этот компонент автоматически добавляет префикс к внутренним URL-адресам с текущим языком. Например, когда пользователь, говорящий на французском, нажимает на ссылку на страницу "О нас", он перенаправляется на `/fr/about` вместо `/about`.
@@ -927,7 +908,6 @@ Link.displayName = "Link";
 Интегрируя этот компонент `Link` в ваше приложение, вы поддерживаете согласованный и языково-осведомленный пользовательский опыт, а также улучшаете SEO и удобство использования.
 
 </Step>
-
 <Step number={12} title="Оптимизация размера вашего бандла" isOptional={true}>
 
 Если вам нужна активная локаль внутри Server Action (например, для локализации писем или выполнения логики с учетом локали), вызовите `getLocale` из `next-intlayer/server`:
@@ -954,7 +934,6 @@ export const myServerAction = async () => {
 > Это гарантирует, что будет выбрана наиболее подходящая локаль на основе доступного контекста.
 
 </Step>
-
 <Step number={13} title="Оптимизировать размер вашего пакета" isOptional={true}>
 
 При использовании `next-intlayer` словари по умолчанию включаются в бандл для каждой страницы. Чтобы оптимизировать размер бандла, Intlayer предоставляет опциональный SWC плагин, который интеллектуально заменяет вызовы `useIntlayer` с помощью макросов. Это гарантирует, что словари включаются только в бандлы тех страниц, которые их действительно используют.
@@ -1052,25 +1031,21 @@ Intlayer использует расширение модулей (module augmen
 Практическая разница - в том, что доходит до браузера. Библиотеки на основе пространств имён поставляют на страницу целые каталоги JSON, тогда как Intlayer поставляет только тот контент, который используют отрендеренные компоненты, что сокращает размер бандла и страницы до 50%. См. [почему Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/interest_of_intlayer.md) и [бенчмарк i18n для Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/nextjs.md).
 
 </Question>
-
 <Question title="Насколько i18n увеличивает размер бандла моего Next.js?">
 
 Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Серверные компоненты разрешают свой контент на сервере, и компилятор во время сборки заменяет вызовы `useIntlayer` точными записями словаря, которые использует компонент, поэтому неиспользуемые ключи и неиспользуемые языки отбрасываются, а [динамические словари](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md) разделяют остальное по локалям. По сравнению с обычными альтернативами Intlayer сокращает размер бандла и страницы до 50%. См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) и [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/nextjs.md).
 
 </Question>
-
 <Question title="Могу ли я мигрировать с `next-intl`, `next-i18next` или `i18next`, не переписывая свои компоненты?">
 
 Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md) или [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `next-intl`, `react-i18next` и `react-intl`, но обслуживаемый словарями Intlayer, поэтому меняются импорты, а код компонентов - нет.
 
 </Question>
-
 <Question title="Могу ли я сохранить свои существующие файлы переводов JSON?">
 
 Да. [Плагин синхронизации JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md) сохраняет ваши файлы `/messages/{locale}/{namespace}.json` как источник истины и генерирует из них словари Intlayer, в обоих направлениях. [Плагин синхронизации PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-po.md) делает то же самое для каталогов gettext, а [файлы по локали](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/per_locale_file.md) позволяют разделить контент по языкам вместо группировки локалей в одном файле.
 
 </Question>
-
 <Question title="Должен ли я переносить свой контент ключ за ключом?">
 
 Нет. Запустите `npx intlayer extract`, и Intlayer прочитает ваши исходные файлы, извлечёт строки, видимые пользователю, и запишет файл `.content` рядом с каждым из них, так что вы просматриваете diff вместо копирования строк в каталог по одной. См. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md).
@@ -1078,7 +1053,6 @@ Intlayer использует расширение модулей (module augmen
 Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -1090,61 +1064,51 @@ Intlayer использует расширение модулей (module augmen
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Какие версии Next.js поддерживает Intlayer?">
 
 Next.js 12, 13, 14, 15 и 16. Это руководство охватывает Next.js 14. Для Next.js 16 следуйте [руководству по Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_16.md). Для Next.js 15 следуйте [руководству по Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_15.md). Для Pages Router следуйте [руководству по Pages Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_page_router.md).
 
 </Question>
-
 <Question title="Работает ли Intlayer с React Server Components?">
 
 Да. В Next.js 14 `params` в App Router всё ещё синхронны, поэтому локаль читается напрямую из сегмента маршрута и передаётся провайдеру. Контент разрешается на сервере внутри серверных компонентов, поэтому для серверно отрендеренного текста клиенту не отправляется никакой словарь, а клиентские компоненты читают те же словари через провайдер.
 
 </Question>
-
 <Question title="Должен ли я помещать локаль в URL, например /fr/about?">
 
 Нет. `routing.mode` принимает `"prefix-no-default"` (по умолчанию, `/about` для локали по умолчанию и `/fr/about` для остальных), `"prefix-all"`, `"no-prefix"` (разрешается из cookie, заголовка или домена) и `"search-params"` (`/about?locale=fr`). `routing.domains` сопоставляет каждую локаль с её собственным доменом. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md) и [руководство без пути локали](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_no_locale_path.md).
 
 </Question>
-
 <Question title="Как добавить теги hreflang и локализованные метаданные для SEO?">
 
 Шаг 8 охватывает `generateMetadata`, а шаг 9 охватывает `sitemap.xml` и `robots.txt`. `getMultilingualUrls` строит карту `alternates.languages` для каждой объявленной локали, включая запись `x-default`, поэтому поисковые системы обслуживают правильную языковую версию.
 
 </Question>
-
 <Question title="Нужен ли мне middleware?">
 
 Именно он определяет локаль посетителя и перенаправляет на соответствующий префикс, поэтому он вам нужен, если только вы не обрабатываете маршрутизацию локали самостоятельно. Шаг 4 показывает конфигурацию, включая matcher, который держит маршруты API, статические ресурсы и `_next` в стороне.
 
 </Question>
-
 <Question title="Как создать локализованный компонент Link?">
 
 Шаг 11 показывает это. Компонент оборачивает `Link` из Next.js и пропускает href через `getLocalizedUrl`, поэтому внутренняя ссылка, написанная как `/about`, становится `/fr/about` для французского посетителя без повторения локали в каждом месте вызова.
 
 </Question>
-
 <Question title="Как автоматически перевести приложение с помощью ИИ?">
 
 Запустите `npx intlayer fill`. Она заполняет недостающие переводы с помощью выбранной вами LLM, используя ваш собственный провайдер и API-ключ, а `--git-diff` ограничивает запуск контентом, изменённым в ветке. См. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md) и [интеграцию CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/CI_CD.md).
 
 </Question>
-
 <Question title="Поддерживает ли Intlayer множественное число, род и форматированный текст?">
 
 Да: [формы множественного числа](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/plurial.md), [контент на основе рода](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/gender.md), условия, [вставки](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md), [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md) и [форматтеры](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/formatters.md) для чисел, дат и валют.
 
 </Question>
-
 <Question title="Как переводчики могут редактировать контент, не касаясь кода?">
 
 Через [визуальный редактор](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/intlayer_CMS.md), которая выносит контент вовне, чтобы он мог меняться без развёртывания.
 
 </Question>
-
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 
 Да, по лицензии Apache 2.0, включая коммерческое использование. Размещённая CMS - это необязательный платный сервис, который также можно [разместить самостоятельно](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).