@intlayer/docs 9.4.4 → 9.5.0

package/docs/zh/releases/v7.md

@@ -45,8 +45,6 @@ author: aymericzip
 - 并行处理，加快翻译速度
 - 智能分块，处理大型文件以适应 AI 上下文限制
 
----
-
 ## 性能：缓存以加快构建速度
 
 v7 通过实现缓存策略来加快构建过程，而不是在每次构建时都使用 esbuild 重新构建内容声明。
@@ -73,8 +71,6 @@ bun x intlayer build
 - 检测更改并仅重新构建修改过的文件
 - 显著减少大型项目的构建时间
 
----
-
 ## TypeScript：基于语言环境的类型生成
 
 TypeScript 类型现在按语言环境生成，提供更强的类型支持，消除了跨所有语言环境的联合类型。
@@ -99,8 +95,6 @@ const content = getIntlayer("my-title-content", "en");
 - 更好的类型安全，避免跨语言环境的类型污染
 - 通过减少类型复杂性提升性能
 
----
-
 ## 包优化：将 Locales 作为字符串
 
 `Locales` 类型不再是枚举，这意味着它现在完全支持摇树优化，不会因为包含数千个未使用的语言环境记录而使您的包膨胀。
@@ -127,8 +121,6 @@ const locale: Locale = Locales.ENGLISH;
 
 更多信息请参见[实现细节](https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/types/src/index.ts)。
 
----
-
 ## 新的路由模式以实现更大灵活性
 
 v7 引入了统一的 `routing.mode` 配置，取代了之前的 `prefixDefault` 和 `noPrefix` 选项，提供了对 URL 结构更细粒度的控制。
@@ -159,8 +151,6 @@ export default {
 };
 ```
 
----
-
 ## GDPR 合规性：localStorage / cookies 存储
 
 v7 优先考虑用户隐私，默认使用 `localStorage` 作为存储机制，而非 cookies。此更改有助于避免因语言偏好设置而触发的 cookie 同意要求，从而更好地符合 GDPR 规定。
@@ -251,8 +241,6 @@ setLocale("en");
 **注意：** Cookies 默认是启用的。
 **注意：** 请根据您的具体使用场景查看 [GDPR Cookie 要求](https://gdpr.eu/cookies/)。
 
----
-
 ## 可视化编辑器：包体积减小30%
 
 可视化编辑器包经过优化，比之前版本体积减少了30%，得益于：
@@ -263,8 +251,6 @@ setLocale("en");
 
 这带来了更快的下载速度和更优的运行时性能。
 
----
-
 ## 自动代码格式化：formatCommand 配置
 
 v7 在编辑器配置中引入了 `formatCommand` 选项，允许你在 Intlayer 写入内容文件时自动格式化这些文件。这确保了内容声明文件的代码风格和格式的一致性。
@@ -322,8 +308,6 @@ formatCommand: 'bun format "{{file}}"';
 
 当 Intlayer 写入或更新内容声明文件（`.content.ts`、`.content.js` 等）时，它会自动在该文件上运行指定的格式化命令。`{{file}}` 占位符被替换为实际的文件路径，命令在项目的基础目录中执行。
 
----
-
 ## 字典配置：更好的组织和结构
 
 v7 引入了一个新的专属 `dictionary` 配置部分，为字典相关设置和改进的内容管理提供了更好的组织。
@@ -383,8 +367,6 @@ export default {
 
 有关内容声明文件以及如何应用配置值的更多信息，请参阅[内容文件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。
 
----
-
 ## fill 命令：更新行为以更好地管理内容
 
 v7 引入了 `fill` 命令的改进行为，提供了更可预测和灵活的内容管理：
@@ -470,8 +452,6 @@ const content = {
 };
 ```
 
----
-
 ## 增强的稳定性和翻译管理
 
 v7 引入了多项改进，使内容翻译更加可靠和高效：
@@ -521,8 +501,6 @@ const content = {
 4. 验证并在需要时重试
 5. 重建完整文件
 
----
-
 ## 从 v6 版本迁移说明
 
 ### 移除的配置项
@@ -611,14 +589,10 @@ const content = {
 };
 ```
 
----
-
 ## 从 v5 到 v6 的迁移说明
 
 更多信息请查看 [从 v5 到 v6 的迁移说明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/releases/v6.md)。
 
----
-
 ## 有用的链接
 
 - [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)

package/docs/zh/releases/v8.md

@@ -36,8 +36,6 @@ author: aymericzip
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## 富内容演进：Markdown & HTML
 
 Intlayer v8 对富内容的处理方式进行了重大改进，引入了 **HTML 节点**（v7 中不存在），并统一了与 **Markdown 节点**（v7 中已存在但经过增强）的 API。
@@ -407,8 +405,6 @@ Intlayer v8 对富内容的处理方式进行了重大改进，引入了 **HTML
 
 欲了解更多详情，请参阅 [HTML 内容文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/html.md) 和 [Markdown 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)。
 
----
-
 ## YAML & Markdown 内容文件 (v8.10.0)
 
 您现在可以直接使用 `.content.md` 和 `.content.yaml` 文件扩展名声明内容。这非常适合长篇内容、博客、文档和隐私政策。
@@ -417,8 +413,6 @@ Intlayer v8 对富内容的处理方式进行了重大改进，引入了 **HTML
 
 有关更多详细信息，请参阅 [YAML 内容文件文档](https://intlayer.org/doc/concept/content#yaml-content-file) 和 [Markdown 内容文件文档](https://intlayer.org/doc/concept/content/markdown)。
 
----
-
 ## 自定义 URL 重写
 
 Intlayer v8 引入对 **自定义 URL 重写** 的支持，允许你定义与标准 `/locale/path` 结构不同的特定语言路径。此功能可显著提升本地 SEO，并为非英文用户提供更自然的使用体验。
@@ -462,7 +456,7 @@ Intlayer v8 引入对 **自定义 URL 重写** 的支持，允许你定义与标
     ```
 
   </Tab>
-    <Tab label="React Router" value="reactrouter">
+  <Tab label="React Router" value="reactrouter">
 
     ```typescript fileName="intlayer.config.ts"
     import { Locales, type IntlayerConfig } from "intlayer";
@@ -588,8 +582,6 @@ Intlayer v8 引入对 **自定义 URL 重写** 的支持，允许你定义与标
 
 有关更多信息和集成指南，请参阅 [自定义 URL 重写文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/custom_url_rewrites.md)。
 
----
-
 ### 增强的插入值
 
 在 v8 中，插入值现在除了字符串和数字之外，还能**接受 React 元素（或 Vue 节点）**。这允许你将丰富的交互式组件直接注入到插入模板中。
@@ -817,8 +809,6 @@ const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
 
 更多信息，请参见 [复数化文档](https://intlayer.org/doc/concept/content/plural)。
 
----
-
 ## 内容 Schema 验证
 
 Intlayer v8 为字典引入了 schema 验证。你现在可以在配置中使用 Zod 定义可重用的验证 schema，并将其应用到你的内容文件中。这可以确保你的内容始终遵循预期的结构，并在构建时 (build time)捕获错误。
@@ -861,8 +851,6 @@ export default aboutPageMetaContent;
 
 如果内容不符合模式（例如，title 太短），构建过程将抛出错误。
 
----
-
 ## TypeScript: IntlayerNode Primitive Accessors
 
 `IntlayerNode` 类型已更新，允许直接在内容节点上调用原始 JavaScript 方法。这使得可以直接与本地化内容交互，就像它是一个标准字符串、数字、布尔值或数组原始类型一样。
@@ -889,8 +877,6 @@ content.myArrayOfString.find(...)   // 返回元素
 content.myArrayOfString.join(', ')  // 返回连接的字符串
 ```
 
----
-
 ### 增强的自动内容检测
 
 在 v8 中，Intlayer 能智能检测内容字符串中的 Markdown 语法、HTML 标签和变量插入。这意味着通常可以省略像 `md()`、`html()` 或 `insert()` 这样的辅助函数。
@@ -964,8 +950,6 @@ export default {
 }
 ```
 
----
-
 ## 本地化：新的 `useIntl` 钩子
 
 现在在 React、Next.js 和 Vue 中可以使用新的 `useIntl()` 钩子。它提供了一个与语言环境绑定的 `Intl` 对象，能够自动使用当前语言来格式化数字、日期等，而无需手动传入 locale。
@@ -1084,8 +1068,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## 工具：VSCode 扩展增强
 
 Intlayer 的 VSCode 扩展在 v8 中迎来重大更新，以简化你的国际化工作流程：
@@ -1094,8 +1076,6 @@ Intlayer 的 VSCode 扩展在 v8 中迎来重大更新，以简化你的国际
 - **缓存**：增强的缓存层，实现接近即时的验证和自动补全。
 - **未使用键与重复键检测**：新增功能，可自动检测字典中的 **未使用键** 和 **重复键**，帮助你保持内容整洁且高效。
 
----
-
 ## 工具：C++ Watcher & OXC-based LSP (v8.12.0)
 
 Intlayer v8.12.0 为开发者体验带来了重大改进：
@@ -1105,15 +1085,13 @@ Intlayer v8.12.0 为开发者体验带来了重大改进：
 
 有关详细信息，请参阅 [LSP 文档](https://intlayer.org/doc/lsp)。
 
----
-
 ## 编译器优化
 
 Intlayer v8 为 Markdown 和 HTML 编译器引入了新的缓存层。这确保在相同配置下相同的内容字符串只被解析一次，从而显著降低在重新渲染或在多个地方使用相同内容时的开销。
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1135,7 +1113,7 @@ Intlayer v8 为 Markdown 和 HTML 编译器引入了新的缓存层。这确保
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -1160,8 +1138,6 @@ Intlayer v8 为 Markdown 和 HTML 编译器引入了新的缓存层。这确保
   </Tab>
 </Tabs>
 
----
-
 ## 实验性构建优化：代码缩小和清理 (v8.7.0)
 
 Intlayer v8.7.0 在你的 `intlayer.config.ts` 中引入了新的实验性构建功能，旨在优化你的生产包：
@@ -1202,8 +1178,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ## 灵活性：统一导入模式
 
 `live` 布尔属性已被弃用，改用更为全面的 `importMode` 属性。这样可以明确定义 dictionaries 应如何加载：静态、动态，或通过实时同步。
@@ -1244,8 +1218,6 @@ export default {
 }
 ```
 
----
-
 ## 字典位置控制
 
 v8 引入了 `location` 属性，用于明确管理字典的位置以及它们如何同步。这在涉及本地文件和远程 CMS 内容的混合工作流中特别有用。
@@ -1266,8 +1238,6 @@ export default {
 }
 ```
 
----
-
 ## 系统配置分离
 
 Intlayer v8 将内容源配置与内部 system 和输出路径分离。这使得 `content` 属性更简洁，并且明确哪些设置由用户管理，哪些由 Intlayer 系统管理。
@@ -1307,8 +1277,6 @@ export default {
 };
 ```
 
----
-
 ## 内容目录与代码目录分离
 
 Intlayer v8 将内容定义文件的配置与代码转换的配置分离。这使得监视和扫描更加精确，从而提升构建性能。
@@ -1343,22 +1311,16 @@ export default {
 };
 ```
 
----
-
 ## 框架：Svelte 改进
 
 在 Svelte 中的 Markdown 和 HTML 内容在被字符串化（stringified）时现在会自动解析为 HTML。这样与 Svelte 的 `{@html}` 语法一起使用更加方便，因为你现在可以直接传递内容节点。
 
----
-
 ## Angular 支持：Vite Bundler (v8.11.0)
 
 对于 Angular 用户，Intlayer 现在通过新的自定义 esbuild 插件原生支持 Vite bundler，加快了开发和构建时间。
 
 有关配置详情，请参阅 [Angular 环境文档](https://intlayer.org/doc/environment/angular)。
 
----
-
 ## 网站地图生成 (v8.6.0)
 
 Intlayer 现在根据您的语言环境和路由模式自动生成网站地图。这对于 TanStack Router 等路由架构中的 SEO 优化特别有用：
@@ -1392,8 +1354,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 });
 ```
 
----
-
 ## 从 v7 的迁移说明
 
 ### 配置更改
@@ -1403,8 +1363,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 - **`contentDir` 和 `codeDir`**：`contentDir` 现在专用于内容文件。新增 `codeDir` 属性用于代码转换。如果未设置 `codeDir`，Intlayer 将回退到使用 `contentDir` 并记录一个警告。
 - **模式验证**：要使用新的 `schema` 功能，请确保在项目中已安装 `zod`。
 
----
-
 ## 有用的链接
 
 - [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)

package/docs/zh/releases/v9.md

@@ -37,8 +37,6 @@ Welcome to Intlayer v9! This major release marks a huge milestone in simplifying
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## Compat Adapter Packages
 
 Migrating to Intlayer from popular i18n libraries is now easier than ever. We have created five compat packages that expose the **exact same public APIs** as standard i18n libraries but delegate all translation work to Intlayer at runtime.
@@ -99,8 +97,6 @@ export default defineConfig({
 });
 ```
 
----
-
 ## Mutualized Runtime Resolver
 
 All compat adapters now route translation resolution through a single, highly optimized runtime parser: `@intlayer/core/messageFormat`.
@@ -109,8 +105,6 @@ All compat adapters now route translation resolution through a single, highly op
 - **Message Node Resolver**: Resolves nested nodes: `insert()`, `plural()` (CLDR plural rules), `enu()` (enumeration), `gender()`, HTML tags, arrays, and callable function nodes.
 - **Tokenized Tag Parser**: Supports inline XML/HTML tags and numbered tags (e.g., `<1>children</1>`) to power rich-text rendering out of the box.
 
----
-
 ## Feature Spec: Collections & Variants
 
 Intlayer v9 expands beyond static key-value objects, allowing dictionaries to declare dynamic layout structures that are fully typed end-to-end.
@@ -206,8 +200,6 @@ const product = useIntlayer("product-copy", {
 });
 ```
 
----
-
 ## `@intlayer/analytics`：内容曝光追踪与 A/B 测试
 
 全新的可选包 [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) 会告诉您访客实际看到了哪些内容——并通过让您对内容进行 A/B 测试、按变体衡量转化率，补上 **Collections & Variants** 的最后一环。
@@ -249,8 +241,6 @@ npm install @intlayer/analytics
 
 目前已支持 React、Next.js 和 React Native（通过 `react-intlayer`）；其他框架绑定（Vue、Svelte、Angular 等）正在规划中，将遵循与 `@intlayer/editor` 相同的推广模式。完整指南请参阅 [Analytics 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)。
 
----
-
 ## Vite Plugin: 捆绑编译器和代理
 
 `intlayer()` Vite 插件现在直接捆绑了**编译器**和**区域设置路由代理**，因此大多数项目只需在 `vite.config.ts` 中使用单个插件：
@@ -285,8 +275,6 @@ export default config;
 
 独立的 `intlayerCompiler()` 和 `intlayerProxy()` 插件仍然可用于高级设置。将它们与 `intlayer()` 一起注册是安全的 — 每个插件会自动去重并且仅运行一次。
 
----
-
 ## 默认禁用编译器
 
 从 Intlayer v9 开始，**编译器默认被禁用**（`compiler.enabled` 现在默认为 `false`）。要启用对 `.content.ts` 文件的构建时提取，请在配置中设置 `compiler.enabled: true`：
@@ -306,8 +294,6 @@ export default config;
 
 当编译器被禁用时，Intlayer 会跳过构建时提取步骤，并依赖您已声明的字典。仅当您希望打包器插件（`@intlayer/swc`、`@intlayer/babel` 或 `intlayer()` Vite 插件）自动提取内容时才启用它。
 
----
-
 ## React Native：单包导入
 
 在 React Native 或 Expo 应用中，您不再需要同时管理 `react-intlayer` 和 `react-native-intlayer`。`react-native-intlayer` 包现在**重新导出了完整的 `react-intlayer` API**（hooks、工具函数以及 `/format`、`/html` 和 `/markdown` 子路径），并且其 `IntlayerProvider` 会自动应用 React Native 的 polyfills。
@@ -328,8 +314,6 @@ npm install intlayer react-native-intlayer
 
 > 从 `react-intlayer` 导入仍然有效，但现在推荐使用 `react-native-intlayer` 作为 React Native 的单一入口点 —— 它的 provider 提供了面向 web 的 `react-intlayer` provider 所不包含的 polyfills。
 
----
-
 ## CMS SDK：将 Intlayer 用作无头内容数据库
 
 Intlayer v9 在 `@intlayer/api` 中提供了一个简洁、自动鉴权的 SDK，用于以编程方式与 CMS 交互——获取项目、获取字典，以及从你自己的服务器、脚本或 CI 推送或更新它们。鉴权（OAuth2 `client_credentials`）会自动处理并刷新。
@@ -356,8 +340,6 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 > 安全：CMS 凭据授予对内容的写入权限。务必只在**服务端**创建鉴权器——切勿将 `clientId` / `clientSecret` 发送到浏览器。
 
----
-
 ## 自托管
 
 Intlayer v9 提供一流的支持，使您可以通过单个命令运行自己的 Intlayer 实例。无需 Intlayer Cloud 账户。
@@ -368,8 +350,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 安装程序下载 `docker-compose.yml` 和 `.env`，自动生成所需的密钥，并运行 `docker compose up -d`。一切内容 — dashboard、API、数据库、对象存储和事务性电子邮件 — 都在容器中本地运行。
 
----
-
 ## Migration notes from v8
 
 If you are upgrading from v8, note that the v9 does not include breaking changes. But here are the key changes:
@@ -378,8 +358,6 @@ If you are upgrading from v8, note that the v9 does not include breaking changes
 - **Locales & Dialects**: If using external i18n dependencies, add their respective compat adapter plugins in your configuration or bundler setup to automatically rewrite imports.
 - **Custom Selectors**: When calling `useIntlayer`, the second parameter is now reserved for an option object containing `{ locale, item, variant }`. If you previously passed a locale string directly, you can still do so, but using the options object is recommended for advanced selections.
 
----
-
 ## Useful links
 
 - [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)

package/docs/zh/roadmap.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 Intlayer 是一个内容管理和国际化解决方案，旨在简化您在应用程序中声明、管理和更新内容的方式。它提供了强大的功能，例如集中式或分布式内容声明、广泛的国际化选项、Markdown 支持、条件渲染、TypeScript/JavaScript/JSON 集成等。以下是 Intlayer 当前提供的功能的全面概述，以及即将推出的路线图功能。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 当前功能
 
 ### 1. 内容声明
@@ -146,8 +142,6 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 >
 > - [构建配置](https://intlayer.org/doc/concept/configuration#build-configuration)
 
----
-
 ## 与框架和环境的集成
 
 ### 1. Next.js
@@ -234,8 +228,6 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 >
 > - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_preact.md)
 
----
-
 ## 可视化编辑器和 CMS
 
 ### 1. 本地可视化编辑器
@@ -261,21 +253,15 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 >
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)
 
----
-
 ## IDE 扩展
 
 - 为主流 IDE 提供的扩展，提供用于管理本地和远程翻译的**图形界面**。
 - 功能可能包括自动生成组件内容声明文件、与 Intlayer CMS 的直接集成以及实时校验。
 
----
-
 ## MCP 服务器
 
 - 一个**MCP 服务器**，允许你使用集成在 IDE 中的工具来管理内容和翻译。
 
----
-
 ## Intlayer CLI
 
 - **翻译和文件生成**：对你的内容文件进行审计，生成缺失的翻译并检查不一致之处。
@@ -286,15 +272,11 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 >
 > - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md)
 
----
-
 ## 环境配置
 
 - 使用 **环境变量** 来针对生产、测试和本地环境不同地配置 Intlayer。
 - 根据您的环境定义要使用的可视化编辑器或远程 CMS 项目。
 
----
-
 ## 热内容更新
 
 - 使用远程词典和 Intlayer CMS 时，您可以 **实时更新应用内容**，无需重新部署。
@@ -303,8 +285,6 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 >
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)
 
----
-
 ## 即将推出的功能
 
 ### 1. A/B 测试与个性化
@@ -333,8 +313,6 @@ Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 来
 - 正在努力支持**Solid、Svelte、Angular**等框架。
 - 目标是使 Intlayer 兼容**任何基于 JavaScript 的应用程序**。
 
----
-
 ## 结论
 
 Intlayer 旨在成为内容管理和国际化的一站式解决方案。它专注于灵活性（集中式或分布式文件）、广泛的语言支持、与现代框架和打包工具的轻松集成，以及强大的 AI 驱动功能。随着 A/B 测试、版本控制和自动翻译等新功能的推出，Intlayer 将继续简化内容工作流程，提升不同平台上的用户体验。

package/docs/zh/self_hosting.md

@@ -35,8 +35,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 <TOC/>
 
----
-
 ## 架构
 
 ```
@@ -56,8 +54,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Chromium（用于 Puppeteer 屏幕截图生成）捆绑在后端镜像中——无需单独的容器。
 
----
-
 ## 先决条件
 
 - **Docker** ≥ 24 和 **Docker Compose** ≥ v2。如果其中任何一个缺失，安装程序将打印安装链接并退出。
@@ -66,8 +62,6 @@ Chromium（用于 Puppeteer 屏幕截图生成）捆绑在后端镜像中——
 
 其他所有内容 — Bun、Redis、MinIO、Chromium — 都包含在镜像中。
 
----
-
 ## 快速开始
 
 ### 1. 运行安装程序
@@ -136,8 +130,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > 四个端口变量仅改变 `docker run` 命令中打印的映射的**主机**端，已发布的镜像在构建时将 `http://localhost:3000`、`http://localhost:3100` 和 `http://localhost:9000` 编译到仪表板包中，因此重新映射它们会导致浏览器指向旧端口。除非您正在构建自己的镜像，否则请保持默认值 — 参见[限制](#limitations)。
 
----
-
 ## 快速开始
 
 安装程序执行以下操作：
@@ -150,8 +142,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 堆栈启动后，打开 **http://localhost:3000** 并创建您的第一个账户。
 
----
-
 ## 服务
 
 | 服务        | 镜像                              | 主机端口                       | 用途                               |
@@ -165,8 +155,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > MinIO 端口 `9000` 必须可从浏览器访问，因为上传的资产（头像、截图）直接从 `S3_PUBLIC_URL=http://localhost:9000/intlayer` 加载。
 
----
-
 ## 环境变量
 
 ### 必需
@@ -236,8 +224,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > 优先级：组织自己的邮件服务（从**组织**仪表板配置）优先于全局邮件服务，全局邮件服务优先于默认的 Resend 密钥。
 
----
-
 ## 连接您的 Intlayer 项目
 
 堆栈运行后，将您的项目指向自托管的后端和仪表盘，而不是 `intlayer.org`。
@@ -299,8 +285,6 @@ const cms = createIntlayerCMS({
 const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 ```
 
----
-
 ## 升级
 
 这会拉取最新镜像并使用 `docker compose pull && docker compose up -d` 重启容器。现有卷（`mongo-data`、`redis-data`、`minio-data`）会保留——不会丢失数据。
@@ -310,8 +294,6 @@ docker compose pull
 docker compose up -d
 ```
 
----
-
 ## 备份与恢复
 
 所有持久化数据都存储在三个命名 Docker 卷中。
@@ -346,16 +328,12 @@ docker run --rm \
 # 对 redis-data 和 minio-data 重复此操作
 ```
 
----
-
 ## 限制条件
 
 - **MongoDB 必须是外部的 (Atlas)。** 后端仅通过 `mongodb+srv://` 连接（由 `DB_ID` / `DB_MDP` / `DB_CLUSTER` 构建），因此不能使用普通的 `mongodb://host:27017` — 包括容器自己的捆绑 `mongod`。请提供一个 MongoDB Atlas 集群。
 - **不支持自定义域名。** 所有面向浏览器的 `VITE_*` URL 都在构建时内联到应用中，发布的镜像带有 `localhost` 值。必须在 `http://localhost:3000` 上访问仪表板；在公共域上提供服务需要使用目标 URL 重新构建镜像，这在开箱即用时不受支持。
 - **Email 需要工作的邮件程序。** 首次运行设置强制执行电子邮件验证，因此必须配置 `RESEND_API_KEY` 或 [全局 SMTP 邮件程序](#global-mailer)（`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`）。第一个管理员登录后，每个组织也可以从仪表板配置自己的 SMTP 或 Resend 邮件程序。
 
----
-
 ## 故障排除
 
 ### 后端首次启动时崩溃循环
@@ -382,8 +360,6 @@ docker compose logs redis
 docker compose run --rm minio-init
 ```
 
----
-
 ## 有用链接
 
 - [Intlayer CMS 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)

package/docs/zh/testing.md

@@ -24,16 +24,12 @@ author: aymericzip
 
 本指南展示了如何自动验证您的字典是否完整，在发布前捕获缺失的翻译，并测试您应用中的本地化 UI。
 
----
-
 ## 您可以测试的内容
 
 - **缺失的翻译**：如果任何字典缺少必需的语言环境，则使 CI 失败。
 - **本地化 UI 渲染**：使用特定的语言环境提供者渲染组件，并断言可见的文本/属性。
 - **构建时审计**：通过 CLI 在本地运行快速审计。
 
----
-
 ## 快速开始：通过 CLI 审计
 
 从您的项目根目录运行审计：
@@ -64,8 +60,6 @@ bun x intlayer content test
 
 注意：CLI 会打印详细报告，但在失败时不会以非零状态退出。对于 CI 门控，请添加下面的单元测试，断言没有缺失的必需语言环境。
 
----
-
 ## 编程测试（Vitest/Jest）
 
 使用 Intlayer CLI API 断言您的必需语言环境没有缺失的翻译。
@@ -112,8 +106,6 @@ test("没有缺失的必需语言环境", () => {
   - `missingLocales`：所有缺失语言的合集。
   - `missingRequiredLocales`：限制为 `requiredLocales` 的子集（如果未设置 `requiredLocales`，则为所有语言）。
 
----
-
 ## 测试本地化 UI（React / Next.js）
 
 在 Intlayer 提供者下渲染组件，并断言可见内容。
@@ -158,8 +150,6 @@ test("渲染法语本地化标题", () => {
 - 当你需要属性的原始字符串值（例如 `aria-label`）时，可以访问 React 中 `useIntlayer` 返回的 `.value` 字段。
 - 将字典与组件放在一起，便于单元测试和清理。
 
----
-
 ## 持续集成
 
 添加一个测试，当缺少必需的翻译时使构建失败。
@@ -209,8 +199,6 @@ pnpm intlayer content test --verbose
 bun x intlayer content test --verbose
 ```
 
----
-
 ## 故障排除
 
 - 确保您的 Intlayer 配置定义了 `locales` 和（可选的）`requiredLocales`。

package/docs/zh-TW/bundle_optimization.md

@@ -133,8 +133,6 @@ export default config;
 
 > 清除與壓縮僅在 `next build` 時執行 —— 最佳化流水線在 `next dev` 期間是關閉的。
 
-> 當設定了相容轉接器呼叫方時它們也會被停用（`swcExtraCallers`，由 `@intlayer/next-intl`、`@intlayer/react-i18next` 等相容套件設定）：這些呼叫點對使用分析器不可見，因此清除會移除程式碼仍在讀取的欄位。匯入重寫仍保持啟用。
-
 **更早的版本（9.2.1 之前）** 需要 `@intlayer/babel` 以及一個宣告 `intlayerPurgeBabelPlugin` 與 `intlayerMinifyBabelPlugin` 的 `babel.config.js`。該檔案不再需要，可以刪除。
 
  </Tab>

package/docs/zh-TW/interest_of_intlayer.md

@@ -264,8 +264,6 @@ GitHub 星星數是衡量項目受歡迎程度、社區信任度以及長期相
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## 互操作性
 
 `intlayer` 還可以幫助管理你的 `react-intl`、`react-i18next`、`next-intl`、`next-i18next` 以及 `vue-i18n` 命名空間。