@intlayer/docs 7.5.10 → 7.5.12

package/docs/uk/packages/intlayer/getConfiguration.md

@@ -0,0 +1,145 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Документація функції getConfiguration | intlayer
+description: Дізнайтесь, як використовувати функцію getConfiguration для пакета intlayer
+keywords:
+  - getConfiguration
+  - переклад
+  - Intlayer
+  - intlayer
+  - інтернаціоналізація
+  - документація
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getConfiguration
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Ініціалізація історії
+---
+
+# Документація: функція `getConfiguration` у `intlayer`
+
+## Опис
+
+Функція `getConfiguration` отримує повну конфігурацію для застосунку `intlayer`, витягуючи змінні оточення. Ця функція дає змогу використовувати одну й ту саму конфігурацію як на клієнтській, так і на серверній стороні, забезпечуючи узгодженість по всьому застосунку.
+
+---
+
+## Параметри
+
+Функція не приймає жодних параметрів. Замість цього вона використовує змінні оточення для налаштування.
+
+### Повертає
+
+- **Тип**: `IntlayerConfig`
+- **Опис**: Об'єкт, що містить повну конфігурацію для `intlayer`. Конфігурація включає такі розділи:
+  - `internationalization`: Налаштування, пов'язані з локалями та strict mode.
+  - `middleware`: Налаштування, пов'язані з керуванням URL та cookie.
+  - `content`: Налаштування, пов'язані з файлами контенту, директоріями та шаблонами.
+  - `editor`: Налаштування, специфічні для редактора.
+
+Див. [документацію з конфігурації Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md) для отримання додаткової інформації.
+
+---
+
+## Приклад використання
+
+### Отримання повної конфігурації
+
+```typescript codeFormat="typescript"
+import { getConfiguration } from "intlayer";
+
+const config = getConfiguration();
+console.log(config);
+// Вивід:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+```javascript codeFormat="esm"
+import { getConfiguration } from "intlayer";
+
+const config = getConfiguration();
+console.log(config);
+// Вивід:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+```javascript codeFormat="commonjs"
+const { getConfiguration } = require("intlayer");
+
+const config = getConfiguration();
+console.log(config);
+// Вивід:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+### Отримання `availableLocales` та `defaultLocale`
+
+Розділ `internationalization` конфігурації надає налаштування, пов'язані з локалями, такі як `locales` (доступні локалі) та `defaultLocale` (мова за замовчуванням).
+
+```typescript codeFormat="typescript"
+import { getConfiguration } from "intlayer";
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Приклад виводу: ["en", "fr", "es"]
+console.log(defaultLocale); // Приклад виводу: "en"
+console.log(cookieName); // Вивід: "INTLAYER_LOCALE"
+```
+
+```javascript codeFormat="esm"
+import { getConfiguration } from "intlayer";
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Приклад виводу: ["en", "fr", "es"]
+console.log(defaultLocale); // Приклад виводу: "en"
+console.log(cookieName); // Вивід: "INTLAYER_LOCALE"
+```
+
+```javascript codeFormat="commonjs"
+const { getConfiguration } = require("intlayer");
+
+const { internationalization, middleware } = getConfiguration();
+const { locales: availableLocales, defaultLocale } = internationalization;
+const { cookieName } = middleware;
+
+console.log(availableLocales); // Приклад виводу: ["en", "fr", "es"]
+console.log(defaultLocale); // Приклад виводу: "en"
+console.log(cookieName); // Вивід: "INTLAYER_LOCALE"
+```
+
+## Примітки
+
+- Переконайтеся, що всі необхідні змінні середовища правильно встановлені перед викликом цієї функції. Відсутні змінні спричинять помилки під час ініціалізації.
+- Цю функцію можна використовувати як на клієнті, так і на сервері, що робить її універсальним інструментом для керування конфігураціями в уніфікований спосіб.
+
+## Використання в застосунках
+
+Функція `getConfiguration` є ключовою утилітою для ініціалізації та керування конфігурацією застосунку `intlayer`. Надаючи доступ до налаштувань, таких як locales, middleware та content directories, вона забезпечує узгодженість і масштабованість багатомовних і контент-орієнтованих застосунків.

package/docs/uk/vs_code_extension.md

@@ -0,0 +1,133 @@
+---
+createdAt: 2025-03-17
+updatedAt: 2025-09-30
+title: Офіційне розширення VS Code
+description: Дізнайтеся, як використовувати розширення Intlayer у VS Code для покращення робочого процесу розробки. Швидко переходьте між локалізованим контентом і ефективно керуйте своїми словниками.
+keywords:
+  - Розширення VS Code
+  - Intlayer
+  - Локалізація
+  - Інструменти розробки
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - vs-code-extension
+history:
+  - version: 7.3.0
+    date: 2025-11-25
+    changes: Додано команду Extract Content
+  - version: 6.1.5
+    date: 2025-09-30
+    changes: Додано демонстраційний GIF
+  - version: 6.1.0
+    date: 2025-09-24
+    changes: Додано розділ вибору середовища
+  - version: 6.0.0
+    date: 2025-09-22
+    changes: Вкладка Intlayer / команди Fill & Test
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Ініціалізація історії
+---
+
+# Офіційне розширення VS Code
+
+## Огляд
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) — офіційне розширення Visual Studio Code для **Intlayer**, створене для покращення досвіду розробника під час роботи з локалізованим контентом у ваших проєктах.
+
+![Розширення Intlayer для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif?raw=true)
+
+Посилання на розширення: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Особливості
+
+![Витяг вмісту](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_extract_content.gif?raw=true)
+
+- **Витяг вмісту** – Витягує вміст із ваших компонентів React / Vue / Svelte
+
+![Заповнення словників](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_fill_active_dictionary.gif?raw=true)
+
+- **Миттєва навігація** – Швидко переходьте до відповідного файлу вмісту, натиснувши на ключ `useIntlayer`.
+- **Заповнення словників** – Заповнює словники вмістом із вашого проєкту.
+
+![Список команд](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_list_commands.gif?raw=true)
+
+- **Простий доступ до команд Intlayer** – Build, push, pull, fill, test словників вмісту з легкістю.
+
+![Створити файл вмісту](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_create_content_file.gif?raw=true)
+
+- **Генератор декларацій вмісту** – Створюйте файли словників вмісту в різних форматах (`.ts`, `.esm`, `.cjs`, `.json`).
+
+![Тест словників](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_test_missing_dictionary.gif?raw=true)
+
+- **Тестування словників** – Перевірка словників на наявність відсутніх перекладів.
+
+![Перебудова словника](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_rebuild_dictionary.gif?raw=true)
+
+- **Тримайте свої словники в актуальному стані** – Оновлюйте словники останнім вмістом з вашого проєкту.
+
+![Вкладка Intlayer (Панель активності)](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_search_dictionary.gif?raw=true)
+
+- **Вкладка Intlayer (Панель активності)** – Оглядайте та шукайте словники у виділеній бічній вкладці з панеллю інструментів і контекстними діями (Build, Pull, Push, Fill, Refresh, Test, Create File).
+
+## Використання
+
+### Швидка навігація
+
+1. Відкрийте проєкт, що використовує **react-intlayer**.
+2. Знайдіть виклик `useIntlayer()`, наприклад:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Command-click** (`⌘+Click` на macOS) або **Ctrl+Click** (на Windows/Linux) по ключу (наприклад, `"app"`).
+4. VS Code автоматично відкриє відповідний файл словника, наприклад, `src/app.content.ts`.
+
+### Вкладка Intlayer (Панель активності)
+
+Використовуйте бічну вкладку для перегляду та керування словниками:
+
+- Відкрийте значок Intlayer на Панелі активності.
+- У **Search** введіть текст, щоб у реальному часі фільтрувати словники та записи.
+- У **Dictionaries** переглядайте середовища, словники та файли. Використовуйте панель інструментів для Build, Pull, Push, Fill, Refresh, Test та Create Dictionary File. Натисніть правою кнопкою для контекстних дій (Pull/Push для словників, Fill для файлів). Поточний файл у редакторі автоматично відображається в дереві, коли це доречно.
+
+### Доступ до команд
+
+Ви можете викликати команди через **Command Palette**.
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+- **Build Dictionaries**
+- **Надіслати словники**
+- **Отримати словники**
+- **Заповнити словники**
+- **Тестувати словники**
+- **Створити файл словника**
+
+### Завантаження змінних оточення
+
+Intlayer рекомендує зберігати ваші AI API keys, а також Intlayer client ID і secret у змінних оточення.
+
+Розширення може завантажувати змінні оточення з вашого робочого простору, щоб виконувати команди Intlayer у правильному контексті.
+
+- **Порядок завантаження (за пріоритетом)**: `.env.<env>.local` → `.env.<env>` → `.env.local` → `.env`
+- **Недеструктивно**: існуючі значення `process.env` не перезаписуються.
+- **Область застосування**: файли визначаються з налаштованого базового каталогу (за замовчуванням — корінь робочого простору).
+
+#### Вибір активного середовища
+
+- **Палітра команд**: відкрийте палітру та виконайте `Intlayer: Select Environment`, потім оберіть середовище (наприклад, `development`, `staging`, `production`). Розширення намагатиметься завантажити перший доступний файл зі списку пріоритетів вище та покаже повідомлення на кшталт «Завантажено env з .env.<env>.local».
+- **Налаштування**: перейдіть у `Settings → Extensions → Intlayer` та встановіть:
+  - **Environment**: назва середовища, яка використовується для визначення файлів `.env.<env>*`.
+  - (Необов'язково) **Env File**: явний шлях до файлу `.env`. Якщо вказано, він має пріоритет над виведеним вище списком.
+
+#### Монорепозиторії та власні каталоги
+
+Якщо ваші файли `.env` розташовані поза коренем робочого простору, встановіть **Базовий каталог** у `Settings → Extensions → Intlayer`. Завантажувач шукатиме файли `.env` відносно цього каталогу.

package/docs/vi/cli/ci.md

@@ -0,0 +1,137 @@
+---
+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
+---
+
+# Lệnh CI
+
+```bash
+npx 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
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Sử dụng trong pipeline CI/CD
+
+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
+```
+
+## 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/vi/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Khám phá cách sử dụng Intlayer CLI để quản lý trang web đa ngôn ngữ của bạn. Làm theo các bước trong tài liệu trực tuyến này để thiết lập dự án của bạn trong vài phút.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Thêm lệnh projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Thêm lệnh init
@@ -120,6 +123,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
 - **[Xây dựng Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung
 - **[Theo dõi Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/watch.md)** - Theo dõi các thay đổi và tự động xây dựng từ điển
 - **[Kiểm tra Phiên bản CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/version.md)** - Kiểm tra phiên bản Intlayer CLI đã cài đặt
+- **[Liệt kê Dự án](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/list_projects.md)** - Liệt kê tất cả các dự án Intlayer trong thư mục hoặc kho lưu trữ git
 
 ### Quản lý Từ điển
 
@@ -167,6 +171,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
   "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"
 }
@@ -176,3 +181,4 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
 >
 > - `npx intlayer list` thay vì `npx intlayer content list`
 > - `npx intlayer test` thay vì `npx intlayer content test`
+> - `npx intlayer projects-list` hoặc `npx intlayer pl` thay vì `npx intlayer projects list`

package/docs/vi/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Liệt kê các tệp khai báo nội dung
 description: Tìm hiểu cách liệt kê tất cả các tệp khai báo nội dung trong dự án của bạn.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Thêm tùy chọn đầu ra tuyệt đối cho lệnh list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Thêm tùy chọn đầu ra JSON cho lệnh list
 ---
 
 # Liệt kê các tệp khai báo nội dung
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Lệnh này hiển thị tất cả các tệp khai báo nội dung trong dự án của bạn, cho thấy các khóa từ điển và đường dẫn tệp của chúng. Nó hữu ích để có cái nhìn tổng quan về tất cả các tệp nội dung của bạn và xác minh rằng chúng được Intlayer phát hiện đúng cách.
 
+## Đối số:
+
+- **`--json`**: Xuất kết quả dưới dạng JSON thay vì văn bản được định dạng. Hữu ích cho việc viết script và truy cập lập trình.
+
+  > Ví dụ: `npx intlayer content list --json`
+
 ## Ví dụ:
 
+### Liệt kê các tệp khai báo nội dung:
+
 ```bash
 npx intlayer content list
 ```
 
+### Đầu ra dưới dạng JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Đầu ra dưới dạng đường dẫn tuyệt đối:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Ví dụ đầu ra:
 
+### Đầu ra được định dạng:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Tổng số tệp khai báo nội dung: 3
 ```
 
+### Đầu ra 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"}]
+```
+
 Lệnh này sẽ xuất ra:
 
 - Một danh sách được định dạng của tất cả các tệp khai báo nội dung với các khóa và đường dẫn tệp tương đối của chúng

package/docs/vi/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Liệt kê các dự án Intlayer
+description: Tìm hiểu cách liệt kê tất cả dự án Intlayer trong một thư mục hoặc kho git.
+keywords:
+  - Danh sách
+  - Dự án
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Thêm tùy chọn đầu ra tuyệt đối vào lệnh list projects
+---
+
+# Liệt kê các dự án Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Lệnh này tìm kiếm và liệt kê tất cả các dự án Intlayer bằng cách tìm các thư mục chứa các tệp cấu hình Intlayer. Nó hữu ích để phát hiện tất cả các dự án Intlayer trong một monorepo, workspace, hoặc kho git.
+
+## Bí danh:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Tham số:
+
+- **`--base-dir [path]`**: Chỉ định thư mục gốc để bắt đầu tìm kiếm. Mặc định là thư mục làm việc hiện tại.
+
+  > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Tìm kiếm từ thư mục gốc của git thay vì thư mục cơ sở. Điều này hữu ích để tìm tất cả các dự án Intlayer trong một monorepo hoặc kho git.
+
+  > Ví dụ: `npx intlayer projects list --git-root`
+
+- **`--json`**: Xuất kết quả dưới dạng JSON thay vì văn bản được định dạng. Hữu ích cho việc viết script và truy cập lập trình.
+
+  > Ví dụ: `npx intlayer projects list --json`
+
+- **`--absolute`**: Xuất kết quả dưới dạng đường dẫn tuyệt đối thay vì đường dẫn tương đối.
+
+  > Ví dụ: `npx intlayer projects list --absolute`
+
+## Cách hoạt động:
+
+Lệnh sẽ tìm các tệp cấu hình Intlayer trong thư mục được chỉ định (hoặc git root nếu sử dụng `--git-root`). Nó tìm các mẫu tệp cấu hình sau:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Mỗi thư mục chứa một trong các tệp này được coi là một dự án Intlayer và sẽ được liệt kê trong đầu ra.
+
+## Ví dụ:
+
+### Liệt kê các dự án trong thư mục hiện tại:
+
+```bash
+npx intlayer projects list
+```
+
+### Liệt kê các dự án trong một thư mục cụ thể:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Liệt kê tất cả dự án trong repository git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Sử dụng alias rút gọn:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Đầu ra dưới dạng JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Ví dụ đầu ra:
+
+### Đầu ra được định dạng:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Tìm thấy 3 dự án Intlayer:
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Đầu ra JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Các trường hợp sử dụng:
+
+- **Quản lý Monorepo**: Khám phá tất cả các dự án Intlayer trong cấu trúc monorepo
+- **Khám phá dự án**: Tìm tất cả các dự án hỗ trợ Intlayer trong một workspace
+- **CI/CD**: Xác minh các dự án Intlayer trong các workflow tự động
+- **Tài liệu**: Tạo tài liệu liệt kê tất cả các dự án sử dụng Intlayer
+
+Đầu ra cung cấp đường dẫn tuyệt đối đến từng thư mục dự án, giúp dễ dàng điều hướng đến hoặc viết script thao tác trên nhiều dự án Intlayer.

package/docs/vi/intlayer_CMS.md

@@ -77,6 +77,26 @@ Ngược lại, Intlayer CMS là một công cụ cho phép bạn quản lý n
 
 ## Cấu hình
 
+Chạy lệnh sau để đăng nhập vào 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
+```
+
+Điều này sẽ mở trình duyệt mặc định của bạn để hoàn tất quá trình xác thực và nhận thông tin đăng nhập cần thiết (Client ID và Client Secret) để sử dụng các dịch vụ Intlayer.
+
 Trong file cấu hình Intlayer của bạn, bạn có thể tùy chỉnh các thiết lập CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"