@intlayer/docs 9.4.4 → 9.5.0

package/docs/zh/migration_from_react-i18next_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 与其将大量 JSON 文件加载到你的页面中，不如只加载必要的内容。Intlayer 帮助你**将 bundle 和页面大小减少多达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 对应用内容进行作用域划分**便于大规模应用的维护**。你可以复制或删除单个功能文件夹，而无需费力审查整个内容 codebase。此外，Intlayer **完全类型化**，确保你的内容准确性。
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态中**最活跃开发**的方案——问题修复速度快，新的 framework 适配器定期发布，core API 根据真实生产反馈不断改进。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 内容的共置**降低了大语言模型 (LLM) 所需的上下文**。Intlayer 还配备了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，让 AI agent 的开发者体验 (DX) 更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 在 CI/CD pipeline 中使用自动化翻译，使用你选择的 LLM，成本由你的 AI 提供商承担。Intlayer 还提供**编译器**来自动化内容提取，以及一个 [web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)来帮助**后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将大量 JSON 文件连接到组件可能导致性能和响应性问题。Intlayer 在构建时优化你的内容加载。
 
 </Accordion>
-
 <Accordion header="与非开发人员协作扩展">
 
 Intlayer 不仅是一个 i18n 方案，它还提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**，帮助你**实时**管理多语言内容，使与翻译人员、文案编写者和其他团队成员的协作无缝衔接。内容可以存储在本地和/或远程。
@@ -68,8 +63,6 @@ Intlayer 不仅是一个 i18n 方案，它还提供**自托管的[可视化编
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 从 `react-i18next` / `i18next` 迁移到 Intlayer 有两种互补的策略：
@@ -80,20 +73,15 @@ Intlayer 不仅是一个 i18n 方案，它还提供**自托管的[可视化编
 
 本指南先介绍 **策略 1**（即插即用兼容适配器），然后讲解可选的完整迁移。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是在零代码更改的情况下让现有 `react-i18next` 应用在 Intlayer 上运行所需的最少步骤。
 
 <Steps>
-
 <Step number={1} title="安装依赖项">
 
 安装 Intlayer 核心包和兼容性适配器：
@@ -137,7 +125,6 @@ bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intla
 > 你可以保留 `react-i18next` 和 `i18next` 已安装——兼容性适配器将它们用作 TypeScript 类型的 `devDependencies` / 可选的 `peerDependencies`。你无需更改任何 `package.json` 同级依赖。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令会创建一个启动 `intlayer.config.ts`。更新它以匹配你现有的语言环境并将 `syncJSON` 插件指向你的消息文件：
@@ -172,7 +159,6 @@ export default config;
 > **`source`** 将语言环境映射到其 JSON 文件路径。**`location`** 告诉 Intlayer 监视程序要监视哪个文件夹以查找更改。`format: 'i18next'` 选项确保正确解析 `{{name}}` 等占位符。
 
 </Step>
-
 <Step number={3} title="将 Intlayer 插件添加到你的 Bundler">
 
 使用兼容性插件包装你现有的 bundler 配置。它组成核心 Intlayer 插件，连接内容监视，以及——至关重要的是——**注入模块别名**，以便你现有的 `import … from 'react-i18next'`（和 `'i18next'`）调用在构建时透明地重定向到 `@intlayer/react-i18next` / `@intlayer/i18next`。不需要更改源文件。
@@ -233,14 +219,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ 类型化
 > ```
 
----
-
 ## 完整迁移
 
 以下步骤是可选的，可以逐步完成。它们解锁完整的 Intlayer 功能集：可视化编辑器、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式导入重命名（可选）" isOptional={true}>
 
 Intlayer 插件已在打包程序级别处理别名。如果你更希望在源文件中明确依赖关系，可以手动重命名导入：
@@ -265,7 +248,6 @@ Intlayer 插件已在打包程序级别处理别名。如果你更希望在源
 | `import { useTranslation } from 'next-i18next'`                                | `import { useTranslation } from '@intlayer/next-i18next'`         |
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 Intlayer 设置完成后，使用其 CLI 自动填充缺失的翻译：
@@ -327,8 +309,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 一旦 compat 适配器就位，以下 `react-i18next` / `i18next` 样板代码可以删除：
@@ -341,8 +321,6 @@ export default config;
 
 当您准备好进一步进行时，Intlayer **会自动发现代码库中任何位置的所有 `.content.ts` 和 `.content.json` 文件**（默认情况下，在 `./src` 内的任何位置）。您可以将 `my-component.content.ts` 文件放在 `MyComponent.tsx` 旁边，Intlayer 将在构建时选择它，无需任何额外配置 — 无需导入、无需注册、无需集中索引文件。这使得将翻译与页面和组件共址变得完全无摩擦。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intellisense。确保您的 `tsconfig.json` 包含自动生成的类型：
@@ -357,8 +335,6 @@ Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intel
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 生成的目录添加到您的 `.gitignore`：
@@ -368,8 +344,6 @@ Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intel
 .intlayer
 ```
 
----
-
 ## 进一步了解
 
 - **Visual Editor** — 在浏览器中直观地管理翻译：[Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)

package/docs/zh/migration_from_vue-i18n_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 无需将庞大的 JSON 文件加载到页面中，只加载必要的内容。Intlayer 可帮助您**将 bundle 和页面尺寸减少多达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 为应用程序的内容划分范围**便于大规模应用的维护**。您可以删除单个功能文件夹，无需费力检查整个内容代码库。此外，Intlayer **完全类型化**以确保内容的准确性。
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 —— 问题修复迅速、新 framework 适配器定期发布，核心 API 基于真实生产反馈不断优化。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 共同定位内容**减少大型语言模型 (LLM) 所需的上下文**。Intlayer 还提供了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，让开发者体验 (DX) 对 AI agents 更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用自动化在 CI/CD pipeline 中使用您选择的 LLM 进行翻译，成本由您的 AI provider 承担。Intlayer 还提供了一个 **compiler** 来自动化内容提取，以及一个 [web platform](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来帮助**后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将庞大的 JSON 文件连接到组件可能导致性能和响应式问题。Intlayer 在构建时优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="非开发人员的扩展">
 
 不仅仅是一个 i18n 解决方案，Intlayer 提供了一个**自托管的 [visual editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)** 和一个**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译、文案和其他团队成员的协作无缝。内容可以本地存储和/或远程存储。
@@ -67,8 +62,6 @@ Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 —— 问题
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 从 `vue-i18n` 迁移到 Intlayer 有两种互补的策略：
@@ -79,20 +72,15 @@ Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 —— 问题
 
 本指南首先介绍**策略 1**（即插即用兼容适配器），然后演练可选的完整迁移。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是让现有 `vue-i18n` 应用在 Intlayer 上运行所需的最少步骤，组件代码零更改。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 安装 Intlayer 核心 package 和兼容适配器：
@@ -136,7 +124,6 @@ bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
 > 您可以保留 `vue-i18n` installed —— 兼容适配器使用它作为 `devDependency` / `peerDependency` 的 TypeScript 类型。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令创建一个启动 `intlayer.config.ts`。更新它以匹配您现有的 locale，并将 `syncJSON` plugin 指向您的消息文件：
@@ -171,7 +158,6 @@ export default config;
 > **`source`** 将 locale 映射到其 JSON 文件路径。**`location`** 告诉 Intlayer watcher 监视哪个文件夹以获取更改。`format: 'icu'` 选项确保正确解析 `vue-i18n` 的占位符。
 
 </Step>
-
 <Step number={3} title="将 Intlayer Plugin 添加到您的 Bundler">
 
 用兼容 plugin 包装您现有的 bundler 配置。它组合了核心 Intlayer plugin、连接内容 watching，以及 —— 至关重要的是 —— **注入一个 module alias**，使您现有的 `import … from 'vue-i18n'` 调用在构建时透明地重定向到 `@intlayer/vue-i18n`。无需更改源文件。
@@ -222,14 +208,11 @@ export default defineNuxtConfig({
 > t("does.not.exist"); // ✗ TypeScript 错误
 > ```
 
----
-
 ## 完整迁移
 
 下面的步骤是可选的，可以逐步完成。它们解锁完整的 Intlayer 功能集：visual editor、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式 import 重命名（可选）" isOptional={true}>
 
 Intlayer plugin 已在 bundler 级别处理别名。如果您更喜欢在源文件中显式化依赖，可以手动重命名 import：
@@ -242,7 +225,6 @@ Intlayer plugin 已在 bundler 级别处理别名。如果您更喜欢在源文
 这些是**即插即用的替代品** —— 不需要改变调用签名、参数或返回类型。
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 Intlayer 连接后，使用其 CLI 自动填充缺失翻译：
@@ -304,8 +286,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 兼容适配器就位后，可以删除以下 `vue-i18n` 样板代码：
@@ -318,8 +298,6 @@ export default config;
 
 当您准备进一步进行时，Intlayer **自动发现代码库中任何地方的所有 `.content.ts` 和 `.content.json` 文件**（默认在 `./src` 内的任何地方）。您可以将 `my-component.content.ts` 文件放在 `MyComponent.vue` 旁边，Intlayer 会在构建时选中它，无需额外配置 —— 无需 import、无需注册、无需集中索引文件。这使得与页面和组件共同定位翻译完全无摩擦。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用 module augmentation 为您的 translation key 提供完整的 TypeScript intellisense。确保您的 `tsconfig.json` 包括自动生成的类型：
@@ -334,8 +312,6 @@ Intlayer 使用 module augmentation 为您的 translation key 提供完整的 Ty
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 的生成目录添加到您的 `.gitignore`：
@@ -345,8 +321,6 @@ Intlayer 使用 module augmentation 为您的 translation key 提供完整的 Ty
 .intlayer
 ```
 
----
-
 ## 更进一步
 
 - **Visual Editor** —— 在浏览器中可视化管理翻译：[Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)

package/docs/zh/packages/@intlayer_babel/export.md

@@ -43,8 +43,6 @@ npm install @intlayer/babel
 import { ... } from "@intlayer/babel";
 ```
 
----
-
 ### 插件
 
 | 函数 / 类                      | 描述                                                                                                                                       |
@@ -57,8 +55,6 @@ import { ... } from "@intlayer/babel";
 | `makeUsageAnalyzerBabelPlugin` | 工厂函数，用于生成一个 Babel 插件，以分析源代码中 `useIntlayer` / `getIntlayer` 的使用情况，并在共享的 `PruneContext` 中聚合字段使用数据。 |
 | `getSharedPruneContext`        | 辅助函数，用于返回指定根目录的共享 `PruneContext` 对象，如果尚未初始化，则返回 `null`。                                                    |
 
----
-
 ### 插件配置工具
 
 | 函数                       | 描述                                                                                                                |
@@ -68,8 +64,6 @@ import { ... } from "@intlayer/babel";
 | `getPurgePluginOptions`    | 加载 Intlayer 配置并返回准备好与 `intlayerPurgeBabelPlugin` 配合使用的 `PurgePluginOptions`。                       |
 | `getMinifyPluginOptions`   | 加载 Intlayer 配置并返回准备好与 `intlayerMinifyBabelPlugin` 配合使用的 `MinifyPluginOptions`。                     |
 
----
-
 ### 类型
 
 | 类型                    | 描述                                                                          |
@@ -87,8 +81,6 @@ import { ... } from "@intlayer/babel";
 | `CompatCallerConfig`    | 用于兼容包（`compat-adapter`）的兼容使用分析器配置（调用者名称和处理选项）。  |
 | `ScriptBlock`           | 从 SFC 文件（Vue 或 Svelte）中提取的脚本块：内容、起始偏移量和结束偏移量。    |
 
----
-
 ### 工具函数
 
 | 函数                              | 描述                                                                                                          |
@@ -100,8 +92,6 @@ import { ... } from "@intlayer/babel";
 | `BABEL_PARSER_OPTIONS`            | 表示覆盖支持的框架（React/Vue/Svelte/Angular/...）的 Babel 解析器选项的常量。                                 |
 | `INTLAYER_CALLER_NAMES`           | 原始 Intlayer 调用者名称的常量列表：`['useIntlayer', 'getIntlayer']`。                                        |
 
----
-
 ## 使用示例
 
 ```js

package/docs/zh/packages/adonis-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 `adonis-intlayer` 包中的 `t` 函数是在 AdonisJS 应用程序中提供本地化响应的核心工具。它通过根据用户的首选语言动态选择内容，简化了国际化 (i18n) 过程。
 
----
-
 ## 概述
 
 `t` 函数用于定义和检索一组给定语言的翻译。它根据客户端的请求设置（如 `Accept-Language` 标头）自动确定要返回的相应语言。如果首选语言不可用，它会优雅地回退到配置中指定的默认语言区域。
 
----
-
 ## 关键特性
 
 - **动态本地化**：自动为客户端选择最合适的翻译。
@@ -42,8 +38,6 @@ author: aymericzip
 - **异步上下文**：使用 Async Local Storage 在 AdonisJS 请求生命周期内无缝工作。
 - **TypeScript 支持**：为您的翻译强制执行类型安全。
 
----
-
 ## 函数签名
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, any>): any;
 
 - 代表客户端首选语言的内容。
 
----
-
 ## 加载中间件
 
 为了确保 `t` 函数正常工作，您**必须**在 AdonisJS 应用程序中注册 `intlayer` 中间件。
@@ -68,8 +60,6 @@ t(translations: Record<string, any>): any;
 router.use([() => import("adonis-intlayer/middleware")]);
 ```
 
----
-
 ## 使用示例
 
 ### 基础示例
@@ -105,8 +95,6 @@ export default class ExampleController {
 }
 ```
 
----
-
 ## 高级主题
 
 ### 回退机制

package/docs/zh/packages/express-intlayer/t.md

@@ -28,14 +28,10 @@ author: aymericzip
 
 `express-intlayer` 包中的 `t` 函数是为您的 Express 应用提供本地化响应的核心工具。它通过根据用户的首选语言动态选择内容，简化了国际化（i18n）过程。
 
----
-
 ## 概述
 
 `t` 函数用于定义和获取一组语言的翻译内容。它会根据客户端的请求设置（例如 `Accept-Language` 头）自动确定返回的合适语言。如果首选语言不可用，它会优雅地回退到您配置中指定的默认语言环境。
 
----
-
 ## 主要特性
 
 - **动态本地化**：自动为客户端选择最合适的翻译内容。
@@ -43,8 +39,6 @@ author: aymericzip
 - **轻量且快速**：为高性能应用设计，确保最小的开销。
 - **严格模式支持**：强制严格遵守声明的语言环境，保证行为可靠。
 
----
-
 ## 函数签名
 
 ```typescript
@@ -59,8 +53,6 @@ t(translations: Record<string, string>): string;
 
 - 返回一个字符串，表示客户端首选语言的内容。
 
----
-
 ## 加载国际化请求处理器
 
 为了确保 `express-intlayer` 提供的国际化功能能够正确工作，您**必须**在 Express 应用程序的开头加载国际化中间件。这将启用 `t` 函数，并确保正确处理语言环境的检测和翻译。
@@ -94,8 +86,6 @@ app.get("/", (_req, res) => {
 - **翻译上下文**：为 `t` 函数设置必要的上下文，确保返回正确语言的翻译内容。
 - **防止错误**：如果没有此中间件，使用 `t` 函数将导致运行时错误，因为缺少必要的语言环境信息。
 
----
-
 ## 使用示例
 
 ### 基本示例
@@ -136,8 +126,6 @@ app.get("/error", (_req, res) => {
 });
 ```
 
----
-
 ### 使用区域变体
 
 为特定区域的变体指定翻译：
@@ -184,8 +172,6 @@ app.get("/greet", (_req, res) => {
 });
 ```
 
----
-
 ## 高级主题
 
 ### 回退机制
@@ -210,8 +196,6 @@ export default config;
 - 如果 `defaultLocale` 是 `Locales.CHINESE`，而客户端请求的是 `Locales.DUTCH`，则返回的翻译将默认使用 `Locales.CHINESE` 的值。
 - 如果未定义 `defaultLocale`，则 `t` 函数将回退到使用 `Locales.ENGLISH` 的值。
 
----
-
 ### 严格模式强制执行
 
 配置 `t` 函数以强制严格遵守声明的语言环境：
@@ -238,8 +222,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### TypeScript 集成
 
 当与 TypeScript 一起使用时，`t` 函数是类型安全的。定义一个类型安全的翻译对象：
@@ -258,8 +240,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
----
-
 ### 常见错误与故障排除
 
 | 问题             | 原因                             | 解决方案                                   |
@@ -267,8 +247,6 @@ app.get("/morning", (_req, res) => {
 | `t` 函数无法工作 | 中间件未加载                     | 确保在路由之前添加 `app.use(intlayer())`。 |
 | 缺少翻译错误     | 严格模式启用但未提供所有语言版本 | 提供所有必需的翻译。                       |
 
----
-
 ## 有效使用技巧
 
 1. **集中管理翻译**：使用集中式模块或 JSON 文件来管理翻译，以提高可维护性。
@@ -276,8 +254,6 @@ app.get("/morning", (_req, res) => {
 3. **与前端国际化结合**：与前端国际化同步，确保整个应用的用户体验无缝衔接。
 4. **性能基准测试**：在添加翻译时测试应用的响应时间，确保影响最小化。
 
----
-
 ## 结论
 
 `t` 函数是后端国际化的强大工具。通过有效地使用它，您可以为全球用户创建一个更加包容和用户友好的应用程序。有关高级用法和详细配置选项，请参阅[文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。

package/docs/zh/packages/hono-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 `hono-intlayer` 包中的 `t` 函数是为您在 Hono 应用程序中提供本地化响应的核心工具。它通过根据用户的首选语言动态选择内容来简化国际化 (i18n)。
 
----
-
 ## 概述
 
 `t` 函数用于定义和检索一组给定语言的翻译。它根据客户端的请求设置（如 `Accept-Language` 标头）自动确定要返回的适当语言。如果首选语言不可用，它会优雅地回退到配置中指定的默认语言。
 
----
-
 ## 核心特性
 
 - **动态本地化**：自动为客户端选择最合适的翻译。
@@ -42,8 +38,6 @@ author: aymericzip
 - **轻量且快速**：专为高性能应用程序设计，确保最小的开销。
 - **严格模式支持**：强制严格遵守声明的语言，以获得可靠的行为。
 
----
-
 ## 函数签名
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, string>): string;
 
 - 一个表示客户端首选语言内容的字符串。
 
----
-
 ## 加载国际化请求处理器
 
 为了确保 `hono-intlayer` 提供的国际化功能正常工作，您**必须**在 Hono 应用程序的开头加载国际化中间件。这会启用 `t` 函数并确保正确处理语言检测和翻译。
@@ -94,8 +86,6 @@ app.get("/", (c) => {
 - **翻译上下文**：设置 `t` 函数正常运行所需的上下文，确保以正确的语言返回翻译。
 - **防止错误**：如果没有此中间件，使用 `t` 函数将导致运行时错误，因为必要的语言信息将不可用。
 
----
-
 ## 使用示例
 
 ### 基础示例
@@ -137,8 +127,6 @@ app.get("/error", (c) => {
 });
 ```
 
----
-
 ### 使用语言变体
 
 为特定语言变体指定翻译：
@@ -158,8 +146,6 @@ app.get("/greet", (c) => {
 });
 ```
 
----
-
 ## 进阶主题
 
 ### 回退机制
@@ -179,8 +165,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### 严格模式强制执行
 
 配置 `t` 函数以强制严格遵守声明的语言：
@@ -191,8 +175,6 @@ export default config;
 | `inclusive` | 声明的语言必须有翻译。缺失语言会触发警告但会被接受。 |
 | `loose`     | 接受任何现有的语言，即使未声明。                     |
 
----
-
 ### TypeScript 集成
 
 使用 TypeScript 时，`t` 函数是类型安全的。定义一个类型安全的翻译对象：
@@ -211,8 +193,6 @@ app.get("/morning", (c) => {
 });
 ```
 
----
-
 ### 常见错误与排查
 
 | 问题             | 原因                                       | 解决方案                                          |
@@ -220,8 +200,6 @@ app.get("/morning", (c) => {
 | `t` 函数不起作用 | 未加载中间件                               | 确保在路由之前添加了 `app.use("*", intlayer())`。 |
 | 缺失翻译错误     | 在未提供所有语言翻译的情况下启用了严格模式 | 提供所有必需的翻译。                              |
 
----
-
 ## 结论
 
 `t` 函数是后端国际化的强大工具。通过有效地使用它，您可以为全球受众创建一个更具包容性和用户友好的应用程序。有关进阶用法和详细配置选项，请参阅[文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md)。

package/docs/zh/packages/intlayer/comparePaths.md

@@ -45,8 +45,6 @@ author: aymericzip
 - 容忍缺少前导斜杠和空值（规范化为 `/`）
 - 轻量级 — 构建在 `getPathWithoutLocale` 之上
 
----
-
 ## 函数签名
 
 ```typescript
@@ -62,8 +60,6 @@ normalizePath(
 ): string
 ```
 
----
-
 ## 参数
 
 - `pathname: string`
@@ -86,8 +82,6 @@ normalizePath(
 - **类型**: `boolean`
 - **描述**: 当两个输入都解析为相同的与区域设置无关的路径时返回 `true`，否则返回 `false`。
 
----
-
 ## 示例用法
 
 ### 基本用法
@@ -132,8 +126,6 @@ const NavLink = ({ href, children }) => {
 };
 ```
 
----
-
 ## normalizePath
 
 `normalizePath` 返回由 `comparePaths` 使用的、与区域设置无关的规范路径名。它去除了区域设置段、协议/主机、查询字符串和哈希，确保单个前导斜杠，删除任何尾随斜杠（根目录除外），对于空值则回退为 `/`。
@@ -150,16 +142,12 @@ normalizePath(""); // "/"
 normalizePath("https://example.com/ru/path"); // "/path"
 ```
 
----
-
 ## 相关函数
 
 - [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getPathWithoutLocale.md): 从 URL 或路径中删除区域设置段。
 - [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getPrefix.md): 获取给定区域设置的 URL 前缀。
 - [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getLocalizedUrl.md): 为特定区域设置生成本地化 URL。
 
----
-
 ## TypeScript
 
 ```typescript

package/docs/zh/packages/intlayer/getCanonicalPath.md

@@ -37,8 +37,6 @@ author: aymericzip
 - 将本地化路径与配置中定义的自定义重写规则进行匹配。
 - 如果未找到匹配的重写规则，则返回原始路径。
 
----
-
 ## 函数签名
 
 ```typescript
@@ -49,8 +47,6 @@ getCanonicalPath(
 ): string
 ```
 
----
-
 ## 参数
 
 ### 必需参数
@@ -72,15 +68,11 @@ getCanonicalPath(
   - **类型**：`RoutingConfig['rewrite']`
   - **默认值**：`configuration.routing.rewrite`
 
----
-
 ## 返回值
 
 - **类型**：`string`
 - **描述**：内部规范路径。
 
----
-
 ## 示例用法
 
 ### 基本用法（使用配置）
@@ -126,8 +118,6 @@ getCanonicalPath("/contactez-nous", Locales.FRENCH, manualRules);
 // 输出: "/contact"
 ```
 
----
-
 ## 相关函数
 
 - [`getLocalizedPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getLocalizedPath.md): 将 canonical 路径解析为其本地化的等价路径。

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

@@ -31,8 +31,6 @@ author: aymericzip
 
 `getConfiguration` 函数通过提取环境变量来获取 `intlayer` 应用程序的完整配置。该函数提供了在客户端和服务器端使用相同配置的灵活性，确保整个应用程序的一致性。
 
----
-
 ## 参数
 
 该函数不接受任何参数。相反，它使用环境变量进行配置。
@@ -48,8 +46,6 @@ author: aymericzip
 
 详情请参见 [Intlayer 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
----
-
 ## 示例用法
 
 ### 获取完整配置