@intlayer/docs 9.5.1 → 9.5.3

package/docs/uk/cli/ci.md

@@ -1,186 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: Команда CI
-description: Дізнайтеся, як використовувати команду Intlayer CI для запуску команд Intlayer з автоматично підставленими обліковими даними у CI/CD пайплайнах та монорепозиторіях.
-keywords:
-  - CI
-  - CI/CD
-  - Automation
-  - Monorepo
-  - Credentials
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "Додано команду CI"
-author: aymericzip
----
-
-# Команда CI
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x 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 автоматично визначає, який package manager використовується (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 packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### Використання в CI/CD пайплайнах
-
-Запуск `intlayer init` створює два готові до використання workflow'и GitHub Actions для вас (див. [Scaffolded GitHub Actions](#scaffolded-github-actions) нижче). Приклад тут показує еквівалентне налаштування за допомогою команди `ci` для monorepo, де облікові дані вводяться для кожного проекту з `INTLAYER_PROJECT_CREDENTIALS`.
-
-У вашій конфігурації CI/CD (наприклад, GitHub Actions, GitLab CI) встановіть `INTLAYER_PROJECT_CREDENTIALS` як секрет:
-
-```yaml
-# Приклад GitHub Actions
-env:
-  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
-
-steps:
-  - name: Fill dictionaries
-    run: npx intlayer ci fill
-```
-
-## Scaffolded GitHub Actions
-
-Коли ви запустите `intlayer init`, Intlayer виявляє ваш package manager (npm, yarn, pnpm або bun) і створює два GitHub Actions workflows у `.github/workflows/` з командами, які відповідають цьому package manager:
-
-- **`intlayer-fill.yml`** — На кожен pull request будує словники і запускає `intlayer fill --git-diff --mode complete` для генерування відсутніх перекладів для змінених словників, потім фіксує результат назад у гілку PR.
-- **`intlayer-test.yml`** — На кожен pull request будує словники і запускає `intlayer test`, завершуючи перевірку з помилкою, коли обов'язкові мови не мають перекладів.
-
-Існуючі файли workflows ніколи не перезаписуються. Щоб пропустити scaffolding повністю, запустіть:
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### Надання доступу до ШІ для робочого процесу заповнення
-
-Сгенерований `intlayer-fill.yml` вимагає доступу до ШІ. Доступні два варіанти (налаштовуються в блоці `env` робочого процесу):
-
-1. **Ваш власний ключ AI-провайдера** — Додайте секрет `AI_API_KEY` в налаштуваннях вашого репозиторію (Settings → Secrets and variables → Actions). Робочий процес передає його через `--provider`, `--model` та `--api-key`.
-2. **Ключі доступу до Intlayer CMS** — Додайте секрети `INTLAYER_CLIENT_ID` та `INTLAYER_CLIENT_SECRET` і підключіть їх до секції `editor` вашого `intlayer.config`. Ключі доступу до CMS надають доступ до ШІ через backend Intlayer.
-
-Робочий процес `intlayer-test.yml` не вимагає жодного доступу до ШІ.
-
-## Обробка помилок
-
-- Якщо `INTLAYER_PROJECT_CREDENTIALS` не встановлено, команда завершиться з помилкою.
-- Якщо `INTLAYER_PROJECT_CREDENTIALS` не є валідним JSON, команда завершиться з помилкою.
-- Якщо шлях до проекту не існує, він буде пропущений з попередженням.
-- Якщо будь-який проект зазнає невдачі, команда завершиться з кодом стану, відмінним від нуля.
-
-## Випадки використання
-
-- **Автоматизація монорепо**: Виконувати команди Intlayer для кількох проектів у монорепозиторії
-- **Конвеєри CI/CD**: Автоматизувати керування словниками в процесах безперервної інтеграції
-- **Масові операції**: Виконувати одну й ту саму операцію одночасно для кількох проектів Intlayer
-- **Управління секретами**: Безпечно керуйте обліковими даними для кількох проєктів за допомогою змінних середовища
-
-## Кращі практики безпеки
-
-- Зберігайте `INTLAYER_PROJECT_CREDENTIALS` як зашифровані секрети на вашій платформі CI/CD
-- Ніколи не комітіть облікові дані у систему контролю версій
-- Використовуйте окремі облікові дані для різних середовищ розгортання
-- Регулярно проводьте ротацію облікових даних

package/docs/vi/cli/ci.md

@@ -1,186 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: Lệnh CI
-description: Tìm hiểu cách sử dụng lệnh Intlayer CI để chạy các lệnh Intlayer với thông tin xác thực được tự động chèn vào trong các pipeline CI/CD và monorepo.
-keywords:
-  - CI
-  - CI/CD
-  - Tự động hóa
-  - Monorepo
-  - Thông tin xác thực
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "Thêm lệnh CI"
-author: aymericzip
----
-
-# Lệnh CI
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x intlayer ci <command...>
-```
-
-Lệnh CI được thiết kế cho tự động hóa và các pipeline CI/CD. Nó tự động chèn thông tin xác thực từ biến môi trường `INTLAYER_PROJECT_CREDENTIALS` và có thể chạy các lệnh Intlayer trên nhiều dự án trong một monorepo.
-
-## Cách hoạt động
-
-Lệnh CI hoạt động ở hai chế độ:
-
-1. **Chế độ dự án đơn**: Nếu thư mục làm việc hiện tại khớp với một trong các đường dẫn dự án trong `INTLAYER_PROJECT_CREDENTIALS`, nó sẽ chạy lệnh chỉ cho dự án cụ thể đó.
-
-2. **Chế độ lặp lại**: Nếu không phát hiện ngữ cảnh dự án cụ thể, nó sẽ lặp lại tất cả các dự án đã cấu hình và chạy lệnh cho từng dự án.
-
-## Biến môi trường
-
-Lệnh yêu cầu biến môi trường `INTLAYER_PROJECT_CREDENTIALS` được đặt. Biến này phải chứa một đối tượng JSON ánh xạ các đường dẫn dự án đến thông tin xác thực của chúng:
-
-```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"
-  }
-}
-```
-
-## Phát hiện trình quản lý gói
-
-Lệnh CI tự động phát hiện trình quản lý gói đang được sử dụng (npm, yarn, pnpm hoặc bun) dựa trên biến môi trường `npm_config_user_agent` và sử dụng lệnh phù hợp để thực thi Intlayer.
-
-## Đối số
-
-- **`<command...>`**: Lệnh Intlayer để thực thi (ví dụ: `fill`, `push`, `build`). Bạn có thể truyền bất kỳ lệnh Intlayer nào và các đối số của nó.
-
-  > Ví dụ: `npx intlayer ci fill --verbose`
-  >
-  > Ví dụ: `npx intlayer ci push`
-  >
-  > Ví dụ: `npx intlayer ci build --watch`
-
-## Ví dụ
-
-### Chạy lệnh ở chế độ dự án đơn
-
-Nếu bạn đang ở trong thư mục dự án khớp với một trong các đường dẫn trong `INTLAYER_PROJECT_CREDENTIALS`:
-
-```bash
-cd packages/app
-npx intlayer ci fill
-```
-
-Điều này sẽ chạy lệnh `fill` với thông tin xác thực được tự động chèn cho dự án `packages/app`.
-
-### Chạy lệnh trên tất cả các dự án
-
-Nếu bạn đang ở trong thư mục không khớp với bất kỳ đường dẫn dự án nào, lệnh sẽ lặp lại tất cả các dự án đã cấu hình:
-
-```bash
-cd /path/to/monorepo
-npx intlayer ci push
-```
-
-Điều này sẽ chạy lệnh `push` cho mỗi dự án được cấu hình trong `INTLAYER_PROJECT_CREDENTIALS`.
-
-### Truyền cờ bổ sung
-
-Bạn có thể truyền bất kỳ cờ nào cho lệnh Intlayer cơ bản:
-
-```bash packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### Sử dụng trong pipeline CI/CD
-
-Chạy `intlayer init` tạo ra hai GitHub Actions workflows sẵn sàng sử dụng cho bạn (xem [Scaffolded GitHub Actions](#scaffolded-github-actions) dưới đây). Ví dụ ở đây cho thấy cấu hình tương đương bằng cách sử dụng lệnh `ci` cho một monorepo, nơi các credentials được inject cho mỗi project từ `INTLAYER_PROJECT_CREDENTIALS`.
-
-Trong cấu hình CI/CD của bạn (ví dụ: GitHub Actions, GitLab CI), đặt `INTLAYER_PROJECT_CREDENTIALS` làm bí mật:
-
-```yaml
-# Ví dụ GitHub Actions
-env:
-  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
-
-steps:
-  - name: Điền từ điển
-    run: npx intlayer ci fill
-```
-
-## GitHub Actions được tạo tự động
-
-Khi bạn chạy `intlayer init`, Intlayer sẽ phát hiện package manager của bạn (npm, yarn, pnpm, hoặc bun) và tạo hai workflow GitHub Actions trong `.github/workflows/`, với các lệnh phù hợp với package manager đó:
-
-- **`intlayer-fill.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer fill --git-diff --mode complete` để tạo các bản dịch bị thiếu cho các từ điển đã thay đổi, sau đó commit kết quả lại vào nhánh PR.
-- **`intlayer-test.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer test`, làm cho kiểm tra thất bại khi các locale bắt buộc bị thiếu bản dịch.
-
-Các tập tin workflow hiện có sẽ không bao giờ bị ghi đè. Để bỏ qua việc tạo tự động hoàn toàn, hãy chạy:
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### Cấp quyền truy cập AI cho quy trình fill
-
-`intlayer-fill.yml` được tạo ra yêu cầu quyền truy cập AI. Có hai tùy chọn có sẵn (được cấu hình trong khối `env` của quy trình):
-
-1. **Khóa nhà cung cấp AI của riêng bạn** — Thêm bí mật `AI_API_KEY` trong cài đặt kho lưu trữ của bạn (Settings → Secrets and variables → Actions). Quy trình sẽ chuyển tiếp nó qua `--provider`, `--model` và `--api-key`.
-2. **Khóa truy cập Intlayer CMS** — Thêm bí mật `INTLAYER_CLIENT_ID` và `INTLAYER_CLIENT_SECRET` và kết nối chúng vào phần `editor` của `intlayer.config` của bạn. Các khóa truy cập CMS cấp quyền truy cập AI thông qua backend Intlayer.
-
-Quy trình `intlayer-test.yml` không yêu cầu bất kỳ quyền truy cập AI nào.
-
-## Xử lý lỗi
-
-- Nếu `INTLAYER_PROJECT_CREDENTIALS` không được đặt, lệnh sẽ thoát với lỗi.
-- Nếu `INTLAYER_PROJECT_CREDENTIALS` không phải là JSON hợp lệ, lệnh sẽ thoát với lỗi.
-- Nếu đường dẫn dự án không tồn tại, nó sẽ được bỏ qua với cảnh báo.
-- Nếu bất kỳ dự án nào thất bại, lệnh sẽ thoát với mã trạng thái khác không.
-
-## Trường hợp sử dụng
-
-- **Tự động hóa monorepo**: Chạy các lệnh Intlayer trên nhiều dự án trong một monorepo
-- **Pipeline CI/CD**: Tự động hóa quản lý từ điển trong quy trình tích hợp liên tục
-- **Thao tác hàng loạt**: Thực hiện cùng một thao tác trên nhiều dự án Intlayer cùng một lúc
-- **Quản lý bí mật**: Quản lý an toàn thông tin xác thực cho nhiều dự án bằng cách sử dụng biến môi trường
-
-## Thực hành bảo mật tốt nhất
-
-- Lưu trữ `INTLAYER_PROJECT_CREDENTIALS` dưới dạng bí mật được mã hóa trong nền tảng CI/CD của bạn
-- Không bao giờ commit thông tin xác thực vào kiểm soát phiên bản
-- Sử dụng thông tin xác thực cụ thể theo môi trường cho các môi trường triển khai khác nhau
-- Xoay thông tin xác thực thường xuyên

package/docs/zh/cli/ci.md

@@ -1,186 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: CI 命令
-description: 了解如何在 CI/CD 管道和 monorepo 中使用自动注入的凭据运行 Intlayer 命令。
-keywords:
-  - CI
-  - CI/CD
-  - 自动化
-  - Monorepo
-  - 凭据
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "添加 CI 命令"
-author: aymericzip
----
-
-# CI 命令
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x intlayer ci <command...>
-```
-
-CI 命令专为自动化和 CI/CD 管道而设计。它会自动从 `INTLAYER_PROJECT_CREDENTIALS` 环境变量注入凭据，并可以在 monorepo 中的多个项目上运行 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_config_user_agent` 环境变量自动检测正在使用的包管理器（npm、yarn、pnpm 或 bun），并使用适当的命令来执行 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
-```
-
-这将为 `packages/app` 项目自动注入凭据并运行 `fill` 命令。
-
-### 在所有项目上运行命令
-
-如果您在未匹配任何项目路径的目录中，该命令将遍历所有已配置的项目：
-
-```bash
-cd /path/to/monorepo
-npx intlayer ci push
-```
-
-这将为 `INTLAYER_PROJECT_CREDENTIALS` 中配置的每个项目运行 `push` 命令。
-
-### 传递额外标志
-
-您可以将任何标志传递给底层 Intlayer 命令：
-
-```bash packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### 在 CI/CD 管道中使用
-
-运行 `intlayer init` 为你生成两个可立即使用的 GitHub Actions 工作流（参见下面的 [Scaffolded GitHub Actions](#scaffolded-github-actions)）。这个例子展示了在 monorepo 中使用 `ci` 命令的等效设置，其中凭证从 `INTLAYER_PROJECT_CREDENTIALS` 按项目注入。
-
-在您的 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
-```
-
-## 脚手架 GitHub Actions
-
-当你运行 `intlayer init` 时，Intlayer 会检测你的包管理器（npm、yarn、pnpm 或 bun），并在 `.github/workflows/` 下脚手架生成两个 GitHub Actions 工作流，命令与该包管理器相匹配：
-
-- **`intlayer-fill.yml`** — 在每个 pull request 上，构建字典并运行 `intlayer fill --git-diff --mode complete` 来为更改的字典生成缺失的翻译，然后将结果提交回 PR 分支。
-- **`intlayer-test.yml`** — 在每个 pull request 上，构建字典并运行 `intlayer test`，当必需的语言环境缺少翻译时，检查失败。
-
-现有的工作流文件永远不会被覆盖。要完全跳过脚手架，运行：
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### 为 fill workflow 提供 AI 访问权限
-
-生成的 `intlayer-fill.yml` 需要 AI 访问权限。有两个选项可用（在 workflow 的 `env` 块中配置）：
-
-1. **您自己的 AI 提供商密钥** — 在您的存储库设置中添加 `AI_API_KEY` 密钥（Settings → Secrets and variables → Actions）。workflow 通过 `--provider`、`--model` 和 `--api-key` 转发它。
-2. **Intlayer CMS 访问密钥** — 添加 `INTLAYER_CLIENT_ID` 和 `INTLAYER_CLIENT_SECRET` 密钥，并将它们连接到您的 `intlayer.config` `editor` 部分。CMS 访问密钥通过 Intlayer 后端授予 AI 访问权限。
-
-`intlayer-test.yml` workflow 不需要任何 AI 访问权限。
-
-## 错误处理
-
-- 如果未设置 `INTLAYER_PROJECT_CREDENTIALS`，命令将以错误退出。
-- 如果 `INTLAYER_PROJECT_CREDENTIALS` 不是有效的 JSON，命令将以错误退出。
-- 如果项目路径不存在，将跳过并显示警告。
-- 如果任何项目失败，命令将以非零状态代码退出。
-
-## 使用场景
-
-- **Monorepo 自动化**：在 monorepo 中的多个项目上运行 Intlayer 命令
-- **CI/CD 管道**：在持续集成工作流中自动化字典管理
-- **批量操作**：同时对多个 Intlayer 项目执行相同操作
-- **密钥管理**：使用环境变量安全地管理多个项目的凭据
-
-## 安全最佳实践
-
-- 在 CI/CD 平台中将 `INTLAYER_PROJECT_CREDENTIALS` 存储为加密密钥
-- 永远不要将凭据提交到版本控制
-- 为不同的部署环境使用特定于环境的凭据
-- 定期轮换凭据