@intlayer/docs 7.5.10 → 7.5.11

package/docs/pt/cli/list_projects.md

@@ -0,0 +1,134 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Listar Projetos Intlayer
+description: Aprenda como listar todos os projetos Intlayer em um diretório ou repositório git.
+keywords:
+  - Listar
+  - Projetos
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Adicionar opção de saída absoluta ao comando list projects
+---
+
+# Listar Projetos Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Este comando procura e lista todos os projetos Intlayer ao encontrar diretórios que contenham ficheiros de configuração do Intlayer. É útil para descobrir todos os projetos Intlayer em um monorepo, workspace ou repositório git.
+
+## Atalhos:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumentos:
+
+- **`--base-dir [path]`**: Especifica o diretório base a partir do qual pesquisar. O padrão é o diretório de trabalho atual.
+
+  > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Pesquise a partir do diretório raiz do git em vez do diretório base. Isto é útil para encontrar todos os projetos Intlayer num monorepo ou repositório git.
+
+  > Exemplo: `npx intlayer projects list --git-root`
+
+- **`--json`**: Exibe os resultados como JSON em vez de texto formatado. Útil para scripts e acesso programático.
+
+  > Exemplo: `npx intlayer projects list --json`
+
+- **`--absolute`**: Exibe os resultados como caminhos absolutos em vez de caminhos relativos.
+
+  > Exemplo: `npx intlayer projects list --absolute`
+
+## Como funciona:
+
+O comando procura ficheiros de configuração do Intlayer no diretório especificado (ou na raiz do git se `--git-root` for usado). Procura pelos seguintes padrões de ficheiro de configuração:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Cada diretório que contiver um destes ficheiros é considerado um projeto Intlayer e será listado na saída.
+
+## Exemplos:
+
+### Listar projetos no diretório atual:
+
+```bash
+npx intlayer projects list
+```
+
+### Listar projetos em um diretório específico:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Listar todos os projetos no repositório git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Usando o alias de atalho:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Saída como JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Exemplo de saída:
+
+### Saída formatada:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Saída JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Casos de uso:
+
+- **Gestão de monorepo**: Descobrir todos os projetos Intlayer numa estrutura monorepo
+- **Descoberta de projetos**: Encontrar todos os projetos com Intlayer num workspace
+- **CI/CD**: Verificar projetos Intlayer em workflows automatizados
+- **Documentação**: Gerar documentação listando todos os projetos que usam Intlayer
+
+A saída fornece caminhos absolutos para cada diretório de projeto, facilitando a navegação ou a automatização de operações em múltiplos projetos Intlayer.
+
+- **Documentação**: Gerar documentação listando todos os projetos que usam o Intlayer
+
+A saída fornece caminhos absolutos para cada diretório de projeto, tornando fácil navegar até eles ou escrever scripts para executar operações em vários projetos Intlayer.

package/docs/pt/intlayer_CMS.md

@@ -71,6 +71,26 @@ Para integração com Vite + React, consulte o [guia de configuração](https://
 
 ## Configuração
 
+Execute o seguinte comando para fazer login no 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
+```
+
+Isso abrirá seu navegador padrão para concluir o processo de autenticação e receber as credenciais necessárias (Client ID e Client Secret) para usar os serviços do Intlayer.
+
 No seu arquivo de configuração do Intlayer, você pode personalizar as configurações do CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

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"