@intlayer/docs 8.9.8 → 8.10.0-canary.0

package/docs/vi/intlayer_with_vite+vanilla.md

@@ -35,7 +35,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-vite-vanilla-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox — Intlayer"
+  title="Demo CodeSandbox - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-vite-vanilla.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Bản demo — intlayer-vite-vanilla-template"
+  title="Bản demo - intlayer-vite-vanilla-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -255,7 +255,7 @@ export default appContent;
 
 ### Bước 6: Sử dụng Intlayer trong JavaScript của bạn
 
-`vanilla-intlayer` ánh xạ API của `react-intlayer`: `useIntlayer(key, locale?)` trả về nội dung đã dịch trực tiếp. Chuỗi hàm `.onChange()` vào kết quả để đăng ký theo dõi các thay đổi ngôn ngữ — tương đương với việc re-render trong React.
+`vanilla-intlayer` ánh xạ API của `react-intlayer`: `useIntlayer(key, locale?)` trả về nội dung đã dịch trực tiếp. Chuỗi hàm `.onChange()` vào kết quả để đăng ký theo dõi các thay đổi ngôn ngữ - tương đương với việc re-render trong React.
 
 ```typescript fileName="src/main.ts" codeFormat="typescript"
 import { installIntlayer, useIntlayer } from "vanilla-intlayer";
@@ -456,7 +456,7 @@ const unsubscribe = useDictionaryDynamic(
 });
 ```
 
-> Mỗi bundle ngôn ngữ chỉ được tải khi ngôn ngữ đó được kích hoạt và kết quả được lưu vào cache — các lần chuyển đổi sau đó sang cùng một ngôn ngữ sẽ diễn ra tức thì.
+> Mỗi bundle ngôn ngữ chỉ được tải khi ngôn ngữ đó được kích hoạt và kết quả được lưu vào cache - các lần chuyển đổi sau đó sang cùng một ngôn ngữ sẽ diễn ra tức thì.
 
 ### (Tùy chọn) Bước 13: Trích xuất nội dung từ các thành phần của bạn
 

package/docs/vi/intlayer_with_vite+vue.md

@@ -72,7 +72,7 @@ Với Intlayer, bạn có thể:
 <iframe
   src="https://intlayer-vite-vue-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Bản demo — intlayer-vite-vue-template"
+  title="Bản demo - intlayer-vite-vue-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/vi/readme.md

@@ -66,6 +66,7 @@ Với **các tệp nội dung theo từng locale**, **tự động hoàn thành
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="MCP" width="700">                                          | **Tích hợp Server MCP**<br><br>Cung cấp một máy chủ MCP (Model Context Protocol) cho tự động hóa IDE, cho phép quản lý nội dung và quy trình làm việc i18n liền mạch trực tiếp trong môi trường phát triển của bạn. <br><br> - [Máy Chủ MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/mcp_server.md)                                                                                                                                                       |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="VSCode" width="700">                          | **Tiện ích mở rộng VSCode**<br><br>Intlayer cung cấp một tiện ích mở rộng VSCode giúp bạn quản lý nội dung và bản dịch, xây dựng từ điển của bạn, dịch nội dung, và nhiều hơn thế nữa. <br><br> - [Tiện Ích Mở Rộng VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                         |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Interoperability" width="700">                | **Khả năng tương tác**<br><br>Cho phép tương thích liên vận với react-i18next, next-i18next, next-intl, react-intl, vue-i18n. <br><br> - [Intlayer và react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer và next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer và next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer và vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Interoperability" width="700">                       | **Hiệu năng & Điểm chuẩn**<br><br>Sử dụng tree-shaking nâng cao và tải động để tăng hiệu năng và giữ cho giải pháp nhẹ nhất có thể. <br><br> - [Hiệu năng & Điểm chuẩn](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                                                     |
 
 ---
 
@@ -260,6 +261,18 @@ Khám phá tài liệu toàn diện của chúng tôi để bắt đầu với I
 </ul>
 </details>
 
+## Hệ thống quản lý nội dung đa ngôn ngữ
+
+Không chỉ là một thư viện i18n, Intlayer là một **hệ thống quản lý nội dung đa ngôn ngữ** hoàn chỉnh. Một CMS đầy đủ tính năng có sẵn miễn phí tại [app.intlayer.org](https://app.intlayer.org/?utm_source=chatgpt.com).
+
+Intlayer kết nối **lập trình viên**, **người viết nội dung** và **các tác nhân AI** trong một luồng công việc duy nhất để tạo và duy trì các trang web đa ngôn ngữ một cách dễ dàng. Intlayer thay thế toàn bộ ngăn xếp công nghệ sau đây bằng một giải pháp duy nhất:
+
+- Các giải pháp i18n (ví dụ: `i18next`, `next-intl`, `vue-i18n`)
+- TMS (Hệ thống quản lý dịch thuật) (ví dụ: Crowdin, Phrase, Lokalise)
+- Headless CMS (ví dụ: Contentful, Strapi, Sanity)
+
+![CMS Preview](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png?raw=true)
+
 ## 🌐 Readme bằng các ngôn ngữ khác
 
 <p align="center">

package/docs/zh/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: 2026 年 Next.js 最佳 i18n 解决方案 - 基准测试报告
 description: 对比 next-intl、next-i18next 和 Intlayer 等 Next.js 国际化 (i18n) 库。关于打包体积、泄漏和响应性的详细性能报告。
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "添加 GitHub 明星对比"
   - version: 8.7.5
     date: 2026-01-06
     changes: "初始化基准测试"
 ---
 
-# Next.js i18n 库 — 2026 年基准测试报告
+# Next.js i18n 库 - 2026 年基准测试报告
 
 本页面是关于 Next.js i18n 解决方案的基准测试报告。
 
@@ -57,7 +60,7 @@ style="border:none;"
 
 i18n 库的另一个影响是开发速度变慢。将组件转换为支持多语言的内容非常耗时。
 
-因为这个问题很棘手，所以存在许多解决方案——有些侧重于 DX（开发体验），有些侧重于性能或可扩展性等。
+因为这个问题很棘手，所以存在许多解决方案--有些侧重于 DX（开发体验），有些侧重于性能或可扩展性等。
 
 Intlayer 尝试在这些维度上进行优化。
 
@@ -95,7 +98,7 @@ Intlayer 尝试在这些维度上进行优化。
 
 如果你使用类似 `const t = useTranslation()` + `t('my-object.my-sub-object.my-key')` 的语法，通常整个 JSON 都必须包含在打包包中，以便库可以解析它并解析键。即使页面上没有用到，大部分内容也会被发送。
 
-为了减轻这种情况，一些库要求你声明每个页面要加载哪些命名空间——例如 `next-i18next`、`next-intl`、`lingui`、`next-translate`、`next-international`。
+为了减轻这种情况，一些库要求你声明每个页面要加载哪些命名空间--例如 `next-i18next`、`next-intl`、`lingui`、`next-translate`、`next-international`。
 
 相比之下，`Paraglide` 在构建前增加了一个额外步骤，将 JSON 转换为扁平的符号，如 `const en_my_var = () => 'my value'`。理论上，这可以在页面上实现 Tree-shaking 掉未使用的内容。正如我们将看到的，这种方法仍然存在权衡。
 
@@ -150,7 +153,7 @@ Intlayer 尝试在这些维度上进行优化。
 
 - **平均组件打包体积**: 通用 UI 组件被**逐个测量**，而不是隐藏在应用的总数据中。这显示了国际化是否会悄悄增加日常组件的体积。例如，如果你的组件重新渲染，它将从内存中加载所有这些数据。给任何组件附加一个巨大的 JSON，就像连接了一个庞大的未使用数据仓库，会降低组件性能。
 
-- **语言切换响应性**: 我使用应用自带的控制组件切换语言，并计时直到页面明显完成切换所需的时间——这是访问者能感知到的时间，而非实验室微秒级步骤。
+- **语言切换响应性**: 我使用应用自带的控制组件切换语言，并计时直到页面明显完成切换所需的时间--这是访问者能感知到的时间，而非实验室微秒级步骤。
 
 - **语言更改后的渲染工作**: 进一步的跟进：一旦切换开始，界面以新语言重新绘制所需的开销。当“感知”时间和框架开销不一致时非常有用。
 
@@ -158,11 +161,17 @@ Intlayer 尝试在这些维度上进行优化。
 
 - **注水 (Hydration) 时间**: 当应用暴露该数据时，客户端将服务端 HTML 转换为可交互状态所需的时间。表格中的破折号表示该实现在本基准测试中未提供可靠的注水数值。
 
+## GitHub 星数
+
+GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fnext-i18next%2Camannn%2Fnext-intl%2Clingui%2Fjs-lingui%2Cvinissimus%2Fnext-translate%2Cinostudio%2Fnext-international%2Copral%2paraglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/next-i18next&amannn/next-intl&lingui/js-lingui&vinissimus/next-translate&inostudio/next-international&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
+
 ## 结果详情
 
-### 1 — 应当避免的解决方案
+### 1 - 应当避免的解决方案
 
-应当明确避免诸如 `gt-next` 或 `lingo.dev` 之类的解决方案。它们结合了供应商锁定和代码库污染。尽管投入了大量时间尝试实施，但我从未让它们正常工作过——无论是在 TanStack Start 还是 Next.js 上。
+应当明确避免诸如 `gt-next` 或 `lingo.dev` 之类的解决方案。它们结合了供应商锁定和代码库污染。尽管投入了大量时间尝试实施，但我从未让它们正常工作过--无论是在 TanStack Start 还是 Next.js 上。
 
 遇到的问题：
 
@@ -176,12 +185,12 @@ Intlayer 尝试在这些维度上进行优化。
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
 
-- AI 配额超出，完全阻塞了构建——这意味着不付钱就无法发布到生产环境。
+- AI 配额超出，完全阻塞了构建--这意味着不付钱就无法发布到生产环境。
 - 编译器丢失了近 40% 的翻译内容。我不得不将所有的 `.map` 重写为扁平的组件块才使其工作。
 - 它们的 CLI 存在 Bug，会无故重置配置文件。
 - 构建时，当添加新内容时，它会完全抹除生成的 JSON 文件。结果是几个键的添加可能会导致 300 多个现有键被清除。
 
-### 2 — 实验性解决方案
+### 2 - 实验性解决方案
 
 **(Wuchale)** (`wuchale@0.22.11`):
 
@@ -195,7 +204,7 @@ Intlayer 尝试在这些维度上进行优化。
 
 > 关于 Paraglide 的说明：该解决方案通过将代码注入到你的代码库中进行导入，因此在基准测试报告中，“库体积”指标几乎为 0。代码生成是一件好事，因为所使用的函数将仅包含必要的逻辑（全前缀 vs 无前缀、Cookie vs 存储等）。相比之下，Intlayer 通过在构建中注入环境变量来强制打包工具根据逻辑对内容进行 Tree-shaking。得益于此，Paraglide 和 Intlayer 最终成为比 i18next 或 next-intl 轻 6 到 10 倍的解决方案。
 
-### 3 — 可接受的解决方案
+### 3 - 可接受的解决方案
 
 **(Tolgee)** (`@tolgee/react@7.0.0`):
 
@@ -219,7 +228,7 @@ Intlayer 尝试在这些维度上进行优化。
 
 `Lingui` 常受赞誉。就个人而言，我觉得围绕 `lingui extract` / `lingui compile` 的工作流比其他方案更复杂，且没有明显的优势。我还注意到语法不统一，容易误导 AI（例如 `t()`、`t''`、`i18n.t()`、`<Trans>`）。
 
-### 4 — 推荐方案
+### 4 - 推荐方案
 
 **(Next Translate)** (`next-translate@3.1.2`):
 

package/docs/zh/benchmark/solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: 2026 年 Solid 最佳 i18n 解决方案 - 基准报告
 description: 比较 Solid 国际化（i18n）库，如 solid-primitives、solid-i18next 和 Intlayer。关于包大小、泄漏和反应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "添加 GitHub 明星对比"
   - version: 8.7.12
     date: 2026-01-06
     changes: "初始化基准"
@@ -114,6 +117,12 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+## GitHub 星数
+
+GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2paraglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&aymericzip/intlayer)
+
 ## 结果详情
 
 ### 1 - 应当避免的解决方案

package/docs/zh/benchmark/svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: 2026 年 Svelte 最佳 i18n 解决方案 - 基准报告
 description: 比较 Svelte 国际化（i18n）库，如 svelte-i18n、Paraglide 和 Intlayer。关于包大小、泄漏和反应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "添加 GitHub 明星对比"
   - version: 8.7.12
     date: 2026-01-06
     changes: "初始化基准"
@@ -113,6 +116,12 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+## GitHub 星数
+
+GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2paraglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&aymericzip/intlayer)
+
 ## 结果详情
 
 ### 1 - 应当避免的解决方案

package/docs/zh/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: 2026 年 TanStack Start 最佳 i18n 解决方案 - 基准测试报告
 description: 对比 react-i18next、use-intl 和 Intlayer 等 TanStack Start 国际化库。关于打包体积、泄漏和响应性的详细性能报告。
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "添加 GitHub 明星对比"
   - version: 8.7.5
     date: 2026-01-06
     changes: "初始化基准测试"
 ---
 
-# TanStack Start i18n 库 — 2026 年基准测试报告
+# TanStack Start i18n 库 - 2026 年基准测试报告
 
 本页面是关于 TanStack Start i18n 解决方案的基准测试报告。
 
@@ -121,9 +124,15 @@ history:
 - **Scoped static (局部静态)**: 保持代码组织良（逻辑分离），且无需复杂的额外网络请求。
 - **Scoped dynamic (局部动态)**: 代码分割和性能的最佳方案。通过仅加载当前视图和活动语言环境所需的内容来最小化内存占用。
 
+## GitHub 星数
+
+GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=formatjs%2Fformatjs%2Ci18next%2Freact-i18next%2Clingui%2Fjs-lingui%2Camannn%2Fnext-intl%2Copral%2paraglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&lingui/js-lingui&amannn/next-intl&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
+
 ## 结果详情
 
-### 1 — 应当避免的解决方案
+### 1 - 应当避免的解决方案
 
 应当明确避开诸如 `gt-react` 或 `lingo.dev` 之类的解决方案。它们结合了供应商锁定和代码库污染。更糟的是：尽管投入了大量时间尝试实施，但我从未让它们在 TanStack Start 上正常工作（类似于 Next.js 下的 `gt-next`）。
 
@@ -145,13 +154,13 @@ history:
 - 构建时，当有新内容添加时，它会完全抹除生成的 JSON 文件。结果是几个键的改动就可能抹去数百个现有键。
 - 我曾在 TanStack Start 上遇到该库的响应性问题：切换语言环境时，我必须强制重新渲染 Provider 才能使其生效。
 
-### 2 — 实验性解决方案
+### 2 - 实验性解决方案
 
 **(Wuchale)** (`wuchale@0.22.11`):
 
 `Wuchale` 背后的想法很有趣，但尚非可行方案。我遇到了该库的响应性问题，不得不强制重新渲染 Provider 才能让应用在 TanStack Start 上运行。文档也相当模糊，增加了上手难度。
 
-### 3 — 可接受的解决方案
+### 3 - 可接受的解决方案
 
 **(Paraglide)** (`@inlang/paraglide-js@2.15.1`):
 
@@ -177,7 +186,7 @@ history:
 
 尽管如此，它与基于 `t('a.b.c')` 的技术栈有着相同的重大缺点：优化是可能的，但非常耗时，且大型项目容易陷入不良实践（命名空间 + 动态加载 + 类型）。
 
-消息格式也不同：`use-intl` 使用 ICU MessageFormat，而 `i18next` 使用自己的格式——如果混合使用它们，会增加工具链或迁移的复杂度。
+消息格式也不同：`use-intl` 使用 ICU MessageFormat，而 `i18next` 使用自己的格式--如果混合使用它们，会增加工具链或迁移的复杂度。
 
 **(Lingui)** (`@lingui/core@5.3.0`):
 
@@ -187,7 +196,7 @@ history:
 
 `react-intl` 是来自 Format.js 团队的高性能实现。但 DX 依然繁琐：`const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` 增加了复杂度和额外的 JavaScript 开销，并将全局 i18n 实例绑定到了 React 树中的许多节点。
 
-### 4 — 推荐方案
+### 4 - 推荐方案
 
 在本次 TanStack Start 基准测试中，没有与 `next-translate`（Next.js 插件 + `getStaticProps`）直接对应的方案。对于那些确实想要 `t()` API 且拥有成熟生态的团队，`react-i18next` 和 `use-intl` 仍是“合理”的选择，但要做好投入大量时间进行优化以避免泄漏的准备。
 

package/docs/zh/benchmark/vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: 2026 年 Vue 最佳 i18n 解决方案 - 基准报告
 description: 比较 Vue 国际化（i18n）库，如 vue-i18n、fluent-vue 和 Intlayer。关于包大小、泄漏和反应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "添加 GitHub 明星对比"
   - version: 8.7.12
     date: 2026-01-06
     changes: "初始化基准"
@@ -135,6 +138,12 @@ style="border:none;"
 
 - **哈イドレーション时间 (Hydration)**: 客户端将服务器 HTML 转换为可点击内容所花费的时间。表格中的破折号表示该实现在此基准测试中未提供可靠的哈イドレーション数字。
 
+## GitHub 星数
+
+GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+
 ## 结果详情
 
 ### 1 - 应当避免的解决方案

package/docs/zh/cli/init.md

@@ -138,7 +138,7 @@ Checking Intlayer configuration...
 
 ## 注意事项：
 
-- 该命令是幂等的——您可以安全地多次运行它。已配置的步骤将被跳过。
+- 该命令是幂等的--您可以安全地多次运行它。已配置的步骤将被跳过。
 - 如果配置文件已存在，则不会被覆盖。
 - 不包含 `include` 数组的 TypeScript 配置（例如带有引用的 solution-style 配置）将被跳过。
 - 如果在项目根目录中未找到 `package.json`，该命令将报错退出。

package/docs/zh/configuration.md

@@ -609,7 +609,7 @@ export default config;
 | ----------------- | ---------------------------------------------------- | ---------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `locales`         | 应用程序中支持的区域设置列表。                       | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                    |
 | `requiredLocales` | 应用程序中必需的区域设置列表。                       | `string[]` | `[]`                | `[]`                 | • 如果为空，则在 `strict` 模式下所有区域设置都是必需的。<br/>• 请确保必需的区域设置也已在 `locales` 字段中定义。                                                                                                                   |
-| `strictMode`      | 使用 TypeScript 确保国际化内容的强实现。             | `string`   | `'inclusive'`       |                      | • 如果为 `"strict"`: 为 `t` 函数定义每个已声明的区域设置是强制性的——如缺少或未声明则报错。<br/>• 如果为 `"inclusive"`: 对缺少的区域设置发出警告，但允许使用未声明的现有区域设置。<br/>• 如果为 `"loose"`: 接受任何现有的区域设置。 |
+| `strictMode`      | 使用 TypeScript 确保国际化内容的强实现。             | `string`   | `'inclusive'`       |                      | • 如果为 `"strict"`: 为 `t` 函数定义每个已声明的区域设置是强制性的--如缺少或未声明则报错。<br/>• 如果为 `"inclusive"`: 对缺少的区域设置发出警告，但允许使用未声明的现有区域设置。<br/>• 如果为 `"loose"`: 接受任何现有的区域设置。 |
 | `defaultLocale`   | 如果请求的区域设置不可用，则用作回退的默认区域设置。 | `string`   | `Locales.ENGLISH`   | `'en'`               | 如果 URL、cookie 或 header 中未指定区域设置，则用于确定区域设置。                                                                                                                                                                  |
 
 ---
@@ -673,10 +673,10 @@ routing: {
 
 | 值                 | 备注                                                                                                                                                         | 说明                                                 |
 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
-| `'cookie'`         | • 确保适当的用户同意以符合 GDPR 要求。<br/>• 通过 `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`) 可配置。  | 将区域设置存储在 cookie 中——客户端和服务器均可访问。 |
-| `'localStorage'`   | • 除非明确删除，否则不会过期。<br/>• Intlayer Proxy 无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`) 可配置。 | 将区域设置存储在浏览器中，永不过期——仅限客户端。     |
-| `'sessionStorage'` | • 关闭标签页/窗口时删除。<br/>• Intlayer Proxy 无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`) 可配置。    | 在页面会话期间存储区域设置——仅限客户端。             |
-| `'header'`         | • 对于 API 调用很有用。<br/>• 客户端无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`) 可配置。                       | 通过 HTTP header 存储或传递区域设置——仅限服务器。    |
+| `'cookie'`         | • 确保适当的用户同意以符合 GDPR 要求。<br/>• 通过 `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`) 可配置。  | 将区域设置存储在 cookie 中--客户端和服务器均可访问。 |
+| `'localStorage'`   | • 除非明确删除，否则不会过期。<br/>• Intlayer Proxy 无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`) 可配置。 | 将区域设置存储在浏览器中，永不过期--仅限客户端。     |
+| `'sessionStorage'` | • 关闭标签页/窗口时删除。<br/>• Intlayer Proxy 无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`) 可配置。    | 在页面会话期间存储区域设置--仅限客户端。             |
+| `'header'`         | • 对于 API 调用很有用。<br/>• 客户端无法访问它。<br/>• 通过 `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`) 可配置。                       | 通过 HTTP header 存储或传递区域设置--仅限服务器。    |
 
 #### Cookie 属性 (Cookies Attributes)
 
@@ -864,7 +864,7 @@ export default config;
 | `location`                  | 指出字典文件存储在哪里以及如何与 CMS 同步。                                                  | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'`: 仅本地管理。<br/>• `'remote'`: 仅远程管理 (CMS)。<br/>• `'hybrid'`: 本地和远程管理。<br/>• `'plugin'` 或自定义字符串：通过插件或自定义源管理。                                                                                                                                                 |
 | `importMode`                | 控制字典的导入方式。                                                                         | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: 静态导入。<br/>• `'dynamic'`: 通过 Suspense 动态导入。<br/>• `'fetch'`: 通过 Live Sync API 获取；失败后回退到 `'dynamic'`。<br/>• 需要 `@intlayer/babel` 和 `@intlayer/swc` 插件。<br/>• 键必须静态声明。<br/>• 如果 `optimize` 关闭则忽略。<br/>• 不影响 `getIntlayer`, `getDictionary` 等。 |
 | `priority`                  | 字典优先级。在解决字典之间的冲突时，较高的值比较低的值具有优先级。                           | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                             |
-| `live`                      | 已弃用 — 请使用 `importMode: 'fetch'`。曾指示是否应通过 Live Sync API 动态获取字典内容。     | `boolean`                                                                                                       | `undefined` |                                                                                             | 在 v8.0.0 中重命名为 `importMode: 'fetch'`。                                                                                                                                                                                                                                                                |
+| `live`                      | 已弃用 - 请使用 `importMode: 'fetch'`。曾指示是否应通过 Live Sync API 动态获取字典内容。     | `boolean`                                                                                                       | `undefined` |                                                                                             | 在 v8.0.0 中重命名为 `importMode: 'fetch'`。                                                                                                                                                                                                                                                                |
 | `schema`                    | 由 Intlayer 自动生成，用于 JSON 架构验证。                                                   | `'https://intlayer.org/schema.json'`                                                                            | 自动生成    |                                                                                             | 请勿手动编辑。                                                                                                                                                                                                                                                                                              |
 | `title`                     | 帮助在编辑器和 CMS 中识别字典。                                                              | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                             |
 | `tags`                      | 对字典进行分类并为编辑器和 AI 提供上下文或指令。                                             | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                             |

package/docs/zh/custom_domains.md

@@ -34,8 +34,8 @@ Intlayer 支持基于域名的语言路由，允许您从专用主机名提供
 
 关键区别在于 **专用性**：
 
-- **专用域名** — 只有一种语言映射到该主机名（例如 `zh → intlayer.zh`）。域名本身标识了语言，因此路径中不添加语言前缀。`https://intlayer.zh/about` 提供中文内容。
-- **共享域名** — 多种语言映射到同一个主机名（例如 `en` 和 `fr` 都映射到 `intlayer.org`）。应用正规的基于前缀的路由。`intlayer.org/fr/about` 提供法语内容。
+- **专用域名** - 只有一种语言映射到该主机名（例如 `zh → intlayer.zh`）。域名本身标识了语言，因此路径中不添加语言前缀。`https://intlayer.zh/about` 提供中文内容。
+- **共享域名** - 多种语言映射到同一个主机名（例如 `en` 和 `fr` 都映射到 `intlayer.org`）。应用正规的基于前缀的路由。`intlayer.org/fr/about` 提供法语内容。
 
 ## 配置
 
@@ -55,9 +55,9 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     domains: {
-      // 共享域名 — en 和 fr 在 intlayer.org 上使用前缀路由
+      // 共享域名 - en 和 fr 在 intlayer.org 上使用前缀路由
       en: "intlayer.org",
-      // 专用域名 — zh 有其自己的主机名，不需要 /zh/ 前缀
+      // 专用域名 - zh 有其自己的主机名，不需要 /zh/ 前缀
       zh: "intlayer.zh",
     },
   },
@@ -96,7 +96,7 @@ getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
 ```ts
 // 当前页面: intlayer.zh/about
 getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
-// → "/about"  (已在正确的域名上 — 相对 URL)
+// → "/about"  (已在正确的域名上 - 相对 URL)
 
 getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 // → "https://intlayer.org/fr/about"  (跨域名链接回到 intlayer.org)
@@ -108,14 +108,14 @@ getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 
 1. 绝对输入 URL 的主机名（例如 `https://intlayer.org/about` → `intlayer.org`）。
 2. 浏览器环境中的 `window.location.hostname`。
-3. 如果两者均不可用（不带显式选项的 SSR），则为同域名语言返回相对 URL，并且不生成绝对 URL — 这是安全的回退方案。
+3. 如果两者均不可用（不带显式选项的 SSR），则为同域名语言返回相对 URL，并且不生成绝对 URL - 这是安全的回退方案。
 
 ```ts
-// 浏览器 — window.location.hostname === 'intlayer.org'
+// 浏览器 - window.location.hostname === 'intlayer.org'
 getLocalizedUrl("/about", "zh");
 // → "https://intlayer.zh/about"  (从 window 自动检测)
 
-// 从绝对 URL — 自动检测域名
+// 从绝对 URL - 自动检测域名
 getLocalizedUrl("https://intlayer.org/about", "zh");
 // → "https://intlayer.zh/about"
 ```
@@ -151,14 +151,14 @@ export const config = {
 };
 ```
 
-**重定向** — 请求到达了给定语言前缀的错误域名：
+**重定向** - 请求到达了给定语言前缀的错误域名：
 
 ```
 GET intlayer.org/zh/about
 → 301 https://intlayer.zh/about
 ```
 
-**重写** — 请求到达了语言的专用域名且没有前缀：
+**重写** - 请求到达了语言的专用域名且没有前缀：
 
 ```
 GET intlayer.zh/about
@@ -209,7 +209,7 @@ export const LocaleSwitcher = () => {
 };
 ```
 
-无需额外配置 — `useLocale` 内部检测 `window.location.hostname` 并决定是进行 `router.replace`（同域名）还是 `window.location.href`（跨域名）。
+无需额外配置 - `useLocale` 内部检测 `window.location.hostname` 并决定是进行 `router.replace`（同域名）还是 `window.location.href`（跨域名）。
 
 ## SEO: `hreflang` 备用链接
 

package/docs/zh/dictionary/content_file.md

@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "添加对 YAML 和 Markdown 文件格式的支持"
   - version: 8.9.0
     date: 2026-05-12
     changes: "添加 `plural` 内容节点类型"
@@ -802,6 +805,40 @@ export default {
 }
 ```
 
+### Markdown 内容文件
+
+```markdown
+---
+key: welcome-page
+locale: en
+title: Welcome Page Content
+description: Content for the main welcome page
+tags:
+  - page
+  - welcome
+---
+
+# Welcome to Our Platform
+
+## Build amazing applications with ease
+```
+
+### YAML 内容文件
+
+```yaml
+key: welcome-page
+title: Welcome Page Content
+description: Content for the main welcome page
+locale: "en"
+tags:
+  - page
+  - welcome
+content:
+  hero:
+    title: Welcome to Our Platform
+    subtitle: Build amazing applications with ease
+```
+
 ### 每语言内容文件
 
 对于每语言字典，指定 `locale` 属性：
@@ -853,6 +890,10 @@ Intlayer 允许您自定义内容声明文件的扩展名。此自定义功能
 - `.content.mjx`
 - `.content.cjs`
 - `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 
 这些默认的扩展名适用于大多数应用程序。然而，当您有特定需求时，可以定义自定义扩展名，以简化构建过程并减少与其他组件冲突的风险。
 

package/docs/zh/dictionary/markdown.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-03-24
+updatedAt: 2026-05-19
 title: Markdown
 description: 了解如何在多语言网站中使用Intlayer声明和使用Markdown内容。按照此在线文档中的步骤，将Markdown无缝集成到您的项目中。
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - content
   - markdown
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "添加 `.content.md` 文件支持"
   - version: 8.5.0
     date: 2026-03-24
     changes: "Add `intlayerMarkdown` plugin object; use `app.use(intlayerMarkdown)` instead of `app.use(installIntlayerMarkdown)`"
@@ -43,6 +46,38 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
 您可以使用 `md` 函数声明 Markdown 内容，或简单地将其作为字符串（如果它包含 Markdown 语法）。
 
 <Tabs>
+  <Tab label=".content.md" value=".content.md">
+    自版本 `8.10.0` 起，您可以直接在 `.content.md` 文件中声明 Markdown 内容。Intlayer 将自动检测并解析 Markdown 内容。
+
+    ```md fileName="markdown-file.zh.content.md"
+    ---
+    key: my-markdown-content
+    description: 我的内容
+    locale: zh
+    ---
+
+    # 我的内容
+
+    这里是 markdown 内容的一个示例
+    ```
+
+    `locale` 前言（frontmatter）字段是定义内容语言环境（locale）的字段。它是可选的。如果未提供，Intlayer 将使用默认语言环境，如果在特定语言环境下没有可用翻译，该语言环境也将用作后备（fallback）语言环境。
+
+    文件结构示例：
+
+    ```text
+    content/
+    ├── en/
+    │   └── markdown-file.en.content.md
+    ├── fr/
+    │   └── markdown-file.fr.content.md
+    └── es/
+        └── markdown-file.es.content.md
+    ```
+
+    您可以在前言（front-matter）中添加 [字典定义（Dictionary definition）](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md) 中定义的任何属性。
+
+  </Tab>
   <Tab label="手动包裹" value="manual-wrapping">
     使用 `md` 函数显式声明 Markdown 内容。如果您想确保一个字符串被视为 Markdown，即使它不包含明显的语法，这很有用。
 

package/docs/zh/intlayer_with_analog.md

@@ -44,7 +44,7 @@ history:
 <iframe
   src="https://intlayer-analog-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="演示 — intlayer-analog-template"
+  title="演示 - intlayer-analog-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/zh/intlayer_with_angular.md

@@ -65,7 +65,7 @@ history:
 <iframe
   src="https://intlayer-angular-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="演示 — intlayer-angular-template"
+  title="演示 - intlayer-angular-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/zh/intlayer_with_astro.md

@@ -48,7 +48,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="演示 — intlayer-astro-template"
+  title="演示 - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />