@intlayer/docs 9.4.1 → 9.4.2

package/docs/ru/dictionary/markdown.md

@@ -104,7 +104,6 @@ Intlayer поддерживает форматированный текстов
 
   </Tab>
 
-  </Tab>
   <Tab label="Внешние файлы" value="external-files">
     Импортируйте файлы `.md` напрямую, используя функцию `file`.
 
@@ -140,7 +139,6 @@ Intlayer поддерживает форматированный текстов
 
   </Tab>
 
-  </Tab>
 </Tabs>
 
 ## Рендеринг Markdown

package/docs/ru/dictionary/plurial.md

@@ -33,11 +33,14 @@ To use plural content in Next.js Client Components, retrieve it via the `useIntl
 
 To use plural content in Angular components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
 
-## Когда использовать `plural` против `enu`
+## Когда использовать `plural` вместо `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Вариант использования                                                         | Хелпер   |
+| ----------------------------------------------------------------------------- | -------- |
+| Грамматические формы множественного числа для языка (яблоко / яблока / яблок) | `plural` |
+| Пользовательские числовые диапазоны (`<5`, `>=10`) или категории вне CLDR     | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Если вы ориентируетесь только на английский (где есть только `one` / `other`), подойдут оба варианта. Для языков с формами `few` / `many` / `two` выбирайте `plural`.
 
 ## Настройка контента во множественном числе
 

package/docs/ru/dictionary/translation.md

@@ -29,7 +29,6 @@ author: aymericzip
 
 With `react-intlayer`, you can use translations in React components. Here's an example:
 
-  </Tab>
   <Tab label="Next.js" value="nextjs">
 
 ```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
@@ -68,6 +67,7 @@ const MyComponent: Component = () => {
 export default MyComponent;
 ```
 
+  </Tab>
 ## Конфигурация локалей
 
 Для обеспечения правильной обработки переводов вы можете настроить поддерживаемые локали в файле `intlayer.config.ts`. Эта конфигурация позволяет определить языки, которые поддерживает ваше приложение:

package/docs/ru/how_works_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-12
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Как работает Intlayer
 description: Узнайте, как Intlayer работает внутри. Поймите архитектуру и компоненты, которые делают Intlayer мощным.
 keywords:
@@ -259,3 +259,95 @@ Intlayer состоит из нескольких пакетов, каждый
 ## Общайтесь с нашей умной документацией
 
 - [Задайте свои вопросы нашей умной документации](https://intlayer.org/doc/chat)
+
+## Часто задаваемые вопросы
+
+<FAQ>
+
+<Question title="Когда собираются словари - во время сборки или во время выполнения?">
+
+Во время сборки. Плагин сборщика или `npx intlayer build` сканирует ваши файлы `.content.ts`, разрешает их в словари в папке `.intlayer` и генерирует соответствующие типы TypeScript. Во время выполнения ваши компоненты только читают результат, поэтому на пути запроса не происходит ни разбора, ни загрузки файлов.
+
+</Question>
+
+<Question title="Насколько i18n увеличивает размер моего бандла?">
+
+Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `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/index.md).
+
+</Question>
+
+<Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
+
+Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями 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).
+
+Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
+
+</Question>
+
+<Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
+
+Пять компонентов, все опциональные:
+
+- **[Расширение для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)**: переход от ключа `useIntlayer` к файлу контента, который его объявляет, извлечение контента из компонента и запуск build, fill, test, push и pull из палитры команд или отдельной вкладки Intlayer.
+- **[LSP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**: та же осведомлённость в любом редакторе, который говорит на LSP, с переходом к определению, поиском всех ссылок, предпросмотром переведённого значения при наведении, автодополнением ключей и полей и предупреждением, когда ключ нигде не объявлен. Он также разрешает вызовы `i18next`, `react-i18next`, `next-intl` и `use-intl`, что помогает при миграции.
+- **[MCP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)**: предоставляет документацию и CLI Intlayer для Cursor, VS Code, Claude Desktop, Claude Code и ChatGPT, чтобы ассистент отвечал по актуальной документации, а не гадал, и мог сам запускать команды вроде `intlayer fill`.
+- **[Навыки агентов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**: сфокусированные навыки, такие как `intlayer-config`, `intlayer-cli` и `intlayer-content`, плюс по одному на фреймворк, которые обучают агента вашей настройке маршрутизации и типам узлов контента.
+- **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
+
+</Question>
+
+<Question title="Что такое папка .intlayer и нужно ли её коммитить?">
+
+Это сгенерированный вывод: скомпилированные словари и сгенерированные типы. Он выводится из ваших файлов контента, поэтому должен быть указан в `.gitignore` и пересобираться вашим шагом сборки, точно как папка `dist`.
+
+</Question>
+
+<Question title="Как определяется активная локаль?">
+
+Из источников, перечисленных в `routing.storage`, по порядку: префикс URL, когда `routing.mode` его использует, затем cookie, затем заголовок `Accept-Language`, затем ваша локаль по умолчанию. Локаль, которую пользователь выбирает явно, сохраняется, поэтому переживает следующий визит. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
+
+</Question>
+
+<Question title="В чём разница между локальными и удалёнными словарями?">
+
+Локальный словарь объявляется в вашей кодовой базе и компилируется вместе с приложением. Удалённый словарь управляется в [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и разрешается во время выполнения, поэтому может меняться без развёртывания. Оба читаются через одни и те же хуки, и удалённый контент откатывается к локальному объявлению, когда недоступен.
+
+</Question>
+
+<Question title="Работает ли Intlayer без TypeScript?">
+
+Да. Файлы контента можно писать на TypeScript, JavaScript, ESM, CommonJS или JSON. Именно TypeScript открывает сгенерированные типы и автодополнение, поэтому это рекомендуемая настройка, но она не обязательна.
+
+</Question>
+
+<Question title="Как серверный рендеринг и клиентский рендеринг используют один и тот же контент?">
+
+Сервер разрешает контент серверно отрендеренных компонентов напрямую, поэтому для этой разметки клиенту не отправляется никакой словарь. Клиентские компоненты читают те же словари через провайдер, который получает локаль, разрешённую на сервере, поэтому первый клиентский рендер совпадает с серверным HTML и не вспыхивает другим языком.
+
+</Question>
+
+<Question title="Как Intlayer избегает несоответствия гидратации по локали?">
+
+Локаль разрешается один раз на сервере и передаётся провайдеру, а не определяется снова в браузере. Поскольку клиент стартует с той же локали, что отрендерил сервер, разметка совпадает, что и ломается обычно при клиентском определении локали.
+
+</Question>
+
+<Question title="Нужно ли пересобирать проект, когда я добавляю перевод?">
+
+В разработке - нет: плагин следит за вашими файлами контента и пересобирает затронутые словари при сохранении. В продакшене словари являются частью сборки, если только контент не удалённый - в этом случае [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и [живая синхронизация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md) применяют изменение без развёртывания.
+
+</Question>
+
+</FAQ>

package/docs/ru/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: Преимущества Intlayer
 description: Узнайте о преимуществах и достоинствах использования Intlayer в ваших проектах. Поймите, почему Intlayer выделяется среди других фреймворков.
 keywords:
@@ -39,7 +39,6 @@ author: aymericzip
 По сравнению с основными решениями, такими как `next-intl` или `i18next`, Intlayer поставляется со встроенными оптимизациями, такими как:
 
 <AccordionGroup>
-
 <Accordion header="Размер сборки">
 
 Вместо того чтобы загружать огромные JSON-файлы на свои страницы, загружайте только необходимый контент. Intlayer помогает **сократить размер вашей сборки и страниц до 50%**.
@@ -292,3 +291,99 @@ export const ComponentExample = () => {
 Используя `intlayer`, вы можете объявить свой контент в формате вашей любимой библиотеки i18n, и intlayer сгенерирует ваши пространства имен в выбранном вами месте (например: `/messages/{{locale}}/{{namespace}}.json`).
 
 Если вы хотите продолжать использовать API вашей текущей библиотеки i18n, `intlayer` также предоставляет **адаптеры совместимости (compat adapters)**: пакеты, предоставляющие точно такой же API, как `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` и другие, но с содержимым из словарей Intlayer. Это позволяет мигрировать постепенно, не переписывая код. См. [документацию по адаптерам совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+
+## Часто задаваемые вопросы
+
+<FAQ>
+
+<Question title="Какие существуют решения для интернационализации приложения на JavaScript?">
+
+Сосуществуют три поколения:
+
+- **Библиотеки каталогов времени выполнения**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`, `svelte-i18n`. Пространства имён JSON, загружаемые во время выполнения. Зрелые, независимые от фреймворка, нетипизированные и поставляемые на страницу целиком.
+- **Библиотеки сообщений времени компиляции**: `Lingui`, `Paraglide` и `next-intl` или `react-intl` с этапом извлечения. Лучшее поведение бандла и частичная типизация, всё ещё централизованный каталог.
+- **Библиотеки слоя контента**: `Intlayer`. Контент объявляется и компилируется по компонентам, поэтому типизация, tree-shaking, инструменты редактирования и ИИ-перевод - всё берётся из одних объявлений.
+
+</Question>
+
+<Question title="Насколько i18n увеличивает размер моего бандла?">
+
+Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `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/index.md).
+
+</Question>
+
+<Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
+
+Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями 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).
+
+Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
+
+</Question>
+
+<Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
+
+Пять компонентов, все опциональные:
+
+- **[Расширение для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)**: переход от ключа `useIntlayer` к файлу контента, который его объявляет, извлечение контента из компонента и запуск build, fill, test, push и pull из палитры команд или отдельной вкладки Intlayer.
+- **[LSP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**: та же осведомлённость в любом редакторе, который говорит на LSP, с переходом к определению, поиском всех ссылок, предпросмотром переведённого значения при наведении, автодополнением ключей и полей и предупреждением, когда ключ нигде не объявлен. Он также разрешает вызовы `i18next`, `react-i18next`, `next-intl` и `use-intl`, что помогает при миграции.
+- **[MCP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)**: предоставляет документацию и CLI Intlayer для Cursor, VS Code, Claude Desktop, Claude Code и ChatGPT, чтобы ассистент отвечал по актуальной документации, а не гадал, и мог сам запускать команды вроде `intlayer fill`.
+- **[Навыки агентов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**: сфокусированные навыки, такие как `intlayer-config`, `intlayer-cli` и `intlayer-content`, плюс по одному на фреймворк, которые обучают агента вашей настройке маршрутизации и типам узлов контента.
+- **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
+
+</Question>
+
+<Question title="Чем Intlayer отличается от next-intl?">
+
+`next-intl` - это слой сообщений для Next.js: вы держите файлы сообщений JSON для каждой локали и читаете их через `useTranslations`. Intlayer - это слой контента: объявления живут рядом с компонентом, типизируются из самого объявления и компилируются по компонентам, поэтому страница поставляет только то, что отображает. Intlayer также покрывает то, что `next-intl` оставляет вам, а именно ИИ-перевод, визуальный редактор, CMS и проверки недостающих переводов в CI. Если вы хотите сохранить API `next-intl`, [адаптер совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) обслуживает его из словарей Intlayer.
+
+</Question>
+
+<Question title="Чем Intlayer отличается от i18next и react-i18next?">
+
+`i18next` разрешает строковые ключи по пространствам имён во время выполнения, что означает, что переименованный или написанный с опечаткой ключ ломается молча, и каждое пространство имён, которое затрагивает страница, загружается целиком. Intlayer разрешает контент во время сборки по сгенерированным типам, поэтому неверный ключ - это ошибка компиляции, и в бандл попадают только те записи, которые отображает компонент. У `i18next` больше экосистема плагинов и более длинная история; у Intlayer - типизация, размер бандла и инструменты редактирования и автоматизации. См. [руководство по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [адаптер совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md).
+
+</Question>
+
+<Question title="Быстрее или легче ли Intlayer, чем альтернативы?">
+
+Что касается размера бандла и страницы - да: отказ от загрузки каталогов, которые страница не отображает, сокращает размер бандла и страницы до 50% по сравнению с подходами на основе пространств имён. [Бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/index.md) публикует метод и цифры по каждому фреймворку, включая [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/vue.md) и [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/svelte.md), поэтому вы можете воспроизвести их, а не принимать утверждение на веру.
+
+</Question>
+
+<Question title="Стоит ли мигрировать существующее приложение?">
+
+Это зависит от того, что болит сегодня. Если ваша боль - это размер бандла, молчаливо недостающие переводы или переводчики, которые не могут работать без разработчика, миграция окупается. Если ваши каталоги маленькие и стабильные, выигрыш меньше. В любом случае миграция не обязательно должна быть переписыванием: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) сохраняют ваш текущий API, а [плагин синхронизации JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md) сохраняет ваши существующие файлы JSON как источник истины, пока оба слоя сосуществуют.
+
+</Question>
+
+<Question title="Что предлагает Intlayer, чего нет у других библиотек i18n?">
+
+[Контент Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md), [контент, получаемый из внешнего источника](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md), загрузка содержимого файлов, [живые обновления контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md), [визуальный редактор](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), [компилятор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md), который извлекает контент из существующих компонентов, [варианты контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md) для A/B-тестирования, [аналитика](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/analytics.md) по показу контента, [MCP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md), [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md) и [навыки агентов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md).
+
+</Question>
+
+<Question title="Могу ли я использовать Intlayer только как менеджер переводов и сохранить свою текущую библиотеку?">
+
+Да. Intlayer может генерировать ваши пространства имён в формате и месте, которые ожидает ваша текущая библиотека, например `/messages/{locale}/{namespace}.json`, поэтому вы получаете ИИ-перевод, редактор и проверки CI, пока код вашего приложения продолжает использовать существующую библиотеку i18n.
+
+</Question>
+
+<Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
+
+Да, по лицензии Apache 2.0, включая коммерческое использование. Размещённая CMS - это необязательный платный сервис, который также можно [разместить самостоятельно](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/ru/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-07-08
+updatedAt: 2026-08-30
 title: Intlayer CMS | Внешнее управление контентом через Intlayer CMS
 description: Внешнее управление вашим контентом через Intlayer CMS для делегирования управления контентом вашей команде.
 keywords:
@@ -434,3 +434,95 @@ curl -fsSL https://intlayer.org/install.sh | sh
 - Убедитесь, что конфигурация проекта была отправлена в Intlayer CMS.
 
 - Визуальный редактор использует iframe для отображения вашего сайта. Убедитесь, что политика безопасности контента (CSP) вашего сайта разрешает URL CMS в качестве `frame-ancestors` (по умолчанию 'https://app.intlayer.org'). Проверьте консоль редактора на наличие ошибок.
+
+## Часто задаваемые вопросы
+
+<FAQ>
+
+<Question title="В чём разница между Intlayer CMS и визуальным редактором?">
+
+[Визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md) редактирует локальные словари и записывает изменение обратно в вашу кодовую базу, поэтому приложение пересобирается, и изменение проходит через ваш обычный процесс проверки и развёртывания. CMS редактирует удалённые словари: изменение не затрагивает вашу кодовую базу, и работающий сайт подхватывает его без развёртывания. Команды часто используют оба: редактор для контента, которым владеют разработчики, и CMS для контента, который маркетинг меняет еженедельно.
+
+</Question>
+
+<Question title="Насколько i18n увеличивает размер моего бандла?">
+
+Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `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/index.md).
+
+</Question>
+
+<Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
+
+Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями 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).
+
+Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
+
+</Question>
+
+<Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
+
+Пять компонентов, все опциональные:
+
+- **[Расширение для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)**: переход от ключа `useIntlayer` к файлу контента, который его объявляет, извлечение контента из компонента и запуск build, fill, test, push и pull из палитры команд или отдельной вкладки Intlayer.
+- **[LSP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**: та же осведомлённость в любом редакторе, который говорит на LSP, с переходом к определению, поиском всех ссылок, предпросмотром переведённого значения при наведении, автодополнением ключей и полей и предупреждением, когда ключ нигде не объявлен. Он также разрешает вызовы `i18next`, `react-i18next`, `next-intl` и `use-intl`, что помогает при миграции.
+- **[MCP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)**: предоставляет документацию и CLI Intlayer для Cursor, VS Code, Claude Desktop, Claude Code и ChatGPT, чтобы ассистент отвечал по актуальной документации, а не гадал, и мог сам запускать команды вроде `intlayer fill`.
+- **[Навыки агентов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**: сфокусированные навыки, такие как `intlayer-config`, `intlayer-cli` и `intlayer-content`, плюс по одному на фреймворк, которые обучают агента вашей настройке маршрутизации и типам узлов контента.
+- **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
+
+</Question>
+
+<Question title="Какой контент следует перенести в CMS?">
+
+Контент, который часто меняется и не относится к релизу: текст лендинга, формулировки цен, объявления - всё, чем владеет маркетинговая команда. Контент, который является частью интерфейса, например надписи на кнопках и ошибки форм, лучше оставить в локальных словарях, где он проверяется вместе с кодом, который его использует.
+
+</Question>
+
+<Question title="Что происходит, если CMS недоступна?">
+
+Приложение откатывается к локальному объявлению словаря, поэтому сбой сети или простой деградирует до контента, поставленного с вашей сборкой, а не до пустой страницы. Вот почему важно держать локальное объявление для каждого удалённого словаря.
+
+</Question>
+
+<Question title="Могу ли я разместить CMS самостоятельно?">
+
+Да. CMS может работать на вашей собственной инфраструктуре, что является обычным ответом, когда контент не должен покидать вашу сеть. См. [самостоятельный хостинг Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).
+
+</Question>
+
+<Question title="Нужен ли редакторам контента разработчик, чтобы опубликовать изменение?">
+
+Нет. В этом и смысл удалённых словарей: редактор меняет текст в CMS, и сайт это отражает, при этом [живая синхронизация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md) применяет обновление во время выполнения, а не ждёт сборки.
+
+</Question>
+
+<Question title="Могу ли я автоматизировать CMS вместо использования интерфейса?">
+
+Да. SDK `@intlayer/api` предоставляет те же эндпоинты, что и интерфейс, поэтому вы можете получать проекты, читать словари и отправлять обновления из скрипта или конвейера. Раздел выше показывает аутентификатор и эндпоинты.
+
+</Question>
+
+<Question title="Поддерживает ли CMS A/B-тестирование переводов?">
+
+Да. Удалённые словари поддерживают [варианты контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md), а [аналитика](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/analytics.md) сообщает, как каждый вариант показывается, поэтому изменение формулировки можно измерить, а не спорить о нём.
+
+</Question>
+
+<Question title="Бесплатна ли CMS?">
+
+Библиотека Intlayer, CLI, компилятор и визуальный редактор бесплатны и с открытым исходным кодом по лицензии Apache 2.0. Размещённая CMS - это необязательный платный сервис, и его можно [разместить самостоятельно](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/ru/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-08-30
 title: Intlayer визуальный редактор | Изменяйте свой контент, используя визуальный редактор
 description: Узнайте, как использовать редактор Intlayer для управления вашим многоязычным веб-сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить ваш проект за несколько минут.
 keywords:
@@ -210,4 +210,90 @@ pnpm intlayer-editor start -e development
   - Обязательные поля:
     - URL приложения должен совпадать с тем, который вы указали в конфигурации редактора (`applicationURL`).
 
-- Визуальный редактор использует iframe для отображения вашего сайта. Убедитесь, что политика безопасности контента (Content Security Policy, CSP) вашего сайта разрешает URL CMS в качестве `frame-ancestors` (по умолчанию 'http://localhost:8000'). Проверьте консоль редактора на наличие ошибок.
+- Визуальный редактор использует iframe для отображения вашего сайта. Убедитесь, что политика безопасности контента (Content Security Policy, CSP) вашего сайта разрешает URL CMS в качестве `frame-ancestors` (по умолчанию `http://localhost:8000`). Проверьте консоль редактора на наличие ошибок.
+
+## Часто задаваемые вопросы
+
+<FAQ>
+
+<Question title="В чём разница между визуальным редактором и CMS?">
+
+Визуальный редактор редактирует локальные словари и записывает изменение обратно в вашу кодовую базу, поэтому оно проходит через ваш обычный процесс проверки и развёртывания. [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) редактирует удалённые словари, которые меняются на работающем сайте без развёртывания. Редактор подходит для контента, которым владеют разработчики; CMS подходит для контента, которым владеет маркетинговая команда.
+
+</Question>
+
+<Question title="Насколько i18n увеличивает размер моего бандла?">
+
+Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `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/index.md).
+
+</Question>
+
+<Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
+
+Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями 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).
+
+Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
+
+</Question>
+
+<Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
+
+Пять компонентов, все опциональные:
+
+- **[Расширение для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)**: переход от ключа `useIntlayer` к файлу контента, который его объявляет, извлечение контента из компонента и запуск build, fill, test, push и pull из палитры команд или отдельной вкладки Intlayer.
+- **[LSP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**: та же осведомлённость в любом редакторе, который говорит на LSP, с переходом к определению, поиском всех ссылок, предпросмотром переведённого значения при наведении, автодополнением ключей и полей и предупреждением, когда ключ нигде не объявлен. Он также разрешает вызовы `i18next`, `react-i18next`, `next-intl` и `use-intl`, что помогает при миграции.
+- **[MCP-сервер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)**: предоставляет документацию и CLI Intlayer для Cursor, VS Code, Claude Desktop, Claude Code и ChatGPT, чтобы ассистент отвечал по актуальной документации, а не гадал, и мог сам запускать команды вроде `intlayer fill`.
+- **[Навыки агентов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**: сфокусированные навыки, такие как `intlayer-config`, `intlayer-cli` и `intlayer-content`, плюс по одному на фреймворк, которые обучают агента вашей настройке маршрутизации и типам узлов контента.
+- **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
+
+</Question>
+
+<Question title="Где выполняется визуальный редактор?">
+
+На вашей собственной инфраструктуре. Он загружает ваше приложение в iframe и общается с локальным сервером редактора, поэтому ваш контент никогда не покидает вашу среду. Именно это делает его пригодным для проектов, которые не могут отправлять текст в размещённый сервис.
+
+</Question>
+
+<Question title="Нужно ли редакторам уметь программировать?">
+
+Нет. Они открывают сайт, кликают на фрагмент текста и редактируют его на месте. Редактор определяет, какая запись словаря стоит за этим текстом, и записывает изменение в правильный файл контента, поэтому переводчику не нужно искать файл или знать ключ.
+
+</Question>
+
+<Question title="Изменяет ли редактирование через визуальный редактор мои исходные файлы?">
+
+Да, таков замысел. Изменение попадает в файл объявления контента в вашей кодовой базе, поэтому оно отображается как обычный diff, который вы можете просмотреть и закоммитить, и приложение пересобирается, чтобы его показать.
+
+</Question>
+
+<Question title="Редактор показывает пустую страницу или отказывается загружать мой сайт. Что мне проверить?">
+
+Редактор отображает ваше приложение в iframe, поэтому ваша Content Security Policy должна разрешать источник редактора как `frame-ancestors`, что по умолчанию `http://localhost:8000`. Также убедитесь, что `applicationURL` в вашей конфигурации редактора совпадает с URL, с которого ваше приложение действительно обслуживается. Консоль редактора сообщает об обоих сбоях.
+
+</Question>
+
+<Question title="Могу ли я использовать визуальный редактор в продакшене?">
+
+Он предназначен для разработки и staging, где пересборка после правки приемлема. Для редактирования контента на живом сайте без развёртывания используйте вместо этого [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и её удалённые словари.
+
+</Question>
+
+<Question title="Бесплатен ли визуальный редактор?">
+
+Да. Визуальный редактор является частью проекта с открытым исходным кодом, по лицензии 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).
+
+</Question>
+
+</FAQ>