@intlayer/docs 9.5.1 → 9.5.3

package/frequent_questions/vi/claude_code_token_consumption.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: Cách giới hạn mức tiêu thụ token của Claude Code khi tạo bản dịch
+description: Tại sao dịch thuật bằng Claude Code gây lãng phí token, những gì Intlayer thực hiện thay thế (lọc các khóa đã dịch, chia nhỏ JSON, dịch markdown theo từng khối) và cách tái sử dụng gói đăng ký Claude với claude setup-token.
+keywords:
+  - claude code
+  - tokens
+  - tiêu thụ token
+  - setup-token
+  - i18n
+  - quốc tế hóa
+  - dịch thuật
+  - fill
+  - mcp
+  - agent
+slugs:
+  - frequent-questions
+  - claude-code-token-consumption
+author: aymericzip
+---
+
+# Cách giới hạn mức tiêu thụ token của Claude Code khi tạo bản dịch
+
+## Mô tả vấn đề
+
+Yêu cầu Claude Code (hoặc bất kỳ agent lập trình nào) dịch nội dung là phương pháp tốn kém nhất. Trong mỗi lần chạy, agent phải:
+
+- Tải toàn bộ tệp JSON hoặc tệp nội dung vào ngữ cảnh, bao gồm cả những khóa đã được dịch.
+- Tìm kiếm các tệp liên quan để xác định vị trí và cấu trúc của nội dung.
+- Tìm ra những ngôn ngữ (locales) còn thiếu và cần được tạo.
+- Đọc lại các hướng dẫn tùy chỉnh của bạn mỗi lần ("chuyển đổi URL theo cách này", "giữ nguyên tên thương hiệu bằng tiếng Anh", "dùng văn phong thân mật").
+- Viết lại toàn bộ tệp, bao gồm cả những phần không hề thay đổi.
+
+Tất cả những dữ liệu đó đều được gửi lại ở mỗi lượt tương tác, khiến chi phí tăng theo công thức `kích thước nội dung × số lượng ngôn ngữ × số lượt tương tác`, và mọi sai lệch về định dạng hoặc khóa đều phải rà soát thủ công.
+
+## Những gì Intlayer thực hiện thay thế
+
+Lợi ích của Intlayer là xử lý công việc đó bên ngoài agent, thông qua một pipeline được xây dựng chuyên biệt cho việc dịch thuật:
+
+- **Lọc các bản dịch đã có** để giảm thiểu việc sử dụng token. Các khóa đã được dịch trong JSON sẽ được loại bỏ, chỉ các khóa còn thiếu mới được gửi đến mô hình.
+- **Dịch markdown theo từng khối.** Đối với tài liệu, [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md) và [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-review.md) so sánh từng khối với tài liệu gốc và bỏ qua các khối đã được dịch hoặc không thay đổi.
+- **Chia nhỏ JSON (chunking)** nếu tệp quá lớn để luôn nằm trong vùng tối ưu của cửa sổ ngữ cảnh.
+- **Làm phẳng và tái cấu trúc JSON** nhằm tối ưu hóa lượng token tiêu thụ.
+- **Chèn prompt tùy chỉnh** cho các quy tắc cụ thể về thương hiệu và câu từ (`applicationContext`, `--custom-instructions`), giúp bạn chỉ cần viết một lần thay vì lặp lại trong mỗi cuộc trò chuyện.
+- **Xác thực cấu trúc** để đảm bảo tính nhất quán và ngăn ngừa sai lệch khóa, đồng thời giữ nguyên định dạng (markdown, HTML, biến chèn, số nhiều).
+- **Áp dụng cơ chế thử lại (retry)** khi định dạng đầu ra không hợp lệ.
+- **Xếp hàng và xử lý song song các yêu cầu** giữa các tệp, khối dữ liệu và ngôn ngữ để tăng tốc độ.
+
+Không có bước nào trong số này đi qua ngữ cảnh của agent. Nguyên tắc cốt lõi: để agent quyết định **cần** quốc tế hóa nội dung nào, và để Intlayer đảm nhận công việc lặp đi lặp lại.
+
+## Giải pháp
+
+### 1. Ủy quyền việc trích xuất cho `intlayer extract`
+
+Thay vì yêu cầu agent viết lại từng component theo cách thủ công, hãy để agent chạy lệnh [`extract`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md). Lệnh này sẽ chuyển các chuỗi văn bản cố định sang tệp `.content` ngay cạnh component mà không cần tải toàn bộ tệp vào ngữ cảnh của agent.
+
+```bash
+npx intlayer extract --file src/components/Header.tsx
+```
+
+### 2. Ủy quyền việc dịch thuật cho `intlayer fill`
+
+Tuyệt đối không yêu cầu agent dịch trực tiếp. Lệnh [`fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/fill.md) áp dụng pipeline đã nêu: chỉ gửi các khóa còn thiếu, chia nhỏ chúng, xử lý song song các ngôn ngữ và ghi kết quả trở lại các tệp nội dung của bạn.
+
+```bash
+npx intlayer fill
+```
+
+Một số flag giúp giới hạn phạm vi thực thi:
+
+- `--git-diff` (hoặc `--uncommitted`) chỉ xử lý các từ điển bị thay đổi trong nhánh hiện tại.
+- `--file` hoặc `--keys` nhắm mục tiêu vào các tệp nội dung cụ thể.
+- `--output-locales fr es` giới hạn thực thi cho các ngôn ngữ bạn thực sự cần lúc này.
+- `--skip-metadata` bỏ qua bước tạo tiêu đề, mô tả và thẻ tag.
+- `--data-serialization toon` gửi dữ liệu gọn gàng hơn đến mô hình (tiết kiệm token, đầu ra có thể hơi khác biệt).
+
+```bash
+npx intlayer fill --git-diff --output-locales fr es --skip-metadata
+```
+
+### 3. Dịch markdown bằng `doc translate` và `doc review`
+
+Yêu cầu agent dịch tệp `.md` đồng nghĩa với việc dán toàn bộ tài liệu cho từng ngôn ngữ sau mỗi lần thay đổi. Ngược lại, các lệnh [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md) và [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-review.md) xử lý theo từng khối.
+
+Sử dụng `doc translate` khi tệp dịch chưa tồn tại. Lệnh sẽ chia nhỏ markdown, dịch song song và tạo các tệp đích:
+
+```bash
+npx intlayer doc translate --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+Sử dụng `doc review` khi tệp dịch đã tồn tại. Lệnh sẽ so sánh từng khối với tài liệu gốc, bỏ qua các khối đã được dịch hoặc không đổi, và chỉ gửi các khối có sự khác biệt:
+
+```bash
+npx intlayer doc review --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+Cả hai lệnh đều tiếp nhận các quy tắc của bạn một lần duy nhất, tránh việc phải lặp lại trong mọi prompt:
+
+```bash
+npx intlayer doc translate --custom-instructions "Do not translate URLs. Keep the markdown structure and the code blocks untouched."
+```
+
+Hai chế độ của `doc review` rất hữu ích khi agent cần tham gia vào quy trình mà không làm phát sinh lệnh gọi AI nào từ phía Intlayer:
+
+- `--mode report` ghi lại các khối cần chú ý kèm theo số dòng, giúp agent chỉ chỉnh sửa các khối đó.
+- `--mode synthesis` chỉ thông báo tài liệu nào đã cập nhật và tài liệu nào còn các khối cần chỉnh sửa.
+
+```bash
+npx intlayer doc review --mode report --locales fr
+```
+
+### 4. Để agent gọi CLI thông qua máy chủ MCP
+
+Với [máy chủ Intlayer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/mcp_server.md), agent trả lời dựa trên tài liệu mới nhất và tự chạy `intlayer fill` hoặc `intlayer doc review` thay vì triển khai lại logic đó trong cuộc hội thoại.
+
+```bash
+claude mcp add intlayer npx -y @intlayer/mcp
+```
+
+Cài đặt [Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/agent_skills.md) với `npx intlayer init skills` cũng giúp ngăn agent phỏng đoán API của Intlayer và đọc lại tài liệu trong mỗi tác vụ.
+
+### 5. Tái sử dụng gói đăng ký Claude với `claude setup-token`
+
+Chạy cấu hình i18n trong phiên Claude Code tương tác sẽ lưu toàn bộ lịch sử trò chuyện trong ngữ cảnh. Hãy chuyển tác vụ nặng này sang một phiên headless ngắn gọn.
+
+Tạo token dài hạn từ gói đăng ký Claude của bạn:
+
+```bash
+claude setup-token
+```
+
+Lưu dưới dạng `CLAUDE_CODE_OAUTH_TOKEN` (trong tệp `.env` hoặc trong bí mật CI của bạn), sau đó tái sử dụng cho phiên chạy đơn lẻ thực thi các lệnh Intlayer:
+
+```bash
+CLAUDE_CODE_OAUTH_TOKEN=... claude -p "Run npx intlayer extract on src/components, then npx intlayer fill --uncommitted"
+```
+
+Phiên này chỉ mang theo prompt đó và kết quả đầu ra của lệnh, không bao gồm toàn bộ cuộc trò chuyện trước đây. Token tương tự cũng hoạt động trong [Claude Code GitHub Action](https://github.com/anthropics/claude-code-action) để chạy `intlayer fill` trên mỗi pull request.
+
+> Token được cấp bởi `claude setup-token` chỉ xác thực cho Claude Code. Token này không thể sử dụng làm khóa Anthropic API trong `ai.apiKey`. Đối với bản dịch, `intlayer fill` sử dụng [tài khoản Intlayer](https://app.intlayer.org) của bạn (đã bao gồm gói miễn phí) hoặc khóa nhà cung cấp riêng được cấu hình trong [`ai`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md#ai-configuration).
+
+## Tóm tắt
+
+| Tác vụ                              | Người thực hiện          | Token trong ngữ cảnh của agent |
+| ----------------------------------- | ------------------------ | ------------------------------ |
+| Quyết định nội dung cần bản địa hóa | Claude Code              | Thấp                           |
+| Trích xuất chuỗi văn bản            | `intlayer extract`       | Không có                       |
+| Dịch nội dung                       | `intlayer fill`          | Không có                       |
+| Dịch tài liệu                       | `intlayer doc translate` | Không có                       |
+| Cập nhật tài liệu                   | `intlayer doc review`    | Không có                       |
+| Chạy các lệnh                       | Headless Claude Code     | Prompt + đầu ra của lệnh       |

package/frequent_questions/zh/claude_code_token_consumption.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: 如何限制 Claude Code 生成翻译时的 Token 消耗
+description: 为什么使用 Claude Code 进行翻译会大量消耗 Token，Intlayer 如何取而代之（过滤已翻译的键、切分 JSON、逐块翻译 Markdown），以及如何通过 claude setup-token 复用 Claude 订阅。
+keywords:
+  - claude code
+  - tokens
+  - token 消耗
+  - setup-token
+  - i18n
+  - 国际化
+  - 翻译
+  - fill
+  - mcp
+  - agent
+slugs:
+  - frequent-questions
+  - claude-code-token-consumption
+author: aymericzip
+---
+
+# 如何限制 Claude Code 生成翻译时的 Token 消耗
+
+## 问题描述
+
+让 Claude Code（或任何编码 Agent）直接翻译内容是最昂贵的做法。每次执行时，Agent 都必须：
+
+- 将整个 JSON 或内容文件加载到上下文中，甚至包括已经翻译过的键。
+- 检索相关文件以确定内容的存放位置和结构。
+- 分析缺少哪些语言环境（Locales）并需要生成。
+- 每次都要重新阅读您的自定义指令（“按此规则转换 URL”，“保留英文品牌名称”，“使用非正式语气”等）。
+- 重写整个文件，包括未发生变动的部分。
+
+所有这些内容在每次对话轮次中都会被重新发送，导致成本随着 `内容大小 × 语言环境数量 × 对话轮次` 呈倍数增长，而且格式或键名出现的任何偏差都必须手动排查。
+
+## Intlayer 采取的替代方案
+
+Intlayer 的优势在于将这些工作移至 Agent 之外，通过专为翻译构建的流水线来完成：
+
+- **过滤已存在的翻译**以限制 Token 消耗。JSON 中已翻译的键会被剥离，仅将缺失的键发送给模型。
+- **逐块翻译 Markdown。** 对于文档，[`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-translate.md) 与 [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-review.md) 会将每个文本块与基础文档进行比对，直接跳过已翻译或未更改的块。
+- **超大 JSON 自动分块（Chunking）**，使其始终处于上下文窗口的最佳处理区间内。
+- **扁平化与重构 JSON** 以优化 Token 消耗。
+- **插入自定义 Prompt** 以适配品牌与术语规则（`applicationContext`, `--custom-instructions`），只需编写一次，无需在每次对话中反复传递。
+- **校验数据结构**以确保一致性并防止键名漂移，同时完整保留原始排版格式（Markdown、HTML、插值、复数等）。
+- **内置重试机制**以应对输出格式错误。
+- **请求排队与并行处理**跨文件、分块和语言环境，显著提高翻译速度。
+
+所有这些工作都不会占用 Agent 的上下文。黄金法则是：让 Agent 决定**需要国际化什么**，而让 Intlayer 处理繁重的重复性流水线。
+
+## 解决方案
+
+### 1. 将提取工作委托给 `intlayer extract`
+
+无需让 Agent 手动重写每个组件，直接运行 [`extract`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 命令即可。它会将硬编码字符串提取到组件同目录下的 `.content` 文件中，而不会将完整文件加载到 Agent 上下文中。
+
+```bash
+npx intlayer extract --file src/components/Header.tsx
+```
+
+### 2. 将翻译工作委托给 `intlayer fill`
+
+切勿让 Agent 直接进行翻译。[`fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) 命令会自动应用上述流水线：只发送缺失的键、进行分块、并行处理各个语言环境，并将结果写回内容文件中。
+
+```bash
+npx intlayer fill
+```
+
+通过几个参数可以精简执行范围：
+
+- `--git-diff`（或 `--uncommitted`）仅处理当前分支中发生更改的字典。
+- `--file` 或 `--keys` 针对特定的内容文件。
+- `--output-locales fr es` 仅限制在当前实际需要的语言环境中。
+- `--skip-metadata` 跳过标题、描述和标签的生成。
+- `--data-serialization toon` 向模型发送更紧凑的数据格式（更少的 Token，输出略微不可控）。
+
+```bash
+npx intlayer fill --git-diff --output-locales fr es --skip-metadata
+```
+
+### 3. 使用 `doc translate` 与 `doc review` 翻译 Markdown
+
+让 Agent 翻译 `.md` 文件意味着每次修改都要在每个语言环境中粘贴整个文档。而 [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-translate.md) 和 [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-review.md) 命令则是按文本块逐步处理的。
+
+当目标翻译文件尚不存在时，使用 `doc translate`。它会将 Markdown 分块、并行翻译并写入目标文件：
+
+```bash
+npx intlayer doc translate --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+当翻译文件已存在时，使用 `doc review`。它会将每个块与基础文档对比，跳过已翻译或未更改的块，仅发送有差异的块：
+
+```bash
+npx intlayer doc review --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+这两个命令均支持一次性设置规则，无需在每次提示词中重复：
+
+```bash
+npx intlayer doc translate --custom-instructions "Do not translate URLs. Keep the markdown structure and the code blocks untouched."
+```
+
+在需要 Agent 参与但无需 Intlayer 发起 AI 调用的场景下，`doc review` 的两种模式非常实用：
+
+- `--mode report` 输出需要关注的文本块及行号，让 Agent 仅修改这些特定块。
+- `--mode synthesis` 仅输出哪些文档是最新的，哪些文档仍有待编辑的块。
+
+```bash
+npx intlayer doc review --mode report --locales fr
+```
+
+### 4. 让 Agent 通过 MCP 服务调用 CLI
+
+借助 [Intlayer MCP 服务](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)，Agent 可以依据最新的文档回答，并自行执行 `intlayer fill` 或 `intlayer doc review`，而无需在对话中重新实现这些逻辑。
+
+```bash
+claude mcp add intlayer npx -y @intlayer/mcp
+```
+
+通过 `npx intlayer init skills` 安装 [Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)，还可以避免 Agent 盲目猜测 Intlayer API 或在每个任务中重复阅读文档。
+
+### 5. 通过 `claude setup-token` 复用 Claude 订阅
+
+在交互式 Claude Code 会话中运行国际化设置会将整个对话历史保留在上下文中。将繁重的工作移至简短的无头（Headless）会话中执行：
+
+从 Claude 订阅中生成长效 Token：
+
+```bash
+claude setup-token
+```
+
+将其存储为 `CLAUDE_CODE_OAUTH_TOKEN`（保存在 `.env` 文件或 CI 环境变量中），然后在单次会话中复用它以运行 Intlayer 命令：
+
+```bash
+CLAUDE_CODE_OAUTH_TOKEN=... claude -p "Run npx intlayer extract on src/components, then npx intlayer fill --uncommitted"
+```
+
+该会话仅包含该 Prompt 和命令输出，无需携带冗长的对话上下文。同一个 Token 也可以在 [Claude Code GitHub Action](https://github.com/anthropics/claude-code-action) 中使用，从而在每次 Pull Request 时运行 `intlayer fill`。
+
+> 通过 `claude setup-token` 颁发的 Token 仅用于 Claude Code 认证。它不能在 `ai.apiKey` 中作为 Anthropic API Key 使用。对于翻译本身，`intlayer fill` 会使用您的 [Intlayer 账户](https://app.intlayer.org)（包含免费额度）或在 [`ai`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中配置的专属模型 Key。
+
+## 总结
+
+| 任务               | 执行者                   | Agent 上下文中的 Token 消耗 |
+| ------------------ | ------------------------ | --------------------------- |
+| 决定要本地化的内容 | Claude Code              | 低                          |
+| 提取文本字符串     | `intlayer extract`       | 无                          |
+| 翻译声明内容       | `intlayer fill`          | 无                          |
+| 翻译 Markdown 文档 | `intlayer doc translate` | 无                          |
+| 更新 Markdown 文档 | `intlayer doc review`    | 无                          |
+| 批量执行命令       | Headless Claude Code     | 仅 Prompt + 命令输出        |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.5.1",
+  "version": "9.5.3",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,14 +73,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.5.1",
-    "@intlayer/core": "9.5.1",
-    "@intlayer/types": "9.5.1"
+    "@intlayer/config": "9.5.3",
+    "@intlayer/core": "9.5.3",
+    "@intlayer/types": "9.5.3"
   },
   "devDependencies": {
-    "@intlayer/api": "9.5.1",
-    "@intlayer/cli": "9.5.1",
-    "@types/node": "26.5.0",
+    "@intlayer/api": "9.5.3",
+    "@intlayer/cli": "9.5.3",
+    "@types/node": "^22",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",

package/src/generated/blog.entry.ts

@@ -145,6 +145,26 @@ export const blogEntry = {
     vi: readLocale('detecting_missing_translations.md', 'vi'),
     uk: readLocale('detecting_missing_translations.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/history_of_i18n.md': {
+    en: readLocale('history_of_i18n.md', 'en'),
+    es: readLocale('history_of_i18n.md', 'es'),
+    ru: readLocale('history_of_i18n.md', 'ru'),
+    ja: readLocale('history_of_i18n.md', 'ja'),
+    fr: readLocale('history_of_i18n.md', 'fr'),
+    ko: readLocale('history_of_i18n.md', 'ko'),
+    zh: readLocale('history_of_i18n.md', 'zh'),
+    de: readLocale('history_of_i18n.md', 'de'),
+    ar: readLocale('history_of_i18n.md', 'ar'),
+    it: readLocale('history_of_i18n.md', 'it'),
+    'en-GB': readLocale('history_of_i18n.md', 'en-GB'),
+    pt: readLocale('history_of_i18n.md', 'pt'),
+    hi: readLocale('history_of_i18n.md', 'hi'),
+    tr: readLocale('history_of_i18n.md', 'tr'),
+    pl: readLocale('history_of_i18n.md', 'pl'),
+    id: readLocale('history_of_i18n.md', 'id'),
+    vi: readLocale('history_of_i18n.md', 'vi'),
+    uk: readLocale('history_of_i18n.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/hreflang_guide_multilingual_seo.md': {
     en: readLocale('hreflang_guide_multilingual_seo.md', 'en'),
     es: readLocale('hreflang_guide_multilingual_seo.md', 'es'),
@@ -265,6 +285,46 @@ export const blogEntry = {
     vi: readLocale('i18n_using_next-intl.md', 'vi'),
     uk: readLocale('i18n_using_next-intl.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/i18next_vs_intlayer-i18next.md': {
+    en: readLocale('i18next_vs_intlayer-i18next.md', 'en'),
+    es: readLocale('i18next_vs_intlayer-i18next.md', 'es'),
+    ru: readLocale('i18next_vs_intlayer-i18next.md', 'ru'),
+    ja: readLocale('i18next_vs_intlayer-i18next.md', 'ja'),
+    fr: readLocale('i18next_vs_intlayer-i18next.md', 'fr'),
+    ko: readLocale('i18next_vs_intlayer-i18next.md', 'ko'),
+    zh: readLocale('i18next_vs_intlayer-i18next.md', 'zh'),
+    de: readLocale('i18next_vs_intlayer-i18next.md', 'de'),
+    ar: readLocale('i18next_vs_intlayer-i18next.md', 'ar'),
+    it: readLocale('i18next_vs_intlayer-i18next.md', 'it'),
+    'en-GB': readLocale('i18next_vs_intlayer-i18next.md', 'en-GB'),
+    pt: readLocale('i18next_vs_intlayer-i18next.md', 'pt'),
+    hi: readLocale('i18next_vs_intlayer-i18next.md', 'hi'),
+    tr: readLocale('i18next_vs_intlayer-i18next.md', 'tr'),
+    pl: readLocale('i18next_vs_intlayer-i18next.md', 'pl'),
+    id: readLocale('i18next_vs_intlayer-i18next.md', 'id'),
+    vi: readLocale('i18next_vs_intlayer-i18next.md', 'vi'),
+    uk: readLocale('i18next_vs_intlayer-i18next.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/i18next_vs_intlayer.md': {
+    en: readLocale('i18next_vs_intlayer.md', 'en'),
+    es: readLocale('i18next_vs_intlayer.md', 'es'),
+    ru: readLocale('i18next_vs_intlayer.md', 'ru'),
+    ja: readLocale('i18next_vs_intlayer.md', 'ja'),
+    fr: readLocale('i18next_vs_intlayer.md', 'fr'),
+    ko: readLocale('i18next_vs_intlayer.md', 'ko'),
+    zh: readLocale('i18next_vs_intlayer.md', 'zh'),
+    de: readLocale('i18next_vs_intlayer.md', 'de'),
+    ar: readLocale('i18next_vs_intlayer.md', 'ar'),
+    it: readLocale('i18next_vs_intlayer.md', 'it'),
+    'en-GB': readLocale('i18next_vs_intlayer.md', 'en-GB'),
+    pt: readLocale('i18next_vs_intlayer.md', 'pt'),
+    hi: readLocale('i18next_vs_intlayer.md', 'hi'),
+    tr: readLocale('i18next_vs_intlayer.md', 'tr'),
+    pl: readLocale('i18next_vs_intlayer.md', 'pl'),
+    id: readLocale('i18next_vs_intlayer.md', 'id'),
+    vi: readLocale('i18next_vs_intlayer.md', 'vi'),
+    uk: readLocale('i18next_vs_intlayer.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/icu_message_format.md': {
     en: readLocale('icu_message_format.md', 'en'),
     es: readLocale('icu_message_format.md', 'es'),
@@ -565,6 +625,46 @@ export const blogEntry = {
     vi: readLocale('l10n_platform_alternative/phrase.md', 'vi'),
     uk: readLocale('l10n_platform_alternative/phrase.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/lingui_vs_intlayer-lingui.md': {
+    en: readLocale('lingui_vs_intlayer-lingui.md', 'en'),
+    es: readLocale('lingui_vs_intlayer-lingui.md', 'es'),
+    ru: readLocale('lingui_vs_intlayer-lingui.md', 'ru'),
+    ja: readLocale('lingui_vs_intlayer-lingui.md', 'ja'),
+    fr: readLocale('lingui_vs_intlayer-lingui.md', 'fr'),
+    ko: readLocale('lingui_vs_intlayer-lingui.md', 'ko'),
+    zh: readLocale('lingui_vs_intlayer-lingui.md', 'zh'),
+    de: readLocale('lingui_vs_intlayer-lingui.md', 'de'),
+    ar: readLocale('lingui_vs_intlayer-lingui.md', 'ar'),
+    it: readLocale('lingui_vs_intlayer-lingui.md', 'it'),
+    'en-GB': readLocale('lingui_vs_intlayer-lingui.md', 'en-GB'),
+    pt: readLocale('lingui_vs_intlayer-lingui.md', 'pt'),
+    hi: readLocale('lingui_vs_intlayer-lingui.md', 'hi'),
+    tr: readLocale('lingui_vs_intlayer-lingui.md', 'tr'),
+    pl: readLocale('lingui_vs_intlayer-lingui.md', 'pl'),
+    id: readLocale('lingui_vs_intlayer-lingui.md', 'id'),
+    vi: readLocale('lingui_vs_intlayer-lingui.md', 'vi'),
+    uk: readLocale('lingui_vs_intlayer-lingui.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/lingui_vs_intlayer.md': {
+    en: readLocale('lingui_vs_intlayer.md', 'en'),
+    es: readLocale('lingui_vs_intlayer.md', 'es'),
+    ru: readLocale('lingui_vs_intlayer.md', 'ru'),
+    ja: readLocale('lingui_vs_intlayer.md', 'ja'),
+    fr: readLocale('lingui_vs_intlayer.md', 'fr'),
+    ko: readLocale('lingui_vs_intlayer.md', 'ko'),
+    zh: readLocale('lingui_vs_intlayer.md', 'zh'),
+    de: readLocale('lingui_vs_intlayer.md', 'de'),
+    ar: readLocale('lingui_vs_intlayer.md', 'ar'),
+    it: readLocale('lingui_vs_intlayer.md', 'it'),
+    'en-GB': readLocale('lingui_vs_intlayer.md', 'en-GB'),
+    pt: readLocale('lingui_vs_intlayer.md', 'pt'),
+    hi: readLocale('lingui_vs_intlayer.md', 'hi'),
+    tr: readLocale('lingui_vs_intlayer.md', 'tr'),
+    pl: readLocale('lingui_vs_intlayer.md', 'pl'),
+    id: readLocale('lingui_vs_intlayer.md', 'id'),
+    vi: readLocale('lingui_vs_intlayer.md', 'vi'),
+    uk: readLocale('lingui_vs_intlayer.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/build-tools/vite.md': {
     en: readLocale('list_i18n_technologies/build-tools/vite.md', 'en'),
     es: readLocale('list_i18n_technologies/build-tools/vite.md', 'es'),
@@ -860,6 +960,46 @@ export const blogEntry = {
     vi: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'vi'),
     uk: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/next-intl_vs_intlayer-next-intl.md': {
+    en: readLocale('next-intl_vs_intlayer-next-intl.md', 'en'),
+    es: readLocale('next-intl_vs_intlayer-next-intl.md', 'es'),
+    ru: readLocale('next-intl_vs_intlayer-next-intl.md', 'ru'),
+    ja: readLocale('next-intl_vs_intlayer-next-intl.md', 'ja'),
+    fr: readLocale('next-intl_vs_intlayer-next-intl.md', 'fr'),
+    ko: readLocale('next-intl_vs_intlayer-next-intl.md', 'ko'),
+    zh: readLocale('next-intl_vs_intlayer-next-intl.md', 'zh'),
+    de: readLocale('next-intl_vs_intlayer-next-intl.md', 'de'),
+    ar: readLocale('next-intl_vs_intlayer-next-intl.md', 'ar'),
+    it: readLocale('next-intl_vs_intlayer-next-intl.md', 'it'),
+    'en-GB': readLocale('next-intl_vs_intlayer-next-intl.md', 'en-GB'),
+    pt: readLocale('next-intl_vs_intlayer-next-intl.md', 'pt'),
+    hi: readLocale('next-intl_vs_intlayer-next-intl.md', 'hi'),
+    tr: readLocale('next-intl_vs_intlayer-next-intl.md', 'tr'),
+    pl: readLocale('next-intl_vs_intlayer-next-intl.md', 'pl'),
+    id: readLocale('next-intl_vs_intlayer-next-intl.md', 'id'),
+    vi: readLocale('next-intl_vs_intlayer-next-intl.md', 'vi'),
+    uk: readLocale('next-intl_vs_intlayer-next-intl.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/next-intl_vs_intlayer.md': {
+    en: readLocale('next-intl_vs_intlayer.md', 'en'),
+    es: readLocale('next-intl_vs_intlayer.md', 'es'),
+    ru: readLocale('next-intl_vs_intlayer.md', 'ru'),
+    ja: readLocale('next-intl_vs_intlayer.md', 'ja'),
+    fr: readLocale('next-intl_vs_intlayer.md', 'fr'),
+    ko: readLocale('next-intl_vs_intlayer.md', 'ko'),
+    zh: readLocale('next-intl_vs_intlayer.md', 'zh'),
+    de: readLocale('next-intl_vs_intlayer.md', 'de'),
+    ar: readLocale('next-intl_vs_intlayer.md', 'ar'),
+    it: readLocale('next-intl_vs_intlayer.md', 'it'),
+    'en-GB': readLocale('next-intl_vs_intlayer.md', 'en-GB'),
+    pt: readLocale('next-intl_vs_intlayer.md', 'pt'),
+    hi: readLocale('next-intl_vs_intlayer.md', 'hi'),
+    tr: readLocale('next-intl_vs_intlayer.md', 'tr'),
+    pl: readLocale('next-intl_vs_intlayer.md', 'pl'),
+    id: readLocale('next-intl_vs_intlayer.md', 'id'),
+    vi: readLocale('next-intl_vs_intlayer.md', 'vi'),
+    uk: readLocale('next-intl_vs_intlayer.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/nextjs-multilingual-seo-comparison.md': {
     en: readLocale('nextjs-multilingual-seo-comparison.md', 'en'),
     es: readLocale('nextjs-multilingual-seo-comparison.md', 'es'),
@@ -986,6 +1126,26 @@ export const blogEntry = {
     vi: readLocale('transform_existing_vite_react_app_using_compiler.md', 'vi'),
     uk: readLocale('transform_existing_vite_react_app_using_compiler.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/vue-i18n_vs_intlayer-vue-i18n.md': {
+    en: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'en'),
+    es: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'es'),
+    ru: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'ru'),
+    ja: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'ja'),
+    fr: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'fr'),
+    ko: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'ko'),
+    zh: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'zh'),
+    de: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'de'),
+    ar: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'ar'),
+    it: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'it'),
+    'en-GB': readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'en-GB'),
+    pt: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'pt'),
+    hi: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'hi'),
+    tr: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'tr'),
+    pl: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'pl'),
+    id: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'id'),
+    vi: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'vi'),
+    uk: readLocale('vue-i18n_vs_intlayer-vue-i18n.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/vue-i18n_vs_intlayer.md': {
     en: readLocale('vue-i18n_vs_intlayer.md', 'en'),
     es: readLocale('vue-i18n_vs_intlayer.md', 'es'),
@@ -1006,6 +1166,26 @@ export const blogEntry = {
     vi: readLocale('vue-i18n_vs_intlayer.md', 'vi'),
     uk: readLocale('vue-i18n_vs_intlayer.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/vue-i18n_vs_intlayer_benchmark.md': {
+    en: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'en'),
+    es: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'es'),
+    ru: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'ru'),
+    ja: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'ja'),
+    fr: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'fr'),
+    ko: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'ko'),
+    zh: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'zh'),
+    de: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'de'),
+    ar: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'ar'),
+    it: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'it'),
+    'en-GB': readLocale('vue-i18n_vs_intlayer_benchmark.md', 'en-GB'),
+    pt: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'pt'),
+    hi: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'hi'),
+    tr: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'tr'),
+    pl: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'pl'),
+    id: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'id'),
+    vi: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'vi'),
+    uk: readLocale('vue-i18n_vs_intlayer_benchmark.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/what_is_internationalization.md': {
     en: readLocale('what_is_internationalization.md', 'en'),
     es: readLocale('what_is_internationalization.md', 'es'),

package/src/generated/docs.entry.ts

@@ -325,26 +325,6 @@ export const docsEntry = {
     vi: readLocale('cli/build.md', 'vi'),
     uk: readLocale('cli/build.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
-  './docs/en/cli/ci.md': {
-    en: readLocale('cli/ci.md', 'en'),
-    es: readLocale('cli/ci.md', 'es'),
-    ru: readLocale('cli/ci.md', 'ru'),
-    ja: readLocale('cli/ci.md', 'ja'),
-    fr: readLocale('cli/ci.md', 'fr'),
-    ko: readLocale('cli/ci.md', 'ko'),
-    zh: readLocale('cli/ci.md', 'zh'),
-    de: readLocale('cli/ci.md', 'de'),
-    ar: readLocale('cli/ci.md', 'ar'),
-    it: readLocale('cli/ci.md', 'it'),
-    'en-GB': readLocale('cli/ci.md', 'en-GB'),
-    pt: readLocale('cli/ci.md', 'pt'),
-    hi: readLocale('cli/ci.md', 'hi'),
-    tr: readLocale('cli/ci.md', 'tr'),
-    pl: readLocale('cli/ci.md', 'pl'),
-    id: readLocale('cli/ci.md', 'id'),
-    vi: readLocale('cli/ci.md', 'vi'),
-    uk: readLocale('cli/ci.md', 'uk'),
-  } as unknown as Record<LocalesValues, Promise<string>>,
   './docs/en/cli/configuration.md': {
     en: readLocale('cli/configuration.md', 'en'),
     es: readLocale('cli/configuration.md', 'es'),

package/src/generated/frequentQuestions.entry.ts

@@ -191,6 +191,26 @@ export const frequentQuestionsEntry = {
     vi: readLocale('bun_set_up.md', 'vi'),
     uk: readLocale('bun_set_up.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './frequent_questions/en/claude_code_token_consumption.md': {
+    en: readLocale('claude_code_token_consumption.md', 'en'),
+    es: readLocale('claude_code_token_consumption.md', 'es'),
+    ru: readLocale('claude_code_token_consumption.md', 'ru'),
+    ja: readLocale('claude_code_token_consumption.md', 'ja'),
+    fr: readLocale('claude_code_token_consumption.md', 'fr'),
+    ko: readLocale('claude_code_token_consumption.md', 'ko'),
+    zh: readLocale('claude_code_token_consumption.md', 'zh'),
+    de: readLocale('claude_code_token_consumption.md', 'de'),
+    ar: readLocale('claude_code_token_consumption.md', 'ar'),
+    it: readLocale('claude_code_token_consumption.md', 'it'),
+    'en-GB': readLocale('claude_code_token_consumption.md', 'en-GB'),
+    pt: readLocale('claude_code_token_consumption.md', 'pt'),
+    hi: readLocale('claude_code_token_consumption.md', 'hi'),
+    tr: readLocale('claude_code_token_consumption.md', 'tr'),
+    pl: readLocale('claude_code_token_consumption.md', 'pl'),
+    id: readLocale('claude_code_token_consumption.md', 'id'),
+    vi: readLocale('claude_code_token_consumption.md', 'vi'),
+    uk: readLocale('claude_code_token_consumption.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/customized_locale_list.md': {
     en: readLocale('customized_locale_list.md', 'en'),
     es: readLocale('customized_locale_list.md', 'es'),