@intlayer/docs 6.1.6 → 7.0.0-canary.1

package/docs/zh/packages/react-intlayer/useI18n.md

@@ -19,6 +19,10 @@ slugs:
   - packages
   - react-intlayer
   - useI18n
+history:
+  - version: 6.0.0
+    date: 2025-06-29
+    changes: `useI18n` 钩子文档的初始编写
 ---
 
 # React 集成：`useI18n` Hook 文档
@@ -244,7 +248,3 @@ const ServerComponentExample = () => {
 - **Intlayer 可视化编辑器**：为了获得更直观的内容管理体验，请参阅可视化编辑器文档 [这里](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)。
 
 本节特别涵盖了在 React 应用中集成 `useI18n` 钩子，简化本地化流程并确保不同语言环境下内容的一致性。
-
-## 文档历史
-
-- 6.0.0 - 2025-06-29：`useI18n` 钩子文档的初始编写

package/docs/zh/packages/react-intlayer/useIntlayer.md

@@ -18,6 +18,10 @@ slugs:
   - packages
   - react-intlayer
   - useIntlayer
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: 初始化历史
 ---
 
 # React 集成：`useIntlayer` 钩子文档
@@ -245,7 +249,3 @@ const ServerComponentExample = () => {
 - **Intlayer 可视化编辑器**：如需更直观的内容管理体验，请参阅可视化编辑器文档 [这里](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)。
 
 本节专门针对在 React 应用中集成 `useIntlayer` 钩子，简化本地化流程，确保不同语言环境下内容的一致性。
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史

package/docs/zh/packages/react-intlayer/useLocale.md

@@ -18,6 +18,10 @@ slugs:
   - packages
   - react-intlayer
   - useLocale
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: 初始化历史
 ---
 
 # React 集成：`useLocale` Hook 文档
@@ -204,7 +208,3 @@ const LocaleSelector = () => {
 ## 结论
 
 来自 `react-intlayer` 的 `useLocale` 钩子是管理 React 应用中语言环境的关键工具，提供了适应各种国际受众所需的功能。
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29: 初始化历史

package/docs/zh/per_locale_file.md

@@ -14,6 +14,10 @@ slugs:
   - doc
   - concept
   - per-locale-file
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: 初始化历史
 ---
 
 # Intlayer 中的“每语言”内容声明
@@ -317,7 +321,3 @@ console.log(JSON.stringify(intlayer, null, 2));
 ### 自动翻译生成
 
 使用 [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_cli.md) 根据您偏好的服务自动填充缺失的翻译。
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史

package/docs/zh/roadmap.md

@@ -13,6 +13,13 @@ keywords:
 slugs:
   - doc
   - roadmap
+history:
+  - version: 5.5.10
+    date: 2025-06-30
+    changes: 新增 Preact 和 Nuxt 支持，MCP 服务器，更新 CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: 初始化历史记录
 ---
 
 # Intlayer：功能概览与路线图
@@ -328,8 +335,3 @@ Intlayer 旨在成为内容管理和国际化的一站式解决方案。它专
 敬请关注即将发布的版本，欢迎随时探索现有功能，了解 Intlayer 如何帮助您集中管理和优化内容管理流程！
 
 ---
-
-## 文档历史
-
-- 5.5.10 - 2025-06-30：新增 Preact 和 Nuxt 支持，MCP 服务器，更新 CLI
-- 5.5.10 - 2025-06-29：初始化历史记录

package/docs/zh/testing.md

@@ -13,6 +13,10 @@ keywords:
 slugs:
   - doc
   - testing
+history:
+  - version: 6.0.0
+    date: 2025-09-20
+    changes: 引入测试功能
 ---
 
 # 测试您的内容
@@ -81,7 +85,6 @@ test("没有缺失的必需语言环境", () => {
   const result = listMissingTranslations();
 
   if (result.missingRequiredLocales.length > 0) {
-    // eslint-disable-next-line no-console
     console.log(result.missingTranslations);
   }
 
@@ -190,9 +193,3 @@ npx intlayer content test --verbose
 - 对于混合的 monorepos，使用 `--base-dir` 指定 CLI 指向正确的应用根目录。
 
 ---
-
-## 文档历史
-
-| 版本  | 日期       | 变更说明     |
-| ----- | ---------- | ------------ |
-| 6.0.0 | 2025-09-20 | 引入测试功能 |

package/docs/zh/vs_code_extension.md

@@ -15,6 +15,19 @@ keywords:
 slugs:
   - doc
   - vs-code-extension
+history:
+  - version: 6.1.5
+    date: 2025-09-30
+    changes: 添加演示动图
+  - version: 6.1.0
+    date: 2025-09-24
+    changes: 新增环境选择章节
+  - version: 6.0.0
+    date: 2025-09-22
+    changes: Intlayer 标签页 / 填充与测试命令
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: 初始化历史
 ---
 
 # 官方 VS Code 扩展
@@ -118,12 +131,3 @@ Intlayer 建议将您的 AI API 密钥，以及 Intlayer 客户端 ID 和密钥
 #### 多包仓库和自定义目录
 
 如果你的 `.env` 文件位于工作区根目录之外，请在 `设置 → 扩展 → Intlayer` 中设置 **基础目录**。加载器将相对于该目录查找 `.env` 文件。
-
-## 文档历史
-
-| 版本   | 日期       | 变更内容                         |
-| ------ | ---------- | -------------------------------- |
-| 6.1.5  | 2025-09-30 | 添加演示动图                     |
-| 6.1.0  | 2025-09-24 | 新增环境选择章节                 |
-| 6.0.0  | 2025-09-22 | Intlayer 标签页 / 填充与测试命令 |
-| 5.5.10 | 2025-06-29 | 初始化历史                       |

package/frequent_questions/ar/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: أحصل على خطأ "الوحدة غير موجودة" عند استخدام bun
+description: إصلاح الخطأ عند استخدام bun.
+keywords:
+  - bun
+  - الوحدة غير موجودة
+  - intlayer
+  - التهيئة
+  - مدير الحزم
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# أحصل على خطأ "الوحدة غير موجودة" عند استخدام bun
+
+## وصف المشكلة
+
+عند استخدام bun، قد تواجه خطأ مثل هذا:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## السبب
+
+يستخدم Intlayer الدالة `require` داخليًا. و bun يحدد نطاق دالة require لتقوم بحل حزم `@intlayer/config` فقط، بدلاً من المشروع بأكمله.
+
+## الحل
+
+### توفير دالة `require` في التهيئة
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // توفير دالة require في التهيئة
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // توفير دالة require في التهيئة
+});
+
+export default configuration;
+```

package/frequent_questions/de/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Ich erhalte einen "Modul nicht gefunden"-Fehler bei der Verwendung von bun
+description: Fehlerbehebung bei der Verwendung von bun.
+keywords:
+  - bun
+  - modul nicht gefunden
+  - intlayer
+  - konfiguration
+  - paketmanager
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# Ich erhalte einen "Modul nicht gefunden"-Fehler bei der Verwendung von bun
+
+## Problembeschreibung
+
+Bei der Verwendung von bun kann folgender Fehler auftreten:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Grund
+
+Intlayer verwendet intern `require`. Und bun beschränkt die `require`-Funktion darauf, nur die Pakete des `@intlayer/config`-Pakets aufzulösen, anstatt das gesamte Projekt.
+
+## Lösung
+
+### Geben Sie die `require`-Funktion in der Konfiguration an
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // Die require-Funktion bereitstellen
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // Die require-Funktion bereitstellen
+});
+
+export default configuration;
+```

package/frequent_questions/en/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: I get module not found error when using bun
+description: Fix error when using bun.
+keywords:
+  - bun
+  - module not found
+  - intlayer
+  - configuration
+  - package manager
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# I get module not found error when using bun
+
+## Problem Description
+
+When using bun, you might encounter an error like this:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Reason
+
+Intlayer use `require` internally. And bun scope the require function to resolve only the packages of the `@intlayer/config` package, instead of the whole project.
+
+## Solution
+
+### Provide the `require` function in the configuration
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require,
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require,
+});
+
+export default configuration;
+```

package/frequent_questions/en-GB/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: I get module not found error when using bun
+description: Fix error when using bun.
+keywords:
+  - bun
+  - module not found
+  - intlayer
+  - configuration
+  - package manager
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# I get module not found error when using bun
+
+## Problem Description
+
+When using bun, you might encounter an error like this:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Reason
+
+Intlayer uses `require` internally. And bun scopes the require function to resolve only the packages of the `@intlayer/config` package, instead of the whole project.
+
+## Solution
+
+### Provide the `require` function in the configuration
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require,
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require,
+});
+
+export default configuration;
+```

package/frequent_questions/es/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Obtengo error de módulo no encontrado al usar bun
+description: Soluciona el error al usar bun.
+keywords:
+  - bun
+  - módulo no encontrado
+  - intlayer
+  - configuración
+  - gestor de paquetes
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# Obtengo error de módulo no encontrado al usar bun
+
+## Descripción del problema
+
+Al usar bun, podrías encontrar un error como este:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Razón
+
+Intlayer usa `require` internamente. Y bun limita la función require para resolver solo los paquetes del paquete `@intlayer/config`, en lugar de todo el proyecto.
+
+## Solución
+
+### Proporciona la función `require` en la configuración
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // proporciona la función require en la configuración de compilación
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // pasa la función require a la configuración de Intlayer
+});
+
+export default configuration;
+```

package/frequent_questions/fr/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Je reçois une erreur de module introuvable lors de l'utilisation de bun
+description: Corriger l'erreur lors de l'utilisation de bun.
+keywords:
+  - bun
+  - module introuvable
+  - intlayer
+  - configuration
+  - gestionnaire de paquets
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# Je reçois une erreur de module introuvable lors de l'utilisation de bun
+
+## Description du problème
+
+Lors de l'utilisation de bun, vous pouvez rencontrer une erreur comme celle-ci :
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Raison
+
+Intlayer utilise `require` en interne. Et bun limite la fonction require pour ne résoudre que les paquets du package `@intlayer/config`, au lieu de tout le projet.
+
+## Solution
+
+### Fournir la fonction `require` dans la configuration
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // fournir la fonction require dans la configuration
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // fournir la fonction require dans la configuration
+});
+
+export default configuration;
+```

package/frequent_questions/hi/bun_set_up.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: bun का उपयोग करते समय मुझे मॉड्यूल नहीं मिला त्रुटि मिलती है
+description: bun का उपयोग करते समय त्रुटि को ठीक करें।
+keywords:
+  - bun
+  - मॉड्यूल नहीं मिला
+  - intlayer
+  - कॉन्फ़िगरेशन
+  - पैकेज प्रबंधक
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# bun का उपयोग करते समय मुझे मॉड्यूल नहीं मिला त्रुटि मिलती है
+
+## समस्या विवरण
+
+जब आप bun का उपयोग करते हैं, तो आपको इस प्रकार की त्रुटि मिल सकती है:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## कारण
+
+Intlayer आंतरिक रूप से `require` का उपयोग करता है। और bun `require` फ़ंक्शन को केवल `@intlayer/config` पैकेज के पैकेजों को हल करने के लिए सीमित करता है, पूरे प्रोजेक्ट के बजाय।
+
+## समाधान
+
+### कॉन्फ़िगरेशन में `require` फ़ंक्शन प्रदान करें
+
+```ts
+ts;
+const config: IntlayerConfig = {
+  build: {
+    require, // कॉन्फ़िगरेशन में require फ़ंक्शन प्रदान करें
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // require फ़ंक्शन के साथ Intlayer कॉन्फ़िगरेशन सेट करें
+});
+
+export default configuration;
+```

package/frequent_questions/it/bun_set_up.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Ricevo un errore "module not found" quando uso bun
+description: Risolvi l'errore quando usi bun.
+keywords:
+  - bun
+  - modulo non trovato
+  - intlayer
+  - configurazione
+  - package manager
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# Ricevo un errore "module not found" quando uso bun
+
+## Descrizione del problema
+
+Quando usi bun, potresti incontrare un errore come questo:
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## Motivo
+
+Intlayer usa `require` internamente. E bun limita la funzione require a risolvere solo i pacchetti del pacchetto `@intlayer/config`, invece che dell'intero progetto.
+
+## Soluzione
+
+### Fornire la funzione `require` nella configurazione
+
+```ts
+ts;
+const config: IntlayerConfig = {
+  build: {
+    require, // fornire la funzione require nella configurazione
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // fornire la funzione require nella configurazione
+});
+
+export default configuration;
+```

package/frequent_questions/ja/bun_set_up.md

@@ -0,0 +1,54 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: bunを使用するとモジュールが見つからないエラーが発生する
+description: bun使用時のエラーを修正する方法。
+keywords:
+  - bun
+  - モジュールが見つからない
+  - intlayer
+  - 設定
+  - パッケージマネージャー
+slugs:
+  - doc
+  - faq
+  - bun-set-up
+---
+
+# bunを使用するとモジュールが見つからないエラーが発生する
+
+## 問題の説明
+
+bunを使用していると、以下のようなエラーが発生することがあります：
+
+```bash
+Cannot find package 'intlayer' from '/workspace/packages/@intlayer/config/dist/cjs/utils/ESMxCJSHelpers.cjs' undefined
+```
+
+## 原因
+
+Intlayerは内部で`require`を使用しています。しかしbunは`require`関数のスコープを`@intlayer/config`パッケージのみに限定して解決し、プロジェクト全体を対象にしません。
+
+## 解決策
+
+### 設定で`require`関数を提供する
+
+```ts
+const config: IntlayerConfig = {
+  build: {
+    require, // require関数を提供
+  },
+};
+
+export default config;
+```
+
+```ts fileName="next.config.ts" codeFormat="typescript"
+import { withIntlayer } from "next-intlayer/server";
+
+const configuration = withIntlayer({
+  require, // require関数を提供
+});
+
+export default configuration;
+```