@intlayer/docs 7.5.10 → 7.5.12

package/docs/pt/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // obrigatório
   location?: string, // rótulo opcional, padrão: "plugin"
   priority?: number, // prioridade opcional para resolução de conflitos, padrão: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // formatador opcional, padrão: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // formatador opcional, usado para compatibilidade com o runtime Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Especifica o formatador a ser usado para o conteúdo do dicionário ao sincronizar arquivos JSON. Isso permite usar diferentes sintaxes de formatação de mensagens compatíveis com várias bibliotecas i18n.
+Especifica o formatador a ser usado para o conteúdo do dicionário ao sincronizar arquivos JSON. Isso permite usar diferentes sintaxes de formatação de mensagens compatíveis com o runtime Intlayer.
 
+- `undefined`: Nenhum formatador será usado, o conteúdo JSON será usado como está.
 - `'intlayer'`: O formatador Intlayer padrão (padrão).
 - `'icu'`: Usa formatação de mensagens ICU (compatível com bibliotecas como react-intl, vue-i18n).
 - `'i18next'`: Usa formatação de mensagens i18next (compatível com i18next, next-i18next, Solid-i18next).
 
+> Note que usar um formatador transformará seu conteúdo JSON na entrada e saída. Para regras JSON complexas como plurais ICU, o parsing pode não garantir um mapeamento 1 para 1 entre entrada e saída.
+> Se você não usar o runtime Intlayer, pode preferir não definir um formatador.
+
 **Exemplo:**
 
 ```ts

package/docs/ru/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Команда CI
+description: Узнайте, как использовать команду Intlayer CI для запуска команд Intlayer с автоматически внедренными учетными данными в CI/CD конвейерах и монорепозиториях.
+keywords:
+  - CI
+  - CI/CD
+  - Автоматизация
+  - Монорепозиторий
+  - Учетные данные
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Добавить команду CI
+---
+
+# Команда CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+Команда CI предназначена для автоматизации и CI/CD конвейеров. Она автоматически внедряет учетные данные из переменной окружения `INTLAYER_PROJECT_CREDENTIALS` и может запускать команды Intlayer для нескольких проектов в монорепозитории.
+
+## Как это работает
+
+Команда CI работает в двух режимах:
+
+1. **Режим одного проекта**: Если текущий рабочий каталог соответствует одному из путей проектов в `INTLAYER_PROJECT_CREDENTIALS`, она запускает команду только для этого конкретного проекта.
+
+2. **Режим итерации**: Если не обнаружен конкретный контекст проекта, она перебирает все настроенные проекты и запускает команду для каждого из них.
+
+## Переменная окружения
+
+Команда требует установки переменной окружения `INTLAYER_PROJECT_CREDENTIALS`. Эта переменная должна содержать JSON-объект, сопоставляющий пути проектов с их учетными данными:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Определение менеджера пакетов
+
+Команда CI автоматически определяет, какой менеджер пакетов используется (npm, yarn, pnpm или bun), на основе переменной окружения `npm_config_user_agent` и использует соответствующую команду для выполнения Intlayer.
+
+## Аргументы
+
+- **`<command...>`**: Команда Intlayer для выполнения (например, `fill`, `push`, `build`). Вы можете передать любую команду Intlayer и ее аргументы.
+
+  > Пример: `npx intlayer ci fill --verbose`
+  >
+  > Пример: `npx intlayer ci push`
+  >
+  > Пример: `npx intlayer ci build`
+
+## Примеры
+
+### Запуск команды в режиме одного проекта
+
+Если вы находитесь в каталоге проекта, который соответствует одному из путей в `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Это запустит команду `fill` с автоматически внедренными учетными данными для проекта `packages/app`.
+
+### Запуск команды для всех проектов
+
+Если вы находитесь в каталоге, который не соответствует ни одному пути проекта, команда переберет все настроенные проекты:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Это запустит команду `push` для каждого проекта, настроенного в `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Передача дополнительных флагов
+
+Вы можете передать любые флаги в базовую команду Intlayer:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Использование в CI/CD конвейерах
+
+В вашей конфигурации CI/CD (например, GitHub Actions, GitLab CI) установите `INTLAYER_PROJECT_CREDENTIALS` как секрет:
+
+```yaml
+# Пример GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Заполнить словари
+    run: npx intlayer ci fill
+```
+
+## Обработка ошибок
+
+- Если `INTLAYER_PROJECT_CREDENTIALS` не установлена, команда завершится с ошибкой.
+- Если `INTLAYER_PROJECT_CREDENTIALS` не является допустимым JSON, команда завершится с ошибкой.
+- Если путь проекта не существует, он будет пропущен с предупреждением.
+- Если какой-либо проект завершится неудачей, команда завершится с ненулевым кодом состояния.
+
+## Случаи использования
+
+- **Автоматизация монорепозитория**: Запуск команд Intlayer для нескольких проектов в монорепозитории
+- **CI/CD конвейеры**: Автоматизация управления словарями в рабочих процессах непрерывной интеграции
+- **Массовые операции**: Выполнение одной и той же операции для нескольких проектов Intlayer одновременно
+- **Управление секретами**: Безопасное управление учетными данными для нескольких проектов с использованием переменных окружения
+
+## Рекомендации по безопасности
+
+- Храните `INTLAYER_PROJECT_CREDENTIALS` как зашифрованные секреты в вашей платформе CI/CD
+- Никогда не коммитьте учетные данные в систему контроля версий
+- Используйте учетные данные, специфичные для окружения, для различных сред развертывания
+- Регулярно обновляйте учетные данные

package/docs/ru/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Узнайте, как использовать Intlayer CLI для управления вашим многоязычным сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить ваш проект за несколько минут.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Добавлена команда projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Добавлена команда init
@@ -119,6 +122,7 @@ Intlayer поддерживает несколько форматов конфи
 - **[Сборка словарей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/build.md)** - Сборка ваших словарей из файлов декларации контента
 - **[Отслеживание словарей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/watch.md)** - Отслеживание изменений и автоматическая сборка словарей
 - **[Проверка версии CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/version.md)** - Проверка установленной версии Intlayer CLI
+- **[Список проектов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/list_projects.md)** - Список всех проектов Intlayer в директории или git-репозитории
 
 ### Управление словарями
 
@@ -166,6 +170,7 @@ Intlayer поддерживает несколько форматов конфи
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Intlayer поддерживает несколько форматов конфи
 >
 > - `npx intlayer list` вместо `npx intlayer content list`
 > - `npx intlayer test` вместо `npx intlayer content test`
+> - `npx intlayer projects-list` или `npx intlayer pl` вместо `npx intlayer projects list`

package/docs/ru/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Список файлов декларации контента
 description: Узнайте, как вывести список всех файлов декларации контента в вашем проекте.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Добавлена опция вывода абсолютных путей для команды list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Добавлена опция вывода JSON для команды list
 ---
 
 # Список файлов декларации контента
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Эта команда отображает все файлы декларации контента в вашем проекте, показывая их ключи словаря и пути к файлам. Это полезно для получения обзора всех ваших файлов контента и проверки того, что они корректно обнаружены Intlayer.
 
-## Пример:
+## Аргументы:
+
+- **`--json`**: Выводит результаты в формате JSON вместо форматированного текста. Полезно для скриптов и программного доступа.
+
+  > Пример: `npx intlayer content list --json`
+
+## Примеры:
+
+### Список файлов декларации контента:
 
 ```bash
 npx intlayer content list
 ```
 
+### Вывод в формате JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Вывод в виде абсолютных путей:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Пример вывода:
 
+### Форматированный вывод:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Всего файлов декларации контента: 3
 ```
 
+### Вывод JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Эта команда выведет:
 
 - Отформатированный список всех файлов декларации контента с их ключами и относительными путями к файлам

package/docs/ru/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Список проектов Intlayer
+description: Узнайте, как перечислить все проекты Intlayer в директории или git-репозитории.
+keywords:
+  - List
+  - Projects
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Добавить опцию вывода абсолютных путей к команде list projects
+---
+
+# Список проектов Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Эта команда ищет и выводит список всех проектов Intlayer, находя директории, которые содержат файлы конфигурации Intlayer. Это полезно для обнаружения всех проектов Intlayer в монорепозитории, workspace или git-репозитории.
+
+## Алиасы:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Аргументы:
+
+- **`--base-dir [path]`**: Укажите базовую директорию для поиска. По умолчанию используется текущая рабочая директория.
+
+  > Пример: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Пример: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Выполнять поиск из корня git-репозитория вместо базовой директории. Это полезно для поиска всех проектов Intlayer в монорепозитории или git-репозитории.
+
+  > Пример: `npx intlayer projects list --git-root`
+
+- **`--json`**: Выводит результаты в формате JSON вместо форматированного текста. Полезно для скриптов и программного доступа.
+
+  > Пример: `npx intlayer projects list --json`
+
+- **`--absolute`**: Выводит результаты в виде абсолютных путей вместо относительных путей.
+
+  > Пример: `npx intlayer projects list --absolute`
+
+## Как это работает:
+
+Команда ищет файлы конфигурации Intlayer в указанной директории (или в корне git, если используется `--git-root`). Она ищет следующие шаблоны файлов конфигурации:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Каждая директория, содержащая один из этих файлов, считается проектом Intlayer и будет перечислена в выводе.
+
+## Примеры:
+
+### Перечислить проекты в текущей директории:
+
+```bash
+npx intlayer projects list
+```
+
+### Список проектов в указанной директории:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Список всех проектов в git-репозитории:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Использование сокращённого алиаса:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Вывод в формате JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Пример вывода:
+
+### Форматированный вывод:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Найдено 3 проекта Intlayer:
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Вывод JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Примеры использования:
+
+- **Управление monorepo**: Обнаружить все проекты Intlayer в структуре monorepo
+- **Обнаружение проектов**: Найти все проекты с поддержкой Intlayer в рабочем пространстве
+- **CI/CD**: Проверять проекты Intlayer в автоматизированных конвейерах
+- **Документация**: Генерировать документацию, перечисляющую все проекты, использующие Intlayer
+
+Вывод предоставляет абсолютные пути к каждой директории проекта, что упрощает навигацию к ним или автоматизацию операций над несколькими проектами Intlayer.

package/docs/ru/intlayer_CMS.md

@@ -71,6 +71,26 @@ Intlayer различает «локальные» и «удалённые» с
 
 ## Конфигурация
 
+Выполните следующую команду для входа в Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Это откроет ваш браузер по умолчанию для завершения процесса аутентификации и получения необходимых учетных данных (Client ID и Client Secret) для использования сервисов Intlayer.
+
 В вашем конфигурационном файле Intlayer вы можете настроить параметры CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ru/intlayer_with_next-i18next.md

@@ -594,7 +594,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ru/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### Шаг 2: Настройте ваш проект
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Создайте файл конфигурации для настройки языков вашего приложения:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ru/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### Шаг 2: Настройте ваш проект
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Создайте файл конфигурации для настройки языков вашего приложения:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ru/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Шаг 2: Настройте ваш проект
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Создайте конфигурационный файл для настройки языков вашего приложения:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"