@intlayer/docs 9.4.3 → 9.5.0

package/docs/ru/intlayer_with_vite+vue.md

@@ -46,37 +46,31 @@ author: aymericzip
 Intlayer оптимизирован для идеальной работы с Vue, предлагая **охват контента на уровне компонентов**, **реактивные переводы** и все функции, необходимые для масштабирования интернационализации (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)**, чтобы помочь вам управлять многоязычным контентом в **реальном времени**, упрощая сотрудничество с переводчиками, копирайтерами и другими членами команды. Контент может храниться локально и/или удаленно.
@@ -84,8 +78,6 @@ Intlayer — это больше, чем просто решение i18n. Он
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Пошаговое руководство по настройке Intlayer в приложении на Vite и Vue
 
 <Tabs defaultTab="video">
@@ -121,7 +113,6 @@ Intlayer — это больше, чем просто решение i18n. Он
 Смотрите [Шаблон приложения](https://github.com/aymericzip/intlayer-vite-vue-template) на GitHub.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите необходимые пакеты с помощью npm:
@@ -177,9 +168,33 @@ bun add vite-intlayer --dev
   Включает плагин Vite для интеграции Intlayer с [сборщиком Vite](https://vite.dev/guide/why.html#why-bundle-for-production), а также промежуточное ПО для определения предпочтительной локали пользователя, управления cookie и обработки перенаправления URL.
 
 </Step>
-
 <Step number={2} title="Конфигурация вашего проекта">
 
+### Архитектура
+
+В этой архитектуре `vue-intlayer` предоставляет плагин, установленный в `main.ts`. Компоненты Vue объявляют и используют переводы локально с помощью composables, а горячая перезагрузка Vite обрабатывается через `vite-intlayer`.
+
+```bash
+.
+├── src
+│   ├── app.content.ts
+│   ├── App.vue                       # Root component
+│   ├── components
+│   │   ├── helloWorld
+│   │   │   ├── helloWorld.content.ts
+│   │   │   └── HelloWorld.vue
+│   │   └── LocaleSwitcher.vue
+│   ├── main.ts                       # Entry point installing vue-intlayer plugin
+│   └── style.css
+├── index.html
+├── intlayer.config.ts
+├── package.json
+├── tsconfig.json
+└── vite.config.ts
+```
+
+### Конфигурация
+
 Создайте файл конфигурации для настройки языков вашего приложения:
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
@@ -203,7 +218,6 @@ export default config;
 > С помощью этого файла конфигурации вы можете настроить локализованные URL, перенаправление через middleware, имена cookie, расположение и расширение ваших деклараций контента, отключить логи Intlayer в консоли и многое другое. Для полного списка доступных параметров обратитесь к [документации по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 </Step>
-
 <Step number={3} title="Интеграция Intlayer в вашу конфигурацию Vite">
 
 Добавьте плагин intlayer в вашу конфигурацию.
@@ -222,7 +236,6 @@ export default defineConfig({
 > Плагин Vite `intlayer()` используется для интеграции Intlayer с Vite. Он обеспечивает создание файлов деклараций контента и отслеживает их в режиме разработки. Он определяет переменные окружения Intlayer внутри приложения Vite. Кроме того, он предоставляет алиасы для оптимизации производительности.
 
 </Step>
-
 <Step number={4} title="Объявите Ваш Контент">
 
 Создайте и управляйте декларациями контента для хранения переводов:
@@ -346,7 +359,6 @@ export default helloWorldContent;
 > Для получения дополнительной информации обратитесь к [документации по объявлениям контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
 
 </Step>
-
 <Step number={5} title="Использование Intlayer в вашем коде">
 
 Чтобы использовать функции интернационализации Intlayer во всём вашем приложении на Vue, сначала необходимо зарегистрировать синглтон-экземпляр Intlayer в вашем основном файле. Этот шаг важен, так как он предоставляет контекст интернационализации для всех компонентов вашего приложения, делая переводы доступными в любом месте дерева компонентов.
@@ -442,7 +454,6 @@ Intlayer предлагает различные API для доступа к в
   - Или используйте `const { myContent } = useIntlayer("myContent");` и `{{ myContent }}` / `<myContent/>` для деструктуризации содержимого.
 
 </Step>
-
 <Step number={6} title="Изменение языка вашего содержимого" isOptional={true}>
 
 Для изменения языка вашего содержимого вы можете использовать функцию `setLocale`, предоставляемую композицией `useLocale`. Эта функция позволяет установить локаль приложения и обновить содержимое соответственно.
@@ -511,7 +522,6 @@ const content = useIntlayer("app"); // Создайте связанный фа
 ```
 
 </Step>
-
 <Step number={7} title="Добавьте локализованную маршрутизацию в ваше приложение" isOptional={true}>
 
 Добавление локализованной маршрутизации в приложение Vue обычно включает использование Vue Router с префиксами локали. Это создает уникальные маршруты для каждого языка, что полезно для SEO и удобных для SEO URL.
@@ -653,7 +663,6 @@ export default defineConfig({
 ```
 
 </Step>
-
 <Step number={8} title="Изменение URL при смене локали" isOptional={true}>
 
 Чтобы автоматически обновлять URL при смене языка пользователем, вы можете изменить компонент `LocaleSwitcher`, чтобы использовать Vue Router:
@@ -745,7 +754,6 @@ watch(
 ```
 
 </Step>
-
 <Step number={9} title="Переключение атрибутов языка и направления в HTML" isOptional={true}>
 
 Когда ваше приложение поддерживает несколько языков, крайне важно обновлять атрибуты `lang` и `dir` тега `<html>`, чтобы они соответствовали текущей локали. Это обеспечивает:
@@ -807,7 +815,6 @@ useI18nHTMLAttributes();
 ```
 
 </Step>
-
 <Step number={10} title="Создание локализованного компонента Link" isOptional={true}>
 
 Чтобы обеспечить навигацию вашего приложения с учётом текущей локали, вы можете создать пользовательский компонент `Link`. Этот компонент автоматически добавляет префикс текущего языка к внутренним URL, например, когда франкоязычный пользователь нажимает на ссылку на страницу "О нас", его перенаправляет на `/fr/about` вместо `/about`.
@@ -908,7 +915,6 @@ import RouterLink from "@components/RouterLink.vue";
 ```
 
 </Step>
-
 <Step number={1} title="Извлечение содержимого ваших компонентов" isOptional={true}>
 
 Если у вас есть существующая кодовая база, преобразование тысяч файлов может занять много времени.
@@ -1130,14 +1136,10 @@ Intlayer использует расширение модулей (module augmen
 
 Для получения более подробной информации о том, как использовать расширение, обратитесь к [документации Intlayer VS Code Extension](https://intlayer.org/ru/doc/vs-code-extension).
 
----
-
 ### Продвинутые возможности
 
 Для расширения возможностей вы можете реализовать [визуальный редактор](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).
 
----
-
 ## Часто задаваемые вопросы
 
 <FAQ>
@@ -1150,25 +1152,21 @@ Intlayer использует расширение модулей (module augmen
 Практическая разница - в области охвата и типизации. `vue-i18n` разрешает ключи как строки во время выполнения, поэтому переименованный ключ ломается молча, тогда как Intlayer генерирует типы из ваших объявлений и отбрасывает контент, который не использует ни один компонент. См. [почему Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/interest_of_intlayer.md) и [бенчмарк i18n для Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/vue.md).
 
 </Question>
-
 <Question title="Насколько i18n увеличивает размер бандла моего Vue?">
 
 Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Компилятор во время сборки заменяет вызовы `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/vue.md).
 
 </Question>
-
 <Question title="Могу ли я мигрировать с `vue-i18n`, не переписывая свои компоненты?">
 
 Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с vue-i18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_vue-i18n_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `vue-i18n`, но обслуживаемый словарями 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 вместо копирования строк в каталог по одной. Шаг 11 этого руководства проводит вас через это.
@@ -1178,7 +1176,6 @@ Intlayer использует расширение модулей (module augmen
 Стоит знать о двух ограничениях, прежде чем включать компилятор. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, такие как коды ошибок API или поля CMS, остаются недоступными. И ему нужно отличать текст, видимый пользователю, от логики приложения вроде `className="active"` или кода статуса, что требует нескольких аннотаций в большой кодовой базе. [Команда extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md) избегает обоих ограничений, оставляя вас в процессе.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -1190,43 +1187,36 @@ Intlayer использует расширение модулей (module augmen
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Работает ли Intlayer с Vue Composition API и script setup?">
 
 Да. `useIntlayer` - это composable, используемый внутри `<script setup>`, как любой другой, и возвращаемый контент реактивен, поэтому смена локали перерисовывает компоненты, которые его читают, без перезагрузки страницы.
 
 </Question>
-
 <Question title="Как настроить локализованную маршрутизацию в SPA на Vue?">
 
 Шаги 7 и 8 этого руководства охватывают интеграцию с Vue Router: сегмент локали в дереве маршрутов и watcher, который переписывает URL при смене локали. Если вы не хотите локаль в пути, установите `routing.mode` в `"no-prefix"` или `"search-params"`, и она будет разрешаться из cookie или параметра запроса. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 </Question>
-
 <Question title="Как установить атрибуты lang и dir у html для языков с письмом справа налево?">
 
 Шаг 9 охватывает это. `getHTMLTextDir` возвращает `rtl` для языков, таких как арабский, иврит, персидский и урду, поэтому вы можете привязать `lang` и `dir` на корневом элементе из активной локали и позволить логическим свойствам CSS делать остальное.
 
 </Question>
-
 <Question title="Как автоматически перевести приложение Vue с помощью ИИ?">
 
 Запустите `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).

package/docs/ru/introduction.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-06
 title: Введение
 description: Узнайте, как работает Intlayer. Ознакомьтесь с этапами, которые использует Intlayer в вашем приложении. Узнайте, для чего предназначены различные пакеты.
 keywords:
@@ -98,31 +98,26 @@ export const MyComponent: FC = () => {
 Вместо того чтобы загружать массивные JSON-файлы на свои страницы, загружайте только необходимый контент. Intlayer помогает **сократить размер ваших сборок и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Простота обслуживания (Maintainability)">
 
 Локализация контента рядом с компонентами вашего приложения **облегчает обслуживание** крупномасштабных приложений. Вы можете дублировать или удалить папку отдельной функции без необходимости проверять всю кодовую базу контента. Кроме того, Intlayer является **полностью типизированным (fully typed)**, чтобы гарантировать точность вашего контента.
 
 </Accordion>
-
 <Accordion header="AI Agent (ИИ Агенты)">
 
 Совместное размещение контента **сокращает контекст, необходимый** для больших языковых моделей (LLMs). Intlayer также поставляется с набором инструментов, таких как **CLI** для проверки отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация (Automation)">
 
 Используйте автоматизацию для перевода в вашем CI/CD конвейере с помощью выбранной вами LLM по стоимости вашего провайдера ИИ. Intlayer также предлагает **компилятор (compiler)** для автоматизации извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md), чтобы помочь **переводить в фоновом режиме**.
 
 </Accordion>
-
 <Accordion header="Производительность (Performance)">
 
 Подключение массивных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку вашего контента во время сборки (build time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость без участия разработчиков (Scaling with non-dev)">
 
 Intlayer — это больше, чем просто i18n-решение. Он предоставляет **[визуальный редактор (visual editor)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)**, который можно развернуть самостоятельно (self-hosted), и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять вашим многоязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться локально и/или удаленно.
@@ -180,21 +175,45 @@ 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 с Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_tanstack.md)**
+- **[Intlayer с Tanstack Start + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_tanstack+solid.md)**
 - **[Intlayer с Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)**
 - **[Intlayer с React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react_router_v7.md)**
-- **[Intlayer с Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_tanstack.md)**
+- **[Intlayer с React Router v7 (fs-routes)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react_router_v7_fs_routes.md)**
+- **[Intlayer с React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_create_react_app.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 с Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+preact.md)**
+- **[Intlayer с Astro](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro.md)**
+- **[Intlayer с Astro + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_react.md)**
+- **[Intlayer с Astro + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_vue.md)**
+- **[Intlayer с Astro + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_svelte.md)**
+- **[Intlayer с Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_solid.md)**
+- **[Intlayer с Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_preact.md)**
+- **[Intlayer с Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_lit.md)**
+- **[Intlayer с Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_astro_vanilla.md)**
 - **[Intlayer с Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+vue.md)**
 - **[Intlayer с Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nuxt.md)**
 - **[Intlayer с Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+svelte.md)**
 - **[Intlayer с SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_svelte_kit.md)**
+- **[Intlayer с Vite + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+solid.md)**
+- **[Intlayer с SolidStart](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_solid_start.md)**
+- **[Intlayer с Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+preact.md)**
+- **[Intlayer с Angular 22](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_angular_21.md)**
+- **[Intlayer с Angular 19](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_angular_19.md)**
+- **[Intlayer с Analog](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_analog.md)**
+- **[Intlayer с Vite + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+lit.md)**
+- **[Intlayer с Vite + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+vanilla.md)**
+- **[Intlayer с Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vanilla.md)**
+- **[Intlayer с htmx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_htmx.md)**
 - **[Intlayer с Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_express.md)**
 - **[Intlayer с NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nestjs.md)**
+- **[Intlayer с Fastify](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_fastify.md)**
 - **[Intlayer с Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_hono.md)**
-- **[Intlayer с Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_angular_21.md)**
+- **[Intlayer с AdonisJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_adonisjs.md)**
+- **[Intlayer с Elysia](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_elysia.md)**
+- **[Intlayer с Storybook](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_storybook.md)**
+- **[Intlayer с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-intl.md)**
+- **[Intlayer с next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-i18next.md)**
 
 Каждое руководство по интеграции содержит лучшие практики использования функций Intlayer, такие как **рендеринг на стороне сервера (SSR)**, **динамическая маршрутизация** или **рендеринг на стороне клиента**, чтобы вы могли поддерживать быстрое, SEO-оптимизированное и высокомасштабируемое приложение.
 
@@ -213,25 +232,21 @@ Intlayer предлагает множество функций, адаптир
 Intlayer - это библиотека интернационализации (i18n) для приложений на JavaScript и TypeScript. Вы объявляете контент компонента рядом с этим компонентом в файле `.content.ts`, Intlayer компилирует эти объявления в типизированные словари во время сборки, а ваши компоненты читают их через хук вроде `useIntlayer`. Она покрывает перевод, правила множественного числа, род, Markdown, маршрутизацию с учётом локали, SEO-метаданные, перевод с помощью ИИ и визуальный редактор для не-разработчиков.
 
 </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).
@@ -239,7 +254,6 @@ Intlayer - это библиотека интернационализации (i
 Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -251,7 +265,6 @@ Intlayer - это библиотека интернационализации (i
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Какие существуют решения для интернационализации приложения на JavaScript?">
 
 Область делится на три поколения:
@@ -263,43 +276,36 @@ Intlayer - это библиотека интернационализации (i
 См. [почему Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/interest_of_intlayer.md) для подробного сравнения и [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/index.md) для измеренных цифр по бандлу и производительности.
 
 </Question>
-
 <Question title="Какие фреймворки поддерживает Intlayer?">
 
 React, Next.js, Vite, TanStack Start, React Router, Vue, Nuxt, Svelte, SvelteKit, Angular, Solid, Preact, Lit, Astro с каждым островным фреймворком, React Native с Expo, Lynx, а на сервере - Express, Fastify, NestJS, Hono, Elysia и AdonisJS. У каждого есть собственное руководство в разделе [окружения](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/introduction.md).
 
 </Question>
-
 <Question title="Почему контент объявляется рядом с компонентом, а не в центральном файле JSON?">
 
 Три причины. Страница поставляет только те записи, которые отображают её компоненты, вместо целого пространства имён, что и сокращает размер бандла. Папку функции можно скопировать или удалить целиком, не выискивая в общем каталоге осиротевшие ключи. И LLM или агент, редактирующий компонент, видит его контент в той же папке, поэтому со-размещение делает работу с помощью ИИ надёжной. См. [как работает Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/how_works_intlayer.md).
 
 </Question>
-
 <Question title="Как автоматически перевести моё приложение с помощью ИИ?">
 
 Запустите `npx intlayer fill`. CLI обнаруживает недостающие переводы и заполняет их с помощью выбранной вами LLM, используя ваш собственный провайдер и API-ключ, поэтому вы платите ИИ-провайдеру напрямую. `--git-diff` ограничивает запуск контентом, изменённым в ветке, что делает его дешёвым в CI. См. [команду 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="Как найти недостающие переводы?">
 
 Запустите `npx intlayer test`. Она проваливается, когда объявленной локали не хватает контента, поэтому непереведённая строка никогда не попадёт в продакшен. [Расширение для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md) показывает те же ошибки inline, а [плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md) помечает жёстко закодированные строки своим правилом `no-raw-text`. См. [тестирование вашего контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/testing.md).
 
 </Question>
-
 <Question title="Нужно ли мне помещать локаль в URL?">
 
 Нет. `routing.mode` принимает `"prefix-no-default"` (по умолчанию, `/about` и `/fr/about`), `"prefix-all"`, `"no-prefix"` и `"search-params"`, а `routing.domains` сопоставляет каждую локаль с её собственным доменом. Какой бы ни была схема, `getMultilingualUrls` строит альтернативы `hreflang` для ваших метаданных и карты сайта. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.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) выносит контент вовне, чтобы он мог меняться без развёртывания, при этом [живая синхронизация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md) применяет обновления во время выполнения.
 
 </Question>
-
 <Question title="Является ли Intlayer бесплатным и с открытым исходным кодом?">
 
 Да. Intlayer имеет открытый исходный код по лицензии Apache 2.0, и библиотека, CLI, компилятор и визуальный редактор бесплатны в использовании, включая коммерческие проекты. Размещённая CMS - это необязательный платный сервис, и его также можно [разместить самостоятельно](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).

package/docs/ru/live-sync.md

@@ -38,8 +38,6 @@ author: aymericzip
 
 <TOC/>
 
----
-
 ## Включение Live Sync
 
 Включите живую синхронизацию, обновив конфигурацию Intlayer:

package/docs/ru/lsp.md

@@ -31,8 +31,6 @@ author: aymericzip
 
 **Языковой сервер Intlayer** — это реализация [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/), которая делает вашу IDE — и вашего ИИ-агента — осведомлёнными об Intlayer. Он связывает вызов вида `useIntlayer("home")` с файлом `.content.ts`, который его объявляет, в обоих направлениях.
 
----
-
 ## Возможности
 
 | Возможность               | Сочетание клавиш    | Что делает                                                                                              |
@@ -65,8 +63,6 @@ author: aymericzip
 
 > Словари читаются из результата сборки, поэтому выполните `npx intlayer build` — или держите dev-сервер запущенным — чтобы серверу было что разрешать.
 
----
-
 ## Установка
 
 Сервер поставляется как бинарный файл `intlayer-lsp` в составе `@intlayer/lsp`:
@@ -89,8 +85,6 @@ bun add --dev @intlayer/lsp
 
 Установите его глобально (`npm install -g @intlayer/lsp`), если вашему редактору нужен `intlayer-lsp` в `PATH` — это относится к плагину Claude Code и к любой конфигурации ниже, которая вызывает бинарный файл напрямую.
 
----
-
 ## Настройка
 
 <Tabs defaultTab="vscode">
@@ -255,16 +249,12 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
   </Tab>
 </Tabs>
 
----
-
 ## Примечание об ИИ-агентах в терминале
 
 **Claude Code** работает как полноценный LSP-клиент — см. вкладку выше.
 
 **OpenAI Codex** и большинство других терминальных инструментов не являются LSP-клиентами: они читают и пишут файлы напрямую. Запуск сервера сам по себе им не поможет; польза появляется, когда он активен в сопутствующем редакторе, чей индекс агент может запрашивать (Cursor Composer, Windsurf Cascade, Copilot Chat).
 
----
-
 ## Как это работает
 
 Для каждого файла сервер находит ближайший `intlayer.config.*` и загружает конфигурацию этого проекта, чтобы найти скомпилированные словари. Конфигурация, словари и список исходных файлов кешируются с коротким TTL и сбрасываются при изменении отслеживаемого файла контента.
@@ -275,8 +265,6 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
 2. **На использовании поля** (`content.title`, деструктурированное свойство, `t('path.to.field')`, `<Trans>`, …) → возводит переменную обратно к её словарю и возвращает соответствующее поле внутри файлов контента.
 3. **Из файла контента** → выполняет обратный поиск, просматривая исходники проекта в поисках мест вызова этого ключа или поля.
 
----
-
 ## Устранение неполадок
 
 | Симптом                                      | Вероятная причина                 | Решение                                                                      |

package/docs/ru/mcp_server.md

@@ -76,8 +76,6 @@ MCP сервер также можно использовать удалённо
 
 > Из-за затрат на хостинг сервера доступность удалённого сервера не гарантируется. Мы ограничиваем количество одновременных подключений. Рекомендуем использовать локальный сервер (stdio) для наиболее стабильной работы.
 
----
-
 ## Настройка через Intlayer CLI (рекомендуется)
 
 Intlayer предоставляет команду CLI для автоматической настройки MCP-сервера в вашем проекте.
@@ -104,8 +102,6 @@ bun x intlayer init mcp
 2. Спросит, какой метод транспортировки вы хотите использовать (локальный сервер (stdio) или удаленный сервер (Streamable HTTP)).
 3. Автоматически обновит ваш файл конфигурации (например, `.cursor/mcp.json`, `.vscode/mcp.json` или глобальную конфигурацию Claude Desktop).
 
----
-
 ## Setup via Intlayer VS Code extension
 
 1. Откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P).
@@ -114,8 +110,6 @@ bun x intlayer init mcp
 4. Выберите MCP для установки (stdio, Streamable HTTP)
 5. Нажмите Enter.
 
----
-
 ## Настройка вручную
 
 <Tabs defaultTab="cursor">
@@ -283,8 +277,6 @@ claude mcp add intlayer https://mcp.intlayer.org -t http
   </Tab>
 </Tabs>
 
----
-
 ## Использование MCP Server через CLI
 
 Вы также можете запустить сервер Intlayer MCP напрямую из командной строки для тестирования, отладки или интеграции с другими инструментами.