@intlayer/docs 5.8.1-canary.0 → 6.0.0-canary.0

package/docs/zh/intlayer_with_vite+preact.md

@@ -1108,38 +1108,38 @@ const App = () => (
 module.exports = App;
 ```
 
-同时，您还可以使用 `intLayerMiddlewarePlugin` 为您的应用程序添加服务器端路由。该插件将根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果仍未检测到语言环境，则会重定向到默认语言环境。
+同时，您还可以使用 `intlayerMiddlewarePlugin` 为您的应用程序添加服务器端路由。该插件将根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果仍未检测到语言环境，则会重定向到默认语言环境。
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import preact from "@preact/preset-vite";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [preact(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [preact(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import preact from "@preact/preset-vite";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [preact(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [preact(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const preact = require("@preact/preset-vite");
-const { intlayerPlugin, intLayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayerPlugin, intlayerMiddlewarePlugin } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [preact(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [preact(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 

package/docs/zh/intlayer_with_vite+react.md

@@ -1003,38 +1003,38 @@ const App = () => (
 );
 ```
 
-同时，您还可以使用 `intLayerMiddlewarePlugin` 为您的应用程序添加服务器端路由。该插件将根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果未检测到任何语言环境，它将重定向到默认语言环境。
+同时，您还可以使用 `intlayerMiddlewarePlugin` 为您的应用程序添加服务器端路由。该插件将根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果未检测到任何语言环境，它将重定向到默认语言环境。
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [react(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [react(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const react = require("@vitejs/plugin-react-swc");
-const { intlayerPlugin, intLayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayerPlugin, intlayerMiddlewarePlugin } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [react(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [react(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 

package/docs/zh/intlayer_with_vite+vue.md

@@ -677,38 +677,38 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 </template>
 ```
 
-同时，你也可以使用 `intLayerMiddlewarePlugin` 为你的应用添加服务器端路由。该插件会根据 URL 自动检测当前语言环境并设置相应的语言环境 cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果仍未检测到语言环境，则会重定向到默认语言环境。
+同时，你也可以使用 `intlayerMiddlewarePlugin` 为你的应用添加服务器端路由。该插件会根据 URL 自动检测当前语言环境并设置相应的语言环境 cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果仍未检测到语言环境，则会重定向到默认语言环境。
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [vue(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [vue(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const vue = require("@vitejs/plugin-vue");
-const { intlayerPlugin, intLayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayerPlugin, intlayerMiddlewarePlugin } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [vue(), intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [vue(), intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 

package/docs/zh/packages/vite-intlayer/index.md

@@ -53,17 +53,17 @@ pnpm add vite-intlayer
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayerPlugin, intlayerMiddlewarePlugin } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayerPlugin(), intLayerMiddlewarePlugin()],
+  plugins: [intlayerPlugin(), intlayerMiddlewarePlugin()],
 });
 ```
 
 > `intlayerPlugin()` 是用于将 Intlayer 集成到 Vite 的插件。它确保内容声明文件的构建，并在开发模式下进行监控。它在 Vite 应用中定义了 Intlayer 的环境变量。此外，它还提供别名以优化性能。
 
-> `intLayerMiddlewarePlugin()` 为您的应用添加服务器端路由。该插件会根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果未检测到语言环境，则会重定向到默认语言环境。
+> `intlayerMiddlewarePlugin()` 为您的应用添加服务器端路由。该插件会根据 URL 自动检测当前语言环境并设置相应的语言环境 Cookie。如果未指定语言环境，插件将根据用户浏览器的语言偏好确定最合适的语言环境。如果未检测到语言环境，则会重定向到默认语言环境。
 
 ## 掌握您的 Vite 应用的国际化
 

package/docs/zh/readme.md

@@ -0,0 +1,261 @@
+<p align="center">
+  <a href="https://intlayer.org">
+    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.png" width="60%" alt="Intlayer 标志" />
+  </a>
+</p>
+
+<h1 align="center">
+  <strong> Intlayer：一个开源、灵活的国际化工具包，集成了 AI 驱动的翻译和内容管理系统（CMS）。</strong>
+</h1>
+
+<br />
+
+<p align="center">
+  <a href="https://intlayer.org/doc/concept/content">文档</a> •
+  <a href="https://intlayer.org/doc/environment/nextjs">Next.js</a> •
+  <a href="https://intlayer.org/doc/environment/vite-and-react">React + Vite</a> •
+  <a href="https://intlayer.org/doc/concept/cms">内容管理系统（CMS）</a> •
+  <a href="https://discord.gg/7uxamYVeCk">Discord</a>
+</p>
+<p align="center" style="margin-top:15px;">
+  <a href="https://www.npmjs.com/package/intlayer" target="_blank"><img src="https://img.shields.io/npm/v/intlayer?style=for-the-badge&labelColor=FFFFFF&color=000000&logoColor=FFFFFF" alt="npm 版本" height="24"/>
+  </a>
+    <a href="https://github.com/aymericzip/intlayer/stargazers" target="_blank"><img src="https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logo=github&logoColor=FFD700" alt="GitHub 星标" height="24"/>
+  </a>
+  <a href="https://www.npmjs.org/package/intlayer" target="_blank"><img src="https://img.shields.io/npm/dm/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="月下载量" height="24"/>
+  </a>
+  <a href="https://github.com/aymericzip/intlayer/blob/main/LICENSE"><img src="https://img.shields.io/github/license/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="许可证"/>
+  </a>
+  <a href="https://github.com/aymericzip/intlayer/commits/main"><img src="https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="最新提交"/>
+  </a>
+</p>
+
+![观看视频](https://github.com/aymericzip/intlayer/blob/main/docs/assets/demo_video.gif)
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/开始使用-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## 什么是 Intlayer？
+
+大多数国际化（i18n）库要么过于复杂，要么过于僵硬，或者不适用于现代框架。
+
+Intlayer 是一个面向网页和移动应用的**现代国际化解决方案**。  
+它与框架无关，**由人工智能驱动**，并且包含免费的**内容管理系统（CMS）和可视化编辑器**。
+
+通过**按语言区分的内容文件**、**TypeScript 自动补全**、**可摇树的词典**以及**CI/CD 集成**，Intlayer 让国际化变得更**快速、简洁和智能**。
+
+## Intlayer 的主要优势：
+
+| 功能                                                                                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                        |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="功能" width="700">                             | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和库，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true" alt="Feature" width="700">       | **基于JavaScript的内容管理**<br><br>利用JavaScript的灵活性高效地定义和管理您的内容。<br><br> - [内容声明](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **每语言内容声明文件**<br><br>通过在自动生成之前只声明一次内容，加快您的开发速度。<br><br> - [每语言内容声明文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **类型安全环境**<br><br>利用 TypeScript 确保您的内容定义和代码无错误，同时享受 IDE 自动补全的便利。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="功能" width="700">                            | **简化设置**<br><br>通过最少的配置快速启动。轻松调整国际化、路由、AI、构建和内容处理的设置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="功能" width="700">                      | **简化的内容获取**<br><br>无需为每一条内容调用 `t` 函数。使用单一钩子即可直接获取所有内容。<br><br> - [React 集成](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **一致的服务器组件实现**<br><br>完美适用于 Next.js 服务器组件，客户端和服务器组件使用相同的实现，无需在每个服务器组件之间传递你的 `t` 函数。<br><br> - [服务器组件](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                        |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **有序的代码库**<br><br>保持代码库更有条理：1 个组件 = 同一文件夹中的 1 个字典。翻译内容靠近各自的组件，提升可维护性和清晰度。<br><br> - [Intlayer 如何工作](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="功能" width="700">                            | **增强的路由功能**<br><br>全面支持应用路由，能够无缝适应复杂的应用结构，适用于 Next.js、React、Vite、Vue.js 等框架。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown 支持**<br><br>导入并解析本地文件和远程 Markdown，用于多语言内容，如隐私政策、文档等。解析并使 Markdown 元数据在代码中可访问。<br><br> - [内容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **免费可视化编辑器和内容管理系统（CMS）**<br><br>为内容创作者提供免费的可视化编辑器和内容管理系统，免去了使用本地化平台的需求。通过 Git 保持内容同步，或使用 CMS 完全或部分外部化内容。<br><br> - [Intlayer 编辑器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                    |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **可摇树内容**<br><br>可摇树内容，减少最终包的大小。按组件加载内容，排除包中未使用的内容。支持懒加载以提升应用加载效率。<br><br> - [应用构建优化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **静态渲染**<br><br>不会阻塞静态渲染。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI 驱动的翻译**<br><br>使用 Intlayer 先进的 AI 驱动翻译工具，结合您自己的 AI 提供商 / API 密钥，只需一键即可将您的网站转换为 231 种语言。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自动填充](https://intlayer.org/doc/concept/auto-fill)                        |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP 服务器集成**<br><br>提供一个 MCP（模型上下文协议）服务器，用于 IDE 自动化，使内容管理和国际化工作流程能够直接在您的开发环境中无缝进行。<br><br> - [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode 扩展**<br><br>Intlayer 提供了一个 VSCode 扩展，帮助您管理内容和翻译，构建词典，翻译内容等。<br><br> - [VSCode 扩展](https://intlayer.org/doc/zh/vs-code-extension)                                                                                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **互操作性**<br><br>支持与 react-i18next、next-i18next、next-intl 和 react-intl 的互操作。<br><br> - [Intlayer 与 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 与 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 与 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) |
+
+---
+
+## 📦 安装
+
+今天就开始使用 Intlayer，体验更顺畅、更强大的国际化方式。
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+```bash
+npm install intlayer react-intlayer
+```
+
+⚡ 快速开始 (Next.js)
+
+```ts
+// intlayer.config.ts
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```tsx
+// app/page.tsx
+import { useIntlayer } from "react-intlayer";
+
+const Component = () => {
+  const { title } = useIntlayer("home");
+
+  return <h1>{title}</h1>;
+};
+```
+
+<a href="https://intlayer.org/doc/environment/nextjs"> 获取完整指南 → </a>
+
+## 🎥 YouTube 直播教程
+
+[![如何使用 Intlayer 实现应用国际化](https://i.ytimg.com/vi/e_PPG7PTqGU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDtyJ4uYotEjl12nZ_gZKZ_kjEgOQ)](https://youtu.be/e_PPG7PTqGU?si=GyU_KpVhr61razRw)
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## 目录
+
+探索我们全面的文档，开始使用 Intlayer 并学习如何将其集成到您的项目中。
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">📘 入门指南</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/why">为什么选择 Intlayer？</a></li>
+  <li><a href="https://intlayer.org/doc">介绍</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">⚙️ 概念</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/concept/how-works-intlayer">Intlayer 如何工作</a></li>
+  <li><a href="https://intlayer.org/doc/concept/configuration">配置</a></li>
+  <li><a href="https://intlayer.org/doc/concept/ai">AI 提供者</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cli">Intlayer CLI</a></li>
+  <li><a href="https://intlayer.org/doc/concept/editor">Intlayer 编辑器</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cms">Intlayer CMS</a></li>
+  <li><a href="https://intlayer.org/doc/concept/content">词典</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file">每语言内容声明文件</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/translation">翻译</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/enumeration">枚举</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/condition">条件</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/nesting">嵌套</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/markdown">Markdown</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/function-fetching">函数获取</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/insertion">插入</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/file">文件</a></li>
+    </ul>
+  </li>
+</ul>
+</details>
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">🌐 环境</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/environment/nextjs">Intlayer 与 Next.js 15</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/14">Next.js 14（应用路由）</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router">Next.js 页面路由</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/create-react-app">React CRA</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react">Vite + React</a>
+     <ul>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7">React-router-v7</a></li>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/tanstack-start">Tanstack 入门</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/react-native-and-expo">React Native</a></li>
+  <li><a href="https://intlayer.org/doc/environment/lynx-and-react">Lynx + React</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-svelte">Vite + Svelte</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-preact">Vite + Preact</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-vue">Vite + Vue</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt">Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-solid">Vite + Solid</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular">Angular</a></li>
+  <li><a href="https://intlayer.org/doc/environment/express">Express</a></li>
+  <li><a href="https://intlayer.org/doc/environment/nest">NestJS</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">📰 博客</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/zh/what_is_internationalization.md">什么是国际化 (i18n)</a></li>
+  <li><a href="https://intlayer.org/blog/SEO-and-i18n">i18n 与 SEO</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-i18next">Intlayer 与 i18next</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-react-i18next">Intlayer 与 react-intl</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-intl">Intlayer 与 next-intl</a></li>
+</ul>
+</details>
+
+## 🌐 其他语言的自述文件
+
+[English](https://github.com/aymericzip/intlayer/blob/main/readme.md) •
+[简体中文](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/readme.md) •
+[Русский](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/readme.md) •
+[日本語](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/readme.md) •
+[Français](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/readme.md) •
+[한국어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/readme.md) •
+[Español](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/readme.md) •
+[德语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/readme.md) •
+[阿拉伯语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/readme.md) •
+[意大利语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/readme.md) •
+[英语（英国）](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/readme.md) •
+[葡萄牙语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/readme.md) •
+[印地语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/readme.md)
+[土耳其语](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/readme.md)
+
+## 🤝 社区
+
+Intlayer 是为社区而建，也由社区共同打造，我们非常欢迎您的反馈！
+
+- 有建议？[提出问题](https://github.com/aymericzip/intlayer/issues)
+- 发现了漏洞或改进建议？[提交一个 PR](https://github.com/aymericzip/intlayer/pulls)
+- 需要帮助或想要交流？[加入我们的 Discord](https://discord.gg/7uxamYVeCk)
+
+你也可以关注我们：
+
+  <div>
+    <br/>
+    <p align="center">
+      <a href="https://discord.gg/528mBV4N" target="blank"><img align="center"
+         src="https://img.shields.io/badge/discord-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white"
+         alt="Intlayer Discord" height="30"/></a>
+      <a href="https://www.linkedin.com/company/intlayerorg" target="blank"><img align="center"
+         src="https://img.shields.io/badge/linkedin-%231DA1F2.svg?style=for-the-badge&logo=linkedin&logoColor=white"
+         alt="Intlayer LinkedIn" height="30"/></a>
+      <a href="https://www.facebook.com/intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/facebook-4267B2.svg?style=for-the-badge&logo=facebook&logoColor=white"
+         alt="Intlayer 脸书" height="30"/></a>
+      <a href="https://www.instagram.com/intlayer/" target="blank"><img align="center"
+         src="https://img.shields.io/badge/instagram-%23E4405F.svg?style=for-the-badge&logo=Instagram&logoColor=white"
+         alt="Intlayer Instagram" height="30"/></a>
+      <a href="https://x.com/Intlayer183096" target="blank"><img align="center"
+         src="https://img.shields.io/badge/x-1DA1F2.svg?style=for-the-badge&logo=x&logoColor=white"
+         alt="Intlayer X" height="30"/></a>
+      <a href="https://www.youtube.com/@intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/youtube-FF0000.svg?style=for-the-badge&logo=youtube&logoColor=white"
+         alt="Intlayer YouTube" height="30"/></a>
+      <a href="https://www.tiktok.com/@intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/tiktok-000000.svg?style=for-the-badge&logo=tiktok&logoColor=white"
+         alt="Intlayer TikTok" height="30"/></a>
+      <br>
+    </p>
+</div>
+
+### 贡献
+
+有关贡献本项目的更详细指南，请参阅 [`CONTRIBUTING.md`](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md) 文件。该文件包含了我们开发流程、提交信息规范以及发布流程的关键信息。您的贡献对我们非常重要，我们感谢您为改进本项目所做的努力！
+
+### 感谢您的支持
+
+如果您喜欢 Intlayer，请在 GitHub 上给我们一个⭐。这将帮助更多人发现该项目！
+
+[![Star History Chart](https://api.star-history.com/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.com/#aymericzip/intlayer&Date)

package/docs/zh/testing.md

@@ -0,0 +1,198 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-09-20
+title: 测试您的内容
+description: 了解如何使用 Intlayer 测试您的内容。
+keywords:
+  - 测试
+  - Intlayer
+  - 国际化
+  - CMS
+  - 内容管理系统
+  - 可视化编辑器
+slugs:
+  - doc
+  - testing
+---
+
+# 测试您的内容
+
+本指南展示了如何自动验证您的字典是否完整，在发布前捕获缺失的翻译，并测试您应用中的本地化 UI。
+
+---
+
+## 您可以测试的内容
+
+- **缺失的翻译**：如果任何字典缺少必需的语言环境，则使 CI 失败。
+- **本地化 UI 渲染**：使用特定的语言环境提供者渲染组件，并断言可见的文本/属性。
+- **构建时审计**：通过 CLI 在本地运行快速审计。
+
+---
+
+## 快速开始：通过 CLI 审计
+
+从您的项目根目录运行审计：
+
+```bash
+npx intlayer content test
+```
+
+有用的参数：
+
+- `--env-file [路径]`：从文件加载环境变量。
+- `-e, --env [名称]`：选择环境配置。
+- `--base-dir [路径]`：设置应用的基础目录以进行解析。
+- `--verbose`：显示详细日志。
+- `--prefix [标签]`：为日志行添加前缀。
+
+注意：CLI 会打印详细报告，但在失败时不会以非零状态退出。对于 CI 门控，请添加下面的单元测试，断言没有缺失的必需语言环境。
+
+---
+
+## 编程测试（Vitest/Jest）
+
+使用 Intlayer CLI API 断言您的必需语言环境没有缺失的翻译。
+
+```ts file=i18n.test.ts
+/* @vitest-environment node */
+import { listMissingTranslations } from "intlayer/cli";
+import { describe, expect, it } from "vitest";
+
+describe("翻译", () => {
+  it("没有缺失的必需语言环境", () => {
+    const result = listMissingTranslations();
+
+    if (result.missingRequiredLocales.length > 0) {
+      // 当测试在本地或CI中失败时，这很有帮助
+      console.log(result.missingTranslations);
+    }
+
+    expect(result.missingRequiredLocales).toHaveLength(0);
+  });
+});
+```
+
+Jest 等效代码：
+
+```ts file=i18n.test.ts
+import { listMissingTranslations } from "intlayer/cli";
+
+test("没有缺失的必需语言环境", () => {
+  const result = listMissingTranslations();
+
+  if (result.missingRequiredLocales.length > 0) {
+    // eslint-disable-next-line no-console
+    console.log(result.missingTranslations);
+  }
+
+  expect(result.missingRequiredLocales).toHaveLength(0);
+});
+```
+
+工作原理：
+
+- Intlayer 读取您的配置（locales、requiredLocales）和声明的字典，然后报告：
+  - `missingTranslations`：按键，缺失了哪些语言及其对应的文件。
+  - `missingLocales`：所有缺失语言的合集。
+  - `missingRequiredLocales`：限制为 `requiredLocales` 的子集（如果未设置 `requiredLocales`，则为所有语言）。
+
+---
+
+## 测试本地化 UI（React / Next.js）
+
+在 Intlayer 提供者下渲染组件，并断言可见内容。
+
+React 示例（Testing Library）：
+
+```tsx
+import { IntlayerProvider } from "react-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyComponent } from "./MyComponent";
+
+test("renders localized title in English", () => {
+  render(
+    <IntlayerProvider locale="en-US">
+      <MyComponent />
+    </IntlayerProvider>
+  );
+
+  expect(screen.getByText("预期的英文标题")).toBeInTheDocument();
+});
+```
+
+Next.js（App Router）示例：使用框架包装器：
+
+```tsx
+import { IntlayerClientProvider } from "next-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyPage } from "./MyPage";
+
+test("渲染法语本地化标题", () => {
+  render(
+    <IntlayerClientProvider locale="fr-FR">
+      <MyPage />
+    </IntlayerClientProvider>
+  );
+  expect(screen.getByRole("heading", { name: "预期标题" })).toBeInTheDocument();
+});
+```
+
+提示：
+
+- 当你需要属性的原始字符串值（例如 `aria-label`）时，可以访问 React 中 `useIntlayer` 返回的 `.value` 字段。
+- 将字典与组件放在一起，便于单元测试和清理。
+
+---
+
+## 持续集成
+
+添加一个测试，当缺少必需的翻译时使构建失败。
+
+`package.json`：
+
+```json
+{
+  "scripts": {
+    "test:i18n": "vitest run -c"
+  }
+}
+```
+
+GitHub Actions 示例：
+
+```yaml
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm run test:i18n
+```
+
+可选：在测试的同时运行 CLI 审计以获得人类可读的摘要：
+
+```bash
+npx intlayer content test --verbose
+```
+
+---
+
+## 故障排除
+
+- 确保您的 Intlayer 配置定义了 `locales` 和（可选的）`requiredLocales`。
+- 如果您的应用使用动态或远程字典，请在字典可用的环境中运行测试。
+- 对于混合的 monorepos，使用 `--base-dir` 指定 CLI 指向正确的应用根目录。
+
+---
+
+## 文档历史
+
+| 版本  | 日期       | 变更说明     |
+| ----- | ---------- | ------------ |
+| 6.0.0 | 2025-09-20 | 引入测试功能 |