@intlayer/docs 7.5.7 → 7.5.9

package/docs/pt/intlayer_with_tanstack.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-12-11
-title: Como traduzir seu Tanstack Start – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir seu Tanstack Start – guia i18n 2026
 description: Aprenda como adicionar internacionalização (i18n) à sua aplicação Tanstack Start usando Intlayer. Siga este guia completo para tornar seu app multilíngue com roteamento sensível ao locale.
 keywords:
   - Internacionalização
@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-tanstack-start-template
 youtubeVideo: https://www.youtube.com/watch?v=_XTdKVWaeqg
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 7.4.0
     date: 2025-12-11
     changes: Introduz validatePrefix e adiciona o passo 14: Tratamento de páginas 404 com rotas localizadas.
@@ -86,11 +89,25 @@ Instale os pacotes necessários usando seu gerenciador de pacotes preferido:
 ```bash packageManager="npm"
 npm install intlayer react-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
+```
+
+```bash packageManager="yarn"
+yarn add intlayer react-intlayer
+yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/pt/intlayer_with_vite+preact.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Como traduzir seu Vite and Preact – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir seu Vite and Preact – guia i18n 2026
 description: Descubra como tornar seu site Vite e Preact multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
@@ -16,6 +16,9 @@ slugs:
   - vite-and-preact
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-preact-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Histórico inicial
@@ -49,16 +52,25 @@ Instale os pacotes necessários usando npm:
 ```bash packageManager="npm"
 npm install intlayer preact-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer preact-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer preact-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer preact-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -635,10 +647,12 @@ Primeiro, instale o `preact-iso`:
 
 ```bash packageManager="npm"
 npm install preact-iso
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add preact-iso
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
@@ -1461,8 +1475,7 @@ import { useLocale, useLocation, route } from "preact-intlayer"; // Assumindo qu
 import type { JSX } from "preact"; // Para HTMLAttributes
 import { forwardRef } from "preact/compat"; // Para encaminhar refs
 
-export interface LocalizedLinkProps
-  extends JSX.HTMLAttributes<HTMLAnchorElement> {
+export interface LocalizedLinkProps extends JSX.HTMLAttributes<HTMLAnchorElement> {
   href: string;
   replace?: boolean; // Opcional: para substituir o estado do histórico
 }

package/docs/pt/intlayer_with_vite+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2025-12-10
-title: Como traduzir sua aplicação Vite e React – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir sua aplicação Vite e React – guia i18n 2026
 description: Aprenda como adicionar internacionalização (i18n) à sua aplicação Vite e React usando Intlayer. Siga este guia para tornar seu app multilíngue.
 keywords:
   - Internacionalização
@@ -18,6 +18,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Histórico inicial
@@ -72,16 +75,25 @@ Instale os pacotes necessários usando npm:
 ```bash packageManager="npm"
 npm install intlayer react-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/pt/intlayer_with_vite+solid.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Como traduzir seu Vite and Solid – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir seu Vite and Solid – guia i18n 2026
 description: Descubra como tornar seu site Vite e Solid multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
@@ -16,6 +16,9 @@ slugs:
   - vite-and-solid
 # applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Histórico inicial
@@ -49,16 +52,25 @@ Instale os pacotes necessários usando npm:
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer solid-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/pt/intlayer_with_vite+svelte.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-11-19
-title: Como traduzir sua aplicação Vite e Svelte – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir sua aplicação Vite e Svelte – guia i18n 2026
 description: Descubra como tornar seu site Vite e Svelte multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
@@ -16,6 +16,9 @@ slugs:
   - vite-and-svelte
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 5.5.11
     date: 2025-11-19
     changes: Atualização da documentação
@@ -62,21 +65,25 @@ Instale os pacotes necessários usando npm:
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer svelte-intlayer
 bun add vite-intlayer --save-dev
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -302,14 +309,17 @@ Primeiro, instale o `svelte-spa-router`:
 
 ```bash packageManager="npm"
 npm install svelte-spa-router
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add svelte-spa-router
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add svelte-spa-router
+yarn intlayer init
 ```
 
 ```bash packageManager="bun"

package/docs/pt/intlayer_with_vite+vue.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Como traduzir seu Vite and Vue – guia i18n 2025
+updatedAt: 2025-12-30
+title: Como traduzir seu Vite and Vue – guia i18n 2026
 description: Descubra como tornar seu site Vite e Vue multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
@@ -15,6 +15,9 @@ slugs:
   - environment
   - vite-and-vue
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Adicionar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Histórico inicial
@@ -67,16 +70,25 @@ Instale os pacotes necessários usando npm:
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer vue-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -581,10 +593,12 @@ Primeiro, instale o Vue Router:
 
 ```bash packageManager="npm"
 npm install vue-router
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add vue-router
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"

package/docs/ru/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2025-12-30
 title: CLI
 description: Узнайте, как использовать Intlayer CLI для управления вашим многоязычным сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить ваш проект за несколько минут.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавлена команда init
   - version: 7.2.3
     date: 2025-11-22
     changes: Добавлена команда transform
@@ -78,6 +81,10 @@ yarn add intlayer-cli -g
 pnpm add intlayer-cli -g
 ```
 
+```bash packageManager="bun"
+bun add intlayer-cli -g
+```
+
 > Если пакет `intlayer` уже установлен, CLI устанавливается автоматически. Вы можете пропустить этот шаг.
 
 ## Пакет intlayer-cli
@@ -127,6 +134,7 @@ Intlayer поддерживает несколько форматов конфи
 
 ### Конфигурация
 
+- **[Инициализация Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/init.md)** - Настройка Intlayer в вашем проекте с автоматической конфигурацией
 - **[Управление конфигурацией](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/configuration.md)** - Получение и отправка вашей конфигурации Intlayer в CMS
 
 ### Управление документацией
@@ -148,6 +156,7 @@ Intlayer поддерживает несколько форматов конфи
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:init": "npx intlayer init",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/ru/cli/init.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Инициализация Intlayer
+description: Узнайте, как инициализировать Intlayer в вашем проекте.
+keywords:
+  - Инициализация
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавлена команда init
+---
+
+# Инициализация Intlayer
+
+```bash
+npx intlayer init
+```
+
+Команда `init` автоматически настраивает Intlayer в вашем проекте, конфигурируя необходимые файлы и параметры. Это рекомендуемый способ начать работу с Intlayer.
+
+## Псевдонимы:
+
+- `npx intlayer init`
+
+## Аргументы:
+
+- `--project-root [projectRoot]` - Необязательно. Укажите корневую директорию проекта. Если не указано, команда будет искать корень проекта, начиная с текущей рабочей директории.
+
+## Что делает:
+
+Команда `init` выполняет следующие задачи настройки:
+
+1. **Проверяет структуру проекта** - Убедится, что вы находитесь в валидной директории проекта с файлом `package.json`
+2. **Обновляет `.gitignore`** - Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий
+3. **Настраивает TypeScript** - Обновляет все файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`)
+4. **Создаёт файл конфигурации** - Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию
+5. **Обновляет конфигурацию Vite** - Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`
+
+Команда `init` выполняет следующие действия по настройке:
+
+1. **Проверяет структуру проекта** — Убеждается, что вы находитесь в корректной директории проекта с файлом `package.json`
+2. **Обновляет `.gitignore`** — Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий
+3. **Настраивает TypeScript** — Обновляет все файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`)
+4. **Создаёт файл конфигурации** — Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию
+5. **Обновляет конфигурацию Vite** — Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`
+6. **Обновляет конфигурацию Next.js** - Если обнаружен файл конфигурации Next.js, добавляет импорт плагина `next-intlayer`
+
+## Примеры:
+
+### Базовая инициализация:
+
+```bash
+npx intlayer init
+```
+
+Это инициализирует Intlayer в текущей директории, автоматически обнаруживая корень проекта.
+
+### Инициализация с указанием корня проекта:
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+Это инициализирует Intlayer в указанной директории.
+
+## Пример вывода:
+
+```bash
+npx intlayer init
+Проверка конфигурации Intlayer...
+✓ Добавлено .intlayer в .gitignore
+✓ Обновлён tsconfig.json для включения типов intlayer
+Создан intlayer.config.ts
+✓ Внедрён импорт в vite.config.ts
+✓ Настройка Intlayer init завершена.
+```
+
+## Примечания:
+
+- Команда идемпотентна — вы можете запускать её несколько раз безопасно. Она пропустит шаги, которые уже настроены.
+- Если файл конфигурации уже существует, он не будет перезаписан.
+- Файлы конфигурации TypeScript без массива `include` (например, конфигурации в стиле solution с ссылками) пропускаются.
+- Команда завершится с ошибкой, если в корне проекта не найден `package.json`.

package/docs/ru/cli/sdk.md

@@ -31,6 +31,10 @@ yarn add @intlayer/cli --save-dev
 pnpm add @intlayer/cli --save-dev
 ```
 
+```bash packageManager="bun"
+bun add @intlayer/cli --dev
+```
+
 Пример использования:
 
 ```ts

package/docs/ru/intlayer_visual_editor.md

@@ -80,6 +80,10 @@ yarn add intlayer-editor --save-dev
 pnpm add intlayer-editor --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer-editor --dev
+```
+
 ## Конфигурация
 
 В вашем файле конфигурации Intlayer вы можете настроить параметры редактора:

package/docs/ru/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Как перевести ваше Angular – руководство i18n 2025
+updatedAt: 2025-12-30
+title: Как перевести ваше Angular – руководство i18n 2026
 description: Узнайте, как сделать ваш сайт на Angular многоязычным. Следуйте документации для интернационализации (i18n) и перевода.
 keywords:
   - Интернационализация
@@ -15,6 +15,9 @@ slugs:
   - angular
 # applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавить команду init
   - version: 5.5.10
     date: 2025-06-29
     changes: Инициализация истории
@@ -47,14 +50,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer @intlayer/webpack
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer @intlayer/webpack
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer @intlayer/webpack
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer angular-intlayer @intlayer/webpack
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/ru/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2025-10-03
-title: Как перевести ваше Astro – руководство i18n 2025
+updatedAt: 2025-12-30
+title: Как перевести ваше Astro – руководство i18n 2026
 description: Узнайте, как добавить интернационализацию (i18n) на ваш сайт Astro с помощью Intlayer. Следуйте этому руководству, чтобы сделать ваш сайт многоязычным.
 keywords:
   - Интернационализация
@@ -17,6 +17,9 @@ slugs:
   - astro
 applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавить команду init
   - version: 6.2.0
     date: 2025-10-03
     changes: Обновление для интеграции с Astro, конфигурация, использование

package/docs/ru/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
-title: Как перевести ваше Create React App – руководство i18n 2025
+updatedAt: 2025-12-30
+title: Как перевести ваше Create React App – руководство i18n 2026
 description: Узнайте, как сделать ваш сайт Create React App (CRA) многоязычным. Следуйте документации для интернационализации (i18n) и перевода.
 keywords:
   - Интернационализация
@@ -17,6 +17,9 @@ slugs:
   - create-react-app
 applicationTemplate: https://github.com/aymericzip/intlayer-react-cra-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавить команду init
   - version: 5.5.10
     date: 2025-06-29
     changes: Инициализация истории
@@ -45,14 +48,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer react-scripts-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer react-scripts-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer react-scripts-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer react-scripts-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/ru/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Как перевести ваше Express backend – руководство i18n 2025
+updatedAt: 2025-12-30
+title: Как перевести ваше Express backend – руководство i18n 2026
 description: Узнайте, как сделать ваш backend Express многоязычным. Следуйте документации для интернационализации (i18n) и перевода.
 keywords:
   - Интернационализация
@@ -15,6 +15,9 @@ slugs:
   - environment
   - express
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавить команду init
   - version: 5.5.10
     date: 2025-06-29
     changes: Инициализация истории
@@ -49,14 +52,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### Настройка

package/docs/ru/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
-updatedAt: 2025-06-29
-title: Как перевести ваше Lynx and React mobile app – руководство i18n 2025
+updatedAt: 2025-12-30
+title: Как перевести ваше Lynx and React mobile app – руководство i18n 2026
 description: Узнайте, как сделать ваше мобильное приложение Lynx и React многоязычным. Следуйте документации для интернационализации (i18n) и перевода.
 keywords:
   - интернационализация
@@ -17,6 +17,9 @@ slugs:
   - lynx-and-react
 applicationTemplate: https://github.com/aymericzip/intlayer-lynx-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Добавить команду init
   - version: 5.5.10
     date: 2025-06-29
     changes: Инициализация истории
@@ -45,14 +48,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer lynx-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer lynx-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer lynx-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer lynx-intlayer
+bunx intlayer init
 ```
 
 ### Пакеты