@intlayer/docs 8.11.3 → 8.12.0-canary.0

package/blog/vi/i18n_using_next-intl.md

@@ -107,7 +107,9 @@ Dưới đây là cấu trúc dự án mà chúng ta sẽ tạo:
         └── ServerComponent.tsx
 ```
 
-### Bước 1: Cài đặt các phụ thuộc
+<Steps>
+
+<Step number={1} title="Cài đặt các phụ thuộc">
 
 Cài đặt các gói cần thiết sử dụng npm:
 
@@ -125,7 +127,9 @@ yarn add next-intl
 
 - **next-intl**: Thư viện quốc tế hóa cốt lõi cho Next.js App Router cung cấp các hook, hàm server và provider client để quản lý bản dịch.
 
-### Bước 2: Cấu hình dự án của bạn
+</Step>
+
+<Step number={2} title="Cấu hình dự án của bạn">
 
 Tạo một tệp cấu hình định nghĩa các ngôn ngữ được hỗ trợ và thiết lập cấu hình yêu cầu của next-intl. Tệp này đóng vai trò là nguồn duy nhất cho thiết lập i18n của bạn và đảm bảo an toàn kiểu trong toàn bộ ứng dụng của bạn.
 
@@ -210,7 +214,9 @@ export const { Link, redirect, usePathname, useRouter, getPathname } =
 export const proxy = createMiddleware(routingOptions);
 ```
 
-### Bước 3: Định nghĩa các route địa phương động
+</Step>
+
+<Step number={3} title="Định nghĩa các route địa phương động">
 
 Thiết lập định tuyến động cho các locale bằng cách tạo thư mục `[locale]` trong thư mục app của bạn. Điều này cho phép Next.js xử lý định tuyến dựa trên locale, trong đó mỗi locale trở thành một phân đoạn URL (ví dụ: `/en/about`, `/fr/about`).
 
@@ -298,7 +304,9 @@ export default async function AboutPage({
 }
 ```
 
-### Bước 4: Tạo Các Tệp Dịch Thuật Của Bạn
+</Step>
+
+<Step number={4} title="Tạo Các Tệp Dịch Thuật Của Bạn">
 
 Tạo các tệp JSON cho từng locale và namespace. Cấu trúc này cho phép bạn tổ chức các bản dịch một cách hợp lý và chỉ tải những gì bạn cần cho mỗi trang.
 
@@ -340,7 +348,9 @@ Việc tổ chức bản dịch theo namespace (ví dụ: `common.json`, `about.
 }
 ```
 
-### Bước 5: Sử Dụng Bản Dịch Trong Các Trang Của Bạn
+</Step>
+
+<Step number={5} title="Sử Dụng Bản Dịch Trong Các Trang Của Bạn">
 
 Tạo một component trang tải bản dịch trên server và truyền chúng cho cả component server và client. Điều này đảm bảo bản dịch được tải trước khi render và ngăn chặn hiện tượng nhấp nháy nội dung.
 
@@ -391,7 +401,9 @@ export default async function AboutPage({
 }
 ```
 
-### Bước 6: Sử dụng bản dịch trong các component phía client
+</Step>
+
+<Step number={6} title="Sử dụng bản dịch trong các component phía client">
 
 Các component phía client có thể sử dụng các hook `useTranslations` và `useFormatter` để truy cập các bản dịch và các hàm định dạng. Các hook này đọc dữ liệu từ ngữ cảnh `NextIntlClientProvider`.
 
@@ -427,7 +439,9 @@ const ClientComponent = () => {
 };
 ```
 
-### Bước 7: Sử dụng Bản dịch trong các Server Components
+</Step>
+
+<Step number={7} title="Sử dụng Bản dịch trong các Server Components">
 
 Các server component không thể sử dụng React hooks, vì vậy chúng nhận các bản dịch và hàm định dạng thông qua props từ các component cha. Cách tiếp cận này giữ cho các server component đồng bộ và cho phép chúng được lồng bên trong các client component.
 
@@ -459,9 +473,9 @@ const ServerComponent = ({
 
 > Trong trang/layout của bạn, sử dụng `getTranslations` và `getFormatter` từ `next-intl/server` để tính trước các bản dịch và định dạng, sau đó truyền chúng dưới dạng props cho các component server.
 
----
+</Step>
 
-### (Tùy chọn) Bước 8: Thay đổi ngôn ngữ nội dung của bạn
+<Step number={8} title="Thay đổi ngôn ngữ nội dung của bạn" isOptional={true}>
 
 Để thay đổi ngôn ngữ nội dung với next-intl, hãy render các liên kết nhận biết locale trỏ đến cùng một pathname trong khi chuyển đổi locale. Provider sẽ tự động viết lại URL, vì vậy bạn chỉ cần nhắm mục tiêu đến route hiện tại.
 
@@ -533,7 +547,9 @@ export default function LocaleSwitcher() {
 }
 ```
 
-### (Tùy chọn) Bước 9: Sử dụng component Link đã được bản địa hóa
+</Step>
+
+<Step number={9} title="Sử dụng component Link đã được bản địa hóa" isOptional={true}>
 
 `next-intl` cung cấp một gói con `next-intl/navigation` chứa một component link đã được bản địa hóa, tự động áp dụng locale đang hoạt động. Chúng tôi đã trích xuất sẵn cho bạn trong file `@/i18n`, vì vậy bạn có thể sử dụng như sau:
 
@@ -543,7 +559,9 @@ import { Link } from "@/i18n";
 return <Link href="/about">t("about.title")</Link>;
 ```
 
-### (Tùy chọn) Bước 10: Truy cập locale đang hoạt động bên trong Server Actions
+</Step>
+
+<Step number={10} title="Truy cập locale đang hoạt động bên trong Server Actions" isOptional={true}>
 
 Server Actions có thể đọc locale hiện tại bằng cách sử dụng `next-intl/server`. Điều này hữu ích cho việc gửi email bản địa hóa hoặc lưu trữ tùy chọn ngôn ngữ cùng với dữ liệu được gửi lên.
 
@@ -566,7 +584,9 @@ export async function handleContactForm(formData: FormData) {
 
 > `getLocale` đọc locale được thiết lập bởi proxy `next-intl`, vì vậy nó hoạt động ở bất kỳ đâu trên server: Route Handlers, Server Actions và edge functions.
 
-### (Tùy chọn) Bước 11: Quốc tế hóa Metadata của bạn
+</Step>
+
+<Step number={11} title="Quốc tế hóa Metadata của bạn" isOptional={true}>
 
 Việc dịch nội dung là quan trọng, nhưng mục tiêu chính của quốc tế hóa là làm cho trang web của bạn trở nên dễ thấy hơn với thế giới. I18n là một đòn bẩy tuyệt vời để cải thiện khả năng hiển thị trang web của bạn thông qua SEO đúng cách.
 
@@ -605,7 +625,9 @@ export async function generateMetadata({
 // ... Phần còn lại của mã trang
 ```
 
-### (Tùy chọn) Bước 12: Quốc tế hóa Sitemap của bạn
+</Step>
+
+<Step number={12} title="Quốc tế hóa Sitemap của bạn" isOptional={true}>
 
 Tạo một sitemap bao gồm tất cả các phiên bản ngôn ngữ (locale) của các trang của bạn. Điều này giúp các công cụ tìm kiếm khám phá và lập chỉ mục tất cả các phiên bản ngôn ngữ của nội dung của bạn.
 
@@ -659,7 +681,9 @@ export default function sitemap(): MetadataRoute.Sitemap {
 }
 ```
 
-### (Tùy chọn) Bước 13: Quốc tế hóa tệp robots.txt của bạn
+</Step>
+
+<Step number={13} title="Quốc tế hóa tệp robots.txt của bạn" isOptional={true}>
 
 Tạo một tệp robots.txt xử lý đúng tất cả các phiên bản ngôn ngữ của các tuyến đường được bảo vệ của bạn. Điều này đảm bảo rằng các công cụ tìm kiếm không lập chỉ mục các trang quản trị hoặc bảng điều khiển bằng bất kỳ ngôn ngữ nào.
 
@@ -692,7 +716,9 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### (Tùy chọn) Bước 14: Thiết lập Proxy cho Định tuyến Locale
+</Step>
+
+<Step number={14} title="Thiết lập Proxy cho Định tuyến Locale" isOptional={true}>
 
 Tạo một proxy để tự động phát hiện locale ưu tiên của người dùng và chuyển hướng họ đến URL có tiền tố locale phù hợp. next-intl cung cấp một hàm proxy tiện lợi xử lý việc này một cách tự động.
 
@@ -712,7 +738,9 @@ export const config = {
 };
 ```
 
-### (Tùy chọn) Bước 15: Thiết lập kiểu TypeScript cho Locale
+</Step>
+
+<Step number={15} title="Thiết lập kiểu TypeScript cho Locale" isOptional={true}>
 
 Thiết lập TypeScript sẽ giúp bạn có tính năng tự động hoàn thành và an toàn kiểu cho các khóa của bạn.
 
@@ -738,7 +766,9 @@ declare module "next-intl" {
 
 Đoạn mã này sẽ sử dụng Module Augmentation để thêm locales và messages vào kiểu AppConfig của next-intl.
 
-### (Tùy chọn) Bước 15: Tự động hóa bản dịch của bạn bằng Intlayer
+</Step>
+
+<Step number={16} title="Tự động hóa bản dịch của bạn bằng Intlayer" isOptional={true}>
 
 Intlayer là một thư viện **miễn phí** và **mã nguồn mở** được thiết kế để hỗ trợ quá trình bản địa hóa trong ứng dụng của bạn. Trong khi next-intl xử lý việc tải và quản lý bản dịch, Intlayer giúp tự động hóa quy trình làm việc bản dịch.
 
@@ -763,3 +793,7 @@ Intlayer sẽ cho phép bạn:
   Intlayer cung cấp một trình chỉnh sửa trực quan miễn phí để chỉnh sửa nội dung của bạn bằng trình chỉnh sửa trực quan. Tìm hiểu thêm về [chỉnh sửa trực quan bản dịch của bạn](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).
 
 Và còn nhiều hơn thế nữa. Để khám phá tất cả các tính năng mà Intlayer cung cấp, vui lòng tham khảo [Lợi ích của tài liệu Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/interest_of_intlayer.md).
+
+</Step>
+
+</Steps>

package/blog/zh/i18n_using_next-i18next.md

@@ -80,6 +80,7 @@ history:
   title="演示 CodeSandbox - 如何使用 Intlayer 国际化您的应用"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
+/>
 
 > 查看 GitHub 上的[应用模板](https://github.com/aymericzip/next-i18next-template)。
 
@@ -116,7 +117,9 @@ history:
         └── ServerComponent.tsx
 ```
 
-### 第一步：安装依赖
+<Steps>
+
+<Step number={1} title="安装依赖">
 
 使用 npm 安装必要的包：
 
@@ -136,7 +139,9 @@ yarn add i18next react-i18next i18next-resources-to-backend
 - **react-i18next**：i18next 的 React 绑定，提供如 `useTranslation` 的钩子，适用于客户端组件。
 - **i18next-resources-to-backend**：一个插件，支持动态加载翻译文件，只加载你需要的命名空间。
 
-### 第2步：配置您的项目
+</Step>
+
+<Step number={2} title="配置您的项目">
 
 创建一个配置文件来定义您支持的语言环境、默认语言环境以及用于 URL 本地化的辅助函数。该文件作为您的 i18n 设置的唯一可信来源，并确保整个应用程序中的类型安全。
 
@@ -189,7 +194,9 @@ export function getCookie(locale: Locale) {
 }
 ```
 
-### 第3步：集中管理翻译命名空间
+</Step>
+
+<Step number={3} title="集中管理翻译命名空间">
 
 为您的应用程序公开的每个命名空间创建一个单一的可信来源。重用此列表可以保持服务器、客户端和工具代码的同步，并为翻译辅助工具解锁强类型支持。
 
@@ -199,7 +206,9 @@ export const namespaces = ["common", "about"] as const;
 export type Namespace = (typeof namespaces)[number];
 ```
 
-### 第4步：使用 TypeScript 强类型化翻译键
+</Step>
+
+<Step number={4} title="使用 TypeScript 强类型化翻译键">
 
 扩展 `i18next` 指向您的规范语言文件（通常是英文）。TypeScript 会推断每个命名空间的有效键，因此对 `t()` 的调用会进行端到端的检查。
 
@@ -237,7 +246,9 @@ const { t } = useTranslation("about");
 export type AboutTranslator = TFunction<"about">;
 ```
 
-### 第五步：设置服务器端 i18n 初始化
+</Step>
+
+<Step number={5} title="设置服务器端 i18n 初始化">
 
 创建一个服务器端初始化函数，用于加载服务器组件的翻译。该函数为服务器端渲染创建一个独立的 i18next 实例，确保在渲染之前加载翻译内容。
 
@@ -292,7 +303,9 @@ export async function initI18next(
 }
 ```
 
-### 第6步：创建客户端i18n提供者
+</Step>
+
+<Step number={6} title="创建客户端i18n提供者">
 
 创建一个客户端组件提供者，将你的应用包裹在i18next上下文中。该提供者接收从服务器预加载的翻译，防止未翻译内容闪烁（FOUC）并避免重复请求。
 
@@ -375,7 +388,9 @@ export default function I18nProvider({
 }
 ```
 
-### 第7步：定义动态语言路由
+</Step>
+
+<Step number={7} title="定义动态语言路由">
 
 通过在你的 app 文件夹中创建一个 `[locale]` 目录来设置语言的动态路由。这允许 Next.js 处理基于语言的路由，其中每个语言成为 URL 的一部分（例如 `/en/about`，`/fr/about`）。
 
@@ -427,7 +442,9 @@ export default function LocaleLayout({
 }
 ```
 
-### 第8步：创建您的翻译文件
+</Step>
+
+<Step number={8} title="创建您的翻译文件">
 
 为每个 locale 和命名空间创建 JSON 文件。此结构允许您逻辑地组织翻译，并且只加载每个页面所需的内容。
 
@@ -520,7 +537,9 @@ export default function LocaleLayout({
 }
 ```
 
-### 第9步：在页面中使用翻译
+</Step>
+
+<Step number={9} title="在页面中使用翻译">
 
 创建一个页面组件，在服务器端初始化 i18next，并将翻译传递给服务器和客户端组件。这确保了在渲染前加载翻译，防止内容闪烁。
 
@@ -580,7 +599,9 @@ export default async function AboutPage({
 }
 ```
 
-### 第10步：在客户端组件中使用翻译
+</Step>
+
+<Step number={10} title="在客户端组件中使用翻译">
 
 客户端组件可以使用 `useTranslation` 钩子来访问翻译。该钩子提供对翻译函数和 i18n 实例的访问，允许你翻译内容并访问语言环境信息。
 
@@ -631,7 +652,9 @@ const ClientComponent = () => {
 export default ClientComponent;
 ```
 
-### 第11步：在服务器组件中使用翻译
+</Step>
+
+<Step number={11} title="在服务器组件中使用翻译">
 
 服务器组件不能使用 React hooks，因此它们通过 props 从父组件接收翻译内容。这种方式保持了服务器组件的同步性，并允许它们嵌套在客户端组件内部。
 
@@ -677,9 +700,9 @@ const ServerComponent = ({ t, locale, count }: ServerComponentProps) => {
 export default ServerComponent;
 ```
 
----
+</Step>
 
-### （可选）步骤12：更改内容语言
+<Step number={12} title="更改内容语言" isOptional={true}>
 
 在 Next.js 中更改内容语言，推荐的方式是使用带有区域设置前缀的 URL 和 Next.js 的链接。下面的示例从路由中读取当前区域设置，从路径名中剥离它，并为每个可用的区域设置渲染一个链接。
 
@@ -751,7 +774,9 @@ export default function LocaleSwitcher() {
 }
 ```
 
-### （可选）步骤 13：构建本地化的 Link 组件
+</Step>
+
+<Step number={13} title="构建本地化的 Link 组件" isOptional={true}>
 
 在整个应用中重用本地化的 URL 可以保持导航的一致性并有利于 SEO。将 `next/link` 包装在一个小的辅助函数中，该函数会为内部路由添加当前激活的 locale 前缀，同时保持外部 URL 不变。
 
@@ -802,7 +827,9 @@ export default function LocalizedLink({
 
 > 提示：由于 `LocalizedLink` 是一个即插即用的替代方案，可以通过交换导入并让组件处理特定语言环境的 URL 来逐步迁移。
 
-### （可选）步骤 14：在服务器操作中访问当前语言环境
+</Step>
+
+<Step number={14} title="在服务器操作中访问当前语言环境" isOptional={true}>
 
 服务器操作通常需要当前语言环境来处理邮件、日志记录或第三方集成。将代理设置的语言环境 cookie 与 `Accept-Language` 头部结合使用，作为回退方案。
 
@@ -840,7 +867,9 @@ export async function stuffFromServer(formData: FormData) {
 
 > 由于该辅助工具依赖于 Next.js 的 cookies 和 headers，因此它适用于路由处理程序、服务器操作以及其他仅限服务器的上下文。
 
-### （可选）步骤 15：国际化您的元数据
+</Step>
+
+<Step number={15} title="国际化您的元数据" isOptional={true}>
 
 翻译内容很重要，但国际化的主要目标是让您的网站在全球范围内更具可见性。I18n 是通过适当的 SEO 提升网站可见性的强大杠杆。
 
@@ -907,7 +936,9 @@ export default async function AboutPage() {
 }
 ```
 
-### （可选）步骤16：国际化您的网站地图
+</Step>
+
+<Step number={16} title="国际化您的网站地图" isOptional={true}>
 
 生成包含所有本地版本页面的网站地图。这有助于搜索引擎发现并索引您内容的所有语言版本。
 
@@ -961,7 +992,9 @@ export default function sitemap(): MetadataRoute.Sitemap {
 }
 ```
 
-### （可选）步骤17：国际化您的robots.txt
+</Step>
+
+<Step number={17} title="国际化您的robots.txt" isOptional={true}>
 
 创建一个 robots.txt 文件，正确处理所有受保护路由的所有语言版本。这确保搜索引擎不会索引任何语言的管理员或仪表盘页面。
 
@@ -992,7 +1025,9 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### （可选）步骤18：设置用于区域路由的中间件
+</Step>
+
+<Step number={18} title="设置用于区域路由的中间件" isOptional={true}>
 
 创建一个代理，自动检测用户的首选语言环境，并将其重定向到相应的带有语言前缀的URL。这可以通过显示用户首选语言的内容来提升用户体验。
 
@@ -1081,7 +1116,9 @@ export const config = {
 };
 ```
 
-### （可选）步骤 19：使用 Intlayer 自动化您的翻译
+</Step>
+
+<Step number={19} title="使用 Intlayer 自动化您的翻译" isOptional={true}>
 
 Intlayer 是一个**免费**且**开源**的库，旨在协助您应用中的本地化流程。虽然 i18next 负责翻译的加载和管理，Intlayer 则帮助自动化翻译工作流。
 
@@ -1111,3 +1148,7 @@ Intlayer 允许您：
   Intlayer 提供免费的可视化编辑器，使用可视化编辑器编辑您的内容。了解更多关于[可视化编辑您的翻译](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)。
 
 以及更多功能。要发现 Intlayer 提供的所有功能，请参阅[Intlayer 的优势文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md)。
+
+</Step>
+
+</Steps>

package/blog/zh/i18n_using_next-intl.md

@@ -71,6 +71,7 @@ history:
   title="演示 CodeSandbox - 如何使用 Intlayer 实现应用国际化"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
+/>
 
 > 查看 GitHub 上的[应用模板](https://github.com/aymericzip/next-intl-template)。
 
@@ -106,7 +107,9 @@ history:
         └── ServerComponent.tsx
 ```
 
-### 第一步：安装依赖
+<Steps>
+
+<Step number={1} title="安装依赖">
 
 使用 npm 安装必要的包：
 
@@ -124,7 +127,9 @@ yarn add next-intl
 
 - **next-intl**：Next.js App Router 的核心国际化库，提供用于管理翻译的 hooks、服务器函数和客户端提供者。
 
-### 第二步：配置项目
+</Step>
+
+<Step number={2} title="配置项目">
 
 创建一个配置文件，定义你支持的语言环境并设置 next-intl 的请求配置。该文件作为你的国际化设置的唯一可信来源，并确保整个应用中的类型安全。
 
@@ -209,7 +214,9 @@ export const { Link, redirect, usePathname, useRouter, getPathname } =
 export const proxy = createMiddleware(routingOptions);
 ```
 
-### 第三步：定义动态语言路由
+</Step>
+
+<Step number={3} title="定义动态语言路由">
 
 通过在您的应用程序文件夹中创建一个 `[locale]` 目录来设置基于语言环境的动态路由。这允许 Next.js 处理基于语言环境的路由，其中每个语言环境成为 URL 的一部分（例如 `/en/about`，`/fr/about`）。
 
@@ -298,7 +305,9 @@ export default async function AboutPage({
 }
 ```
 
-### 第4步：创建您的翻译文件
+</Step>
+
+<Step number={4} title="创建您的翻译文件">
 
 为每个语言环境和命名空间创建 JSON 文件。此结构允许您逻辑性地组织翻译内容，并且只加载每个页面所需的内容。
 
@@ -340,7 +349,9 @@ export default async function AboutPage({
 }
 ```
 
-### 第5步：在页面中使用翻译
+</Step>
+
+<Step number={5} title="在页面中使用翻译">
 
 创建一个页面组件，在服务器端加载翻译，并将其传递给服务器和客户端组件。这确保了翻译在渲染之前加载，防止内容闪烁。
 
@@ -391,7 +402,9 @@ export default async function AboutPage({
 }
 ```
 
-### 第6步：在客户端组件中使用翻译
+</Step>
+
+<Step number={6} title="在客户端组件中使用翻译">
 
 客户端组件可以使用 `useTranslations` 和 `useFormatter` 钩子来访问翻译和格式化函数。这些钩子从 `NextIntlClientProvider` 上下文中读取数据。
 
@@ -427,7 +440,9 @@ const ClientComponent = () => {
 };
 ```
 
-### 第7步：在服务器组件中使用翻译
+</Step>
+
+<Step number={7} title="在服务器组件中使用翻译">
 
 服务器组件不能使用 React 钩子，因此它们通过父组件的 props 接收翻译和格式化函数。这种方法保持服务器组件的同步性，并允许它们嵌套在客户端组件内。
 
@@ -459,9 +474,9 @@ const ServerComponent = ({
 
 > 在你的页面或布局中，使用 `next-intl/server` 中的 `getTranslations` 和 `getFormatter` 预先计算翻译和格式化，然后将它们作为 props 传递给服务器组件。
 
----
+</Step>
 
-### （可选）步骤 8：更改内容语言
+<Step number={8} title="更改内容语言" isOptional={true}>
 
 要使用 next-intl 更改内容语言，渲染指向相同路径名但切换语言环境的本地化链接。Provider 会自动重写 URL，因此你只需针对当前路由即可。
 
@@ -533,7 +548,9 @@ export default function LocaleSwitcher() {
 }
 ```
 
-### （可选）步骤 9：使用本地化的 Link 组件
+</Step>
+
+<Step number={9} title="使用本地化的 Link 组件" isOptional={true}>
 
 `next-intl` 提供了一个子包 `next-intl/navigation`，其中包含一个自动应用当前活动语言环境的本地化链接组件。我们已经在 `@/i18n` 文件中为你提取好了它，所以你可以这样使用：
 
@@ -543,7 +560,9 @@ import { Link } from "@/i18n";
 return <Link href="/about">t("about.title")</Link>;
 ```
 
-### （可选）步骤 10：在服务器操作中访问活动语言环境
+</Step>
+
+<Step number={10} title="在服务器操作中访问活动语言环境" isOptional={true}>
 
 服务器操作可以使用 `next-intl/server` 读取当前语言环境。这对于发送本地化邮件或在提交的数据中存储语言偏好非常有用。
 
@@ -566,7 +585,9 @@ export async function handleContactForm(formData: FormData) {
 
 > `getLocale` 会读取由 `next-intl` 代理设置的 locale，因此它可以在服务器的任何地方使用：路由处理程序、服务器操作和边缘函数。
 
-### （可选）步骤 11：国际化您的元数据
+</Step>
+
+<Step number={11} title="国际化您的元数据" isOptional={true}>
 
 翻译内容很重要，但国际化的主要目标是让您的网站对全世界更具可见性。I18n 是通过适当的 SEO 显著提升您网站可见性的强大杠杆。
 
@@ -605,7 +626,9 @@ export async function generateMetadata({
 // ... 页面其余代码
 ```
 
-### （可选）步骤12：国际化您的网站地图
+</Step>
+
+<Step number={12} title="国际化您的网站地图" isOptional={true}>
 
 生成包含所有页面本地化版本的站点地图。这有助于搜索引擎发现并索引您内容的所有语言版本。
 
@@ -659,7 +682,9 @@ export default function sitemap(): MetadataRoute.Sitemap {
 }
 ```
 
-### （可选）步骤 13：国际化您的 robots.txt
+</Step>
+
+<Step number={13} title="国际化您的 robots.txt" isOptional={true}>
 
 创建一个 robots.txt 文件，正确处理所有受保护路由的所有语言版本。这确保搜索引擎不会索引任何语言的管理员或仪表盘页面。
 
@@ -692,7 +717,9 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### （可选）步骤14：为本地化路由设置代理
+</Step>
+
+<Step number={14} title="为本地化路由设置代理" isOptional={true}>
 
 创建一个代理，自动检测用户的首选语言环境，并将其重定向到相应的带有语言前缀的 URL。next-intl 提供了一个方便的代理函数，可以自动处理此操作。
 
@@ -712,7 +739,9 @@ export const config = {
 };
 ```
 
-### （可选）步骤 15：为语言环境设置 TypeScript 类型
+</Step>
+
+<Step number={15} title="为语言环境设置 TypeScript 类型" isOptional={true}>
 
 设置 TypeScript 将帮助您获得键的自动补全和类型安全。
 
@@ -738,7 +767,9 @@ declare module "next-intl" {
 
 此代码将使用模块增强（Module Augmentation）将 locales 和 messages 添加到 next-intl 的 AppConfig 类型中。
 
-### （可选）步骤 15：使用 Intlayer 自动化您的翻译工作
+</Step>
+
+<Step number={16} title="使用 Intlayer 自动化您的翻译工作" isOptional={true}>
 
 Intlayer 是一个 **免费** 和 **开源** 的库，旨在协助您的应用程序的本地化过程。虽然 next-intl 负责翻译的加载和管理，Intlayer 则帮助自动化翻译工作流程。
 
@@ -763,3 +794,7 @@ Intlayer 允许您：
   Intlayer 提供免费的可视化编辑器，使用可视化编辑器编辑您的内容。了解更多关于[可视化编辑您的翻译](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)的信息。
 
 以及更多功能。要发现 Intlayer 提供的所有功能，请参阅[Intlayer 的优势文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md)。
+
+</Step>
+
+</Steps>

package/dist/cjs/common.cjs

@@ -19,7 +19,7 @@ const getFile = async (files, docKey, locale = defaultLocale) => {
 	if (!files[docKey]) throw new Error(`File ${docKey} not found`);
 	const file = await files[docKey]?.[locale];
 	if (!file) {
-		const englishFile = await files[docKey][defaultLocale];
+		const englishFile = await files[docKey]?.[defaultLocale];
 		if (!englishFile) throw new Error(`File ${docKey} not found`);
 		return englishFile;
 	}

package/dist/cjs/common.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.cjs","names":["Locales"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl } from '@intlayer/core/localization';\nimport { getMarkdownMetadata } from '@intlayer/core/transpiler';\nimport * as Locales from '@intlayer/types/locales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey][defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  applicationShowcase?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const results = await Promise.allSettled(\n    Object.entries(files).map(async ([key]) => {\n      const metadata = await getFileMetadata(files, key as keyof F, locale);\n      return [key, metadata] as [string, FileMetadata];\n    })\n  );\n  const filesEntries = results\n    .filter(\n      (r): r is PromiseFulfilledResult<[string, FileMetadata]> =>\n        r.status === 'fulfilled'\n    )\n    .map((r) => r.value);\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult as Record<keyof F, FileMetadata>;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":";;;;;;;;;AAMA,MAAa,gBAAgBA,wBAAQ;AAErC,MAAa,oBACX;AACF,MAAa,aAAa;AAE1B,MAAa,WAA0C,QACrD,OAAO,KAAK,GAAG;AAEjB,MAAa,WAAW,OAGtB,OACA,OAAsB,kBACc;CACpC,MAAM,eAAe,MAAM,QAAQ,IACjC,OAAO,QAAQ,KAAK,EACjB,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM,KAAsB,CAAC,EACzD,IAAI,OAAO,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM,KAAK,CAAC,CACnD;CAEA,OADoB,OAAO,YAAY,YACtB;AACnB;AAEA,MAAa,UAAU,OAGrB,OACA,QACA,SAAwB,kBACJ;CAGpB,IAAI,CAFe,MAAM,SAGvB,MAAM,IAAI,MAAM,QAAQ,OAAiB,WAAW;CAGtD,MAAM,OAAO,MAAM,MAAM,UAAU;CAEnC,IAAI,CAAC,MAAM;EACT,MAAM,cAAc,MAAM,MAAM,QAAQ;EAExC,IAAI,CAAC,aACH,MAAM,IAAI,MAAM,QAAQ,OAAiB,WAAW;EAGtD,OAAO;CACT;CAEA,OAAO;AACT;AAwBA,MAAa,kBACX,QACA,MACA,SAAwB,kBACP;CACjB,MAAM,8DAA+B,IAAI;CAEzC,MAAM,SAAS,SAAS,SAAS,CAAC,GAAG,IAAI,MAAM;CAC/C,MAAM,YAAY,SAAS,YAAY,CAAC,GAAG,IAAI,MAAM;CAErD,MAAM,kCAAmB,KAAK,GAAG,KAAK;CAEtC,MAAM,eAAe,OAAO,MAAM,CAAC;CAEnC,OAAO;EACL,GAAG;EACH;EACA;EACA;EACA,WAAW,GAAG,oBAAoB,eAAe,QAC/C,QACA,IAAI,OAAO,EACb;EACA,8DAA6B,aAAa,MAAM;EAChD,0EAA0B,YAAY,WAAW,GAAG,MAAM;CAC5D;AACF;AAEA,MAAa,kBAAkB,OAI7B,OACA,QACA,SAAwB,kBACT;CAGf,OAAO,eAAe,QAAkB,MAFrB,QAAQ,OAAO,QAAQ,MAAM,GAEF,MAAM;AACtD;AAEA,MAAa,wBAAwB,OAGnC,OACA,SAAwB,kBACmB;CAO3C,MAAM,gBAAe,MANC,QAAQ,WAC5B,OAAO,QAAQ,KAAK,EAAE,IAAI,OAAO,CAAC,SAAS;EAEzC,OAAO,CAAC,KAAK,MADU,gBAAgB,OAAO,KAAgB,MAAM,CAC/C;CACvB,CAAC,CACH,GAEG,QACE,MACC,EAAE,WAAW,WACjB,EACC,KAAK,MAAM,EAAE,KAAK;CAErB,OADoB,OAAO,YAAY,YACtB;AACnB;AAEA,MAAa,wBAAwB,OAGnC,OACA,OACA,SAAwB,eACxB,SAAS,UACN;CACH,MAAM,aAAa,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;CACxD,MAAM,gBAAgB,MAAM,sBAC1B,OACA,aACF;CAEA,IAAI,oBAAoC,OAAO,OAAO,aAAa,EAAE,QAClE,iBACC,WAAW,OAAO,SAAS,aAAa,OAAO,SAAS,IAAI,CAAC,CACjE;CAEA,IAAI,QACF,oBAAoB,kBAAkB,QACnC,iBAAiB,aAAa,MAAM,WAAW,WAAW,MAC7D;CAGF,IAAI,WAAW,eAQb,OAAO,MAP6B,QAAQ,IAC1C,kBAAkB,IAChB,OAAO,iBACL,MAAM,gBAAgB,OAAO,aAAa,QAAQ,MAAM,CAC5D,CACF;CAKF,OAAO;AACT;AAEA,MAAa,gBAAgB,OAG3B,OACA,OACA,SAAwB,eACxB,SAAS,UACN;CACH,MAAM,aAAa,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;CACxD,MAAM,gBAAgB,MAAM,sBAC1B,OACA,aACF;CAEA,IAAI,oBAAoB,OAAO,OAAO,aAAa,EAAE,QAAQ,iBAC3D,WAAW,OAAO,SAAS,aAAa,OAAO,SAAS,IAAI,CAAC,CAC/D;CAEA,IAAI,QACF,oBAAoB,kBAAkB,QACnC,iBAAiB,aAAa,MAAM,WAAW,WAAW,MAC7D;CAUF,OAAO,MAPgB,QAAQ,IAC7B,kBAAkB,IAAI,OAAO,iBAAiB;EAE5C,OAAO,MADY,QAAQ,OAAO,aAAa,QAAQ,MAAM;CAE/D,CAAC,CACH;AAGF"}
+{"version":3,"file":"common.cjs","names":["Locales"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl } from '@intlayer/core/localization';\nimport { getMarkdownMetadata } from '@intlayer/core/transpiler';\nimport * as Locales from '@intlayer/types/locales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey]?.[defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  applicationShowcase?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const results = await Promise.allSettled(\n    Object.entries(files).map(async ([key]) => {\n      const metadata = await getFileMetadata(files, key as keyof F, locale);\n      return [key, metadata] as [string, FileMetadata];\n    })\n  );\n  const filesEntries = results\n    .filter(\n      (r): r is PromiseFulfilledResult<[string, FileMetadata]> =>\n        r.status === 'fulfilled'\n    )\n    .map((r) => r.value);\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult as Record<keyof F, FileMetadata>;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}

package/dist/esm/common.mjs

@@ -16,7 +16,7 @@ const getFile = async (files, docKey, locale = defaultLocale) => {
 	if (!files[docKey]) throw new Error(`File ${docKey} not found`);
 	const file = await files[docKey]?.[locale];
 	if (!file) {
-		const englishFile = await files[docKey][defaultLocale];
+		const englishFile = await files[docKey]?.[defaultLocale];
 		if (!englishFile) throw new Error(`File ${docKey} not found`);
 		return englishFile;
 	}