@intlayer/docs 8.11.2 → 8.11.3

package/docs/vi/intlayer_with_svelte_kit.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-11-20
-updatedAt: 2026-05-06
-title: SvelteKit i18n - Cách dịch ứng dụng SvelteKit năm 2026
-description: Khám phá cách làm cho trang web SvelteKit của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó bằng cách sử dụng Server-Side Rendering (SSR).
+updatedAt: 2026-05-31
+title: SvelteKit i18n - Hướng dẫn đầy đủ để dịch SvelteKit
+description: Giải pháp tốt nhất cho kích thước bundle, SEO, hiệu suất & khả năng bảo trì. Làm cho SvelteKit trang web của bạn đa ngôn ngữ vào năm 2026, dịch thuật LLM, Agent Skills & MCP.
 keywords:
   - Quốc tế hóa
   - Tài liệu
@@ -59,16 +59,47 @@ history:
 
 <TOC/>
 
-## Intlayer là gì?
+## Tại sao Intlayer thay thế các lựa chọn thay thế?
 
-**Intlayer** là một thư viện quốc tế hóa (i18n) mã nguồn mở sáng tạo, được thiết kế để đơn giản hóa việc hỗ trợ đa ngôn ngữ trong các ứng dụng web hiện đại. Nó hoạt động liền mạch với khả năng Server-Side Rendering (SSR) của **SvelteKit**.
+So với các giải pháp chính như `svelte-i18n` hay `i18next`, Intlayer là giải pháp đi kèm với các tính năng tối ưu hóa tích hợp như:
 
-Với Intlayer, bạn có thể:
+<AccordionGroup>
+<Accordion header="Phủ sóng đầy đủ của SvelteKit">
 
-- **Dễ dàng quản lý bản dịch** bằng cách sử dụng các từ điển khai báo ở cấp độ component.
-- **Định vị hóa động metadata**, các route và nội dung.
-- **Đảm bảo hỗ trợ TypeScript** với các kiểu được tạo tự động.
-- **Tận dụng SSR của SvelteKit** để quốc tế hóa thân thiện với SEO.
+Intlayer được tối ưu hóa để hoạt động hoàn hảo với SvelteKit bằng cách cung cấp **định tuyến đa ngôn ngữ**, **hỗ trợ SSR** và tất cả các tính năng cần thiết để mở rộng quy mô quốc tế hóa (i18n).
+
+</Accordion>
+<Accordion header="Kích thước bundle">
+
+Thay vì tải các tệp JSON lớn vào trang của bạn, hãy chỉ tải nội dung cần thiết. Intlayer giúp **giảm tới 50% kích thước bundle và kích thước trang**.
+
+</Accordion>
+<Accordion header="Khả năng bảo trì">
+
+Xác định phạm vi nội dung ứng dụng của bạn **tạo điều kiện bảo trì** cho các ứng dụng quy mô lớn. Bạn có thể sao chép hoặc xóa một thư mục tính năng mà không phải lo lắng về việc xem lại toàn bộ cơ sở mã nội dung của mình. Ngoài ra, Intlayer **được nhập đầy đủ** để đảm bảo tính chính xác cho nội dung của bạn.
+
+</Accordion>
+<Accordion header="Đại lý AI">
+
+Nội dung cùng định vị **giảm ngữ cảnh cần thiết** của Mô hình ngôn ngữ lớn (LLM). Intlayer cũng đi kèm một bộ công cụ, chẳng hạn như **CLI** để kiểm tra các bản dịch bị thiếu,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** và **[agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, để giúp trải nghiệm của nhà phát triển (DX) trở nên mượt mà hơn nữa đối với các tác nhân AI.
+
+</Accordion>
+<Accordion header="Tự động hóa">
+
+Sử dụng tính năng tự động hóa để dịch trong quy trình CI/CD của bạn bằng cách sử dụng LLM mà bạn chọn với chi phí do nhà cung cấp AI của bạn chi trả. Intlayer cũng cung cấp **trình biên dịch** để tự động trích xuất nội dung cũng như [nền tảng web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) để giúp **dịch ở chế độ nền**.
+
+</Accordion>
+<Accordion header="Hiệu suất">
+
+Việc kết nối các tệp JSON lớn với các thành phần có thể dẫn đến các vấn đề về hiệu suất và khả năng phản hồi. Intlayer tối ưu hóa việc tải nội dung của bạn tại thời điểm build.
+
+</Accordion>
+<Accordion header="Mở rộng quy mô không có nhà phát triển">
+
+Không chỉ là giải pháp i18n, Intlayer còn cung cấp **[trình chỉnh sửa trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** và **[CMS đầy đủ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** để giúp bạn quản lý nội dung đa ngôn ngữ của mình trong **thời gian thực**, giúp việc cộng tác với người dịch, người viết quảng cáo và các thành viên khác trong nhóm trở nên liền mạch. Nội dung có thể được lưu trữ cục bộ và/hoặc từ xa.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -116,7 +147,9 @@ Với Intlayer, bạn có thể:
 └── vite.config.ts
 ```
 
-### 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 bằng npm:
 
@@ -148,7 +181,9 @@ bun x intlayer init
 - **svelte-intlayer**: Cung cấp các context provider và store cho Svelte/SvelteKit.
 - **vite-intlayer**: Plugin Vite để tích hợp khai báo nội dung với quá trình build.
 
-### 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 file cấu hình trong thư mục gốc của dự án:
 
@@ -165,7 +200,9 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Bước 3: Tích hợp Intlayer vào cấu hình Vite của bạn
+</Step>
+
+<Step number={3} title="Tích hợp Intlayer vào cấu hình Vite của bạn">
 
 Cập nhật `vite.config.ts` của bạn để bao gồm plugin Intlayer. Plugin này xử lý việc transpile các file nội dung của bạn.
 
@@ -179,7 +216,9 @@ export default defineConfig({
 });
 ```
 
-### Bước 4: Khai báo Nội dung của bạn
+</Step>
+
+<Step number={4} title="Khai báo Nội dung của bạn">
 
 Tạo các file khai báo nội dung ở bất kỳ đâu trong thư mục `src` của bạn (ví dụ: `src/lib/content` hoặc cùng thư mục với các component của bạn). Các file này định nghĩa nội dung có thể dịch cho ứng dụng của bạn bằng cách sử dụng hàm `t()` cho từng locale.
 
@@ -200,13 +239,15 @@ const heroContent = {
 export default heroContent;
 ```
 
-### Bước 5: Sử dụng Intlayer trong các Component của bạn
+</Step>
+
+<Step number={5} title="Sử dụng Intlayer trong các Component của bạn">
 
 Bây giờ bạn có thể sử dụng hàm `useIntlayer` trong bất kỳ component Svelte nào. Hàm này trả về một store phản ứng tự động cập nhật khi locale thay đổi. Hàm sẽ tự động tuân theo locale hiện tại (cả trong SSR và điều hướng phía client).
 
 > **Lưu ý:** `useIntlayer` trả về một store của Svelte, vì vậy bạn cần sử dụng tiền tố `---
 > createdAt: 2025-11-20
-> updatedAt: 2026-05-06
+> updatedAt: 2026-05-31
 > title: Cách dịch ứng dụng SvelteKit của bạn – hướng dẫn i18n 2026
 > description: Khám phá cách làm cho trang web SvelteKit của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó bằng cách sử dụng Server-Side Rendering (SSR).
 > keywords:
@@ -231,6 +272,10 @@ Bây giờ bạn có thể sử dụng hàm `useIntlayer` trong bất kỳ compo
 
 # Dịch trang web SvelteKit của bạn bằng Intlayer | Quốc tế hóa (i18n)
 
+</Step>
+
+</Steps>
+
 ## Mục lục
 
 <TOC/>
@@ -292,7 +337,9 @@ Với Intlayer, bạn có thể:
 └── vite.config.ts
 ```
 
-### 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 bằng npm:
 
@@ -324,7 +371,9 @@ bun x intlayer init
 - **svelte-intlayer**: Cung cấp các context provider và store cho Svelte/SvelteKit.
 - **vite-intlayer**: Plugin Vite để tích hợp khai báo nội dung với quá trình build.
 
-### 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 file cấu hình trong thư mục gốc của dự án:
 
@@ -341,7 +390,9 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Bước 3: Tích hợp Intlayer vào cấu hình Vite của bạn
+</Step>
+
+<Step number={3} title="Tích hợp Intlayer vào cấu hình Vite của bạn">
 
 Cập nhật `vite.config.ts` của bạn để bao gồm plugin Intlayer. Plugin này xử lý việc transpile các file nội dung của bạn.
 
@@ -355,7 +406,9 @@ export default defineConfig({
 });
 ```
 
-### Bước 4: Khai báo Nội dung của bạn
+</Step>
+
+<Step number={4} title="Khai báo Nội dung của bạn">
 
 Tạo các file khai báo nội dung ở bất kỳ đâu trong thư mục `src` của bạn (ví dụ: `src/lib/content` hoặc cùng thư mục với các component của bạn). Các file này định nghĩa nội dung có thể dịch cho ứng dụng của bạn bằng cách sử dụng hàm `t()` cho từng locale.
 
@@ -376,7 +429,9 @@ const heroContent = {
 export default heroContent;
 ```
 
-### Bước 5: Sử dụng Intlayer trong các Component của bạn
+</Step>
+
+<Step number={5} title="Sử dụng Intlayer trong các Component của bạn">
 
 để truy cập giá trị phản ứng của nó (ví dụ: `$content.title`).
 
@@ -398,7 +453,9 @@ export default heroContent;
 <div aria-label={String($content.title)}></div>
 ```
 
-### (Tùy chọn) Bước 6: Thiết lập routing
+</Step>
+
+<Step number={6} title="Thiết lập routing" isOptional={true}>
 
 Các bước sau đây hướng dẫn cách thiết lập routing dựa trên locale trong SvelteKit. Điều này cho phép URL của bạn bao gồm tiền tố locale (ví dụ: `/en/about`, `/fr/about`) để cải thiện SEO và trải nghiệm người dùng.
 
@@ -423,7 +480,9 @@ Các bước sau đây hướng dẫn cách thiết lập routing dựa trên lo
         └── +layout.svelte         # Bố cục gốc cho font chữ và kiểu toàn cục
 ```
 
-### Bước 7: Xử lý phát hiện locale phía Server (Hooks)
+</Step>
+
+<Step number={7} title="Xử lý phát hiện locale phía Server">
 
 Trong SvelteKit, server cần biết locale của người dùng để render nội dung chính xác trong SSR. Chúng ta sử dụng `hooks.server.ts` để phát hiện locale từ URL hoặc cookies.
 
@@ -635,7 +694,9 @@ export const prerender = true;
 </style>
 ```
 
-### (Tùy chọn) Bước 8: Liên kết quốc tế hóa
+</Step>
+
+<Step number={8} title="Liên kết quốc tế hóa" isOptional={true}>
 
 Để tối ưu SEO, nên thêm tiền tố locale vào các route của bạn (ví dụ: `/en/about`, `/fr/about`). Thành phần này tự động thêm tiền tố locale hiện tại vào bất kỳ liên kết nào.
 
@@ -668,7 +729,9 @@ const localizedPath = getLocalizedUrl("/about", $locale);
 goto(localizedPath); // Điều hướng đến /en/about hoặc /fr/about tùy theo locale
 ```
 
-### (Tùy chọn) Bước 9: Bộ chuyển đổi ngôn ngữ
+</Step>
+
+<Step number={9} title="Bộ chuyển đổi ngôn ngữ" isOptional={true}>
 
 Để cho phép người dùng chuyển đổi ngôn ngữ, cập nhật URL.
 
@@ -709,7 +772,9 @@ goto(localizedPath); // Điều hướng đến /en/about hoặc /fr/about tùy
 </style>
 ```
 
-### (Tùy chọn) Bước 10: Thêm proxy backend
+</Step>
+
+<Step number={10} title="Thêm proxy backend" isOptional={true}>
 
 Để thêm proxy backend vào ứng dụng SvelteKit của bạn, bạn có thể sử dụng hàm `intlayerProxy` được cung cấp bởi plugin `vite-intlayer`. Plugin này sẽ tự động phát hiện locale tốt nhất cho người dùng dựa trên URL, cookie và sở thích ngôn ngữ trình duyệt.
 
@@ -728,7 +793,9 @@ export default defineConfig({
 });
 ```
 
-### (Tùy chọn) Bước 11: Thiết lập trình chỉnh sửa intlayer / CMS
+</Step>
+
+<Step number={11} title="Thiết lập trình chỉnh sửa intlayer / CMS" isOptional={true}>
 
 Để thiết lập trình chỉnh sửa intlayer, bạn phải làm theo [tài liệu trình chỉnh sửa intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).
 
@@ -764,7 +831,9 @@ Khuyến nghị bỏ qua các tệp được tạo bởi Intlayer.
 
 ---
 
-### (Tùy chọn) Bước 1 : Trích xuất nội dung các thành phần của bạn
+</Step>
+
+<Step number={1} title="Trích xuất nội dung các thành phần của bạn" isOptional={true}>
 
 Nếu bạn có một cơ sở mã hiện có, việc chuyển đổi hàng nghìn tệp có thể tốn nhiều thời gian.
 
@@ -864,3 +933,7 @@ bun run build # Or bun run dev
 
 - **Trình chỉnh sửa trực quan**: Tích hợp [Trình chỉnh sửa trực quan Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md) để chỉnh sửa bản dịch trực tiếp từ giao diện người dùng.
 - **CMS**: Đưa việc quản lý nội dung của bạn ra bên ngoài bằng cách sử dụng [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md).
+
+</Step>
+
+</Steps>

package/docs/vi/intlayer_with_tanstack+solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-03-25
-updatedAt: 2026-05-06
-title: i18n Tanstack Start - Cách dịch ứng dụng Tanstack Start sử dụng Solid.js vào năm 2026
-description: Tìm hiểu cách thêm đa ngôn ngữ (i18n) vào ứng dụng Tanstack Start của bạn bằng Intlayer và Solid.js. Làm theo hướng dẫn toàn diện này để tạo ứng dụng đa ngôn ngữ với điều hướng theo ngôn ngữ.
+updatedAt: 2026-05-31
+title: i18n Tanstack Start - Hướng dẫn đầy đủ để dịch TanStack Start
+description: Giải pháp tốt nhất cho kích thước bundle, SEO, hiệu suất & khả năng bảo trì. Làm cho TanStack Start and Solid ứng dụng của bạn đa ngôn ngữ vào năm 2026, dịch thuật LLM, Agent Skills & MCP.
 keywords:
   - Đa ngôn ngữ
   - Tài liệu
@@ -37,17 +37,47 @@ history:
 
 Hướng dẫn này trình bày cách tích hợp **Intlayer** để đa ngôn ngữ hóa một cách liền mạch trong các dự án Tanstack Start với Solid.js, điều hướng theo ngôn ngữ (locale-aware routing), hỗ trợ TypeScript và các phương pháp phát triển hiện đại.
 
-## Intlayer là gì?
+## Tại sao Intlayer thay thế các lựa chọn thay thế?
 
-**Intlayer** là một thư viện đa ngôn ngữ (i18n) sáng tạo, mã nguồn mở được thiết kế để đơn giản hóa việc hỗ trợ đa ngôn ngữ trong các ứng dụng web hiện đại.
+So với các giải pháp chính như `react-i18next` hay `i18next`, Intlayer là giải pháp đi kèm với các tính năng tối ưu hóa tích hợp như:
 
-Với Intlayer, bạn có thể:
+<AccordionGroup>
+<Accordion header="Phạm vi bảo hiểm đầy đủ của TanStack Start">
 
-- **Quản lý bản dịch dễ dàng** bằng các từ điển khai báo ở cấp độ component.
-- **Bản địa hóa metadata, route và nội dung một cách linh hoạt**.
-- **Đảm bảo hỗ trợ TypeScript** với các kiểu dữ liệu được tạo tự động, cải thiện tính năng tự động hoàn thành và phát hiện lỗi.
-- **Hưởng lợi từ các tính năng nâng cao**, chẳng hạn như tự động phát hiện và chuyển đổi ngôn ngữ.
-- **Kích hoạt điều hướng theo ngôn ngữ** với hệ thống điều hướng dựa trên tệp tin của Tanstack Start.
+Intlayer được tối ưu hóa để hoạt động hoàn hảo với TanStack Start và Solid bằng cách cung cấp **định tuyến đa ngôn ngữ**, **sơ đồ trang web** và tất cả các tính năng cần thiết để mở rộng quy mô quốc tế hóa (i18n).
+
+</Accordion>
+<Accordion header="Kích thước bundle">
+
+Thay vì tải các tệp JSON lớn vào trang của bạn, hãy chỉ tải nội dung cần thiết. Intlayer giúp **giảm tới 50% kích thước bundle và kích thước trang**.
+
+</Accordion>
+<Accordion header="Khả năng bảo trì">
+
+Xác định phạm vi nội dung ứng dụng của bạn **tạo điều kiện bảo trì** cho các ứng dụng quy mô lớn. Bạn có thể sao chép hoặc xóa một thư mục tính năng mà không phải lo lắng về việc xem lại toàn bộ cơ sở mã nội dung của mình. Ngoài ra, Intlayer **được nhập đầy đủ** để đảm bảo tính chính xác cho nội dung của bạn.
+
+</Accordion>
+<Accordion header="Đại lý AI">
+
+Nội dung cùng định vị **giảm ngữ cảnh cần thiết** của Mô hình ngôn ngữ lớn (LLM). Intlayer cũng đi kèm một bộ công cụ, chẳng hạn như **CLI** để kiểm tra các bản dịch bị thiếu,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** và **[agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, để giúp trải nghiệm của nhà phát triển (DX) trở nên mượt mà hơn nữa đối với các tác nhân AI.
+
+</Accordion>
+<Accordion header="Tự động hóa">
+
+Sử dụng tính năng tự động hóa để dịch trong quy trình CI/CD của bạn bằng cách sử dụng LLM mà bạn chọn với chi phí do nhà cung cấp AI của bạn chi trả. Intlayer cũng cung cấp **trình biên dịch** để tự động trích xuất nội dung cũng như [nền tảng web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) để giúp **dịch ở chế độ nền**.
+
+</Accordion>
+<Accordion header="Hiệu suất">
+
+Việc kết nối các tệp JSON lớn với các thành phần có thể dẫn đến các vấn đề về hiệu suất và khả năng phản hồi. Intlayer tối ưu hóa việc tải nội dung của bạn tại thời điểm build.
+
+</Accordion>
+<Accordion header="Mở rộng quy mô không có nhà phát triển">
+
+Không chỉ là giải pháp i18n, Intlayer còn cung cấp **[trình chỉnh sửa trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** và **[CMS đầy đủ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** để giúp bạn quản lý nội dung đa ngôn ngữ của mình trong **thời gian thực**, giúp việc cộng tác với người dịch, người viết quảng cáo và các thành viên khác trong nhóm trở nên liền mạch. Nội dung có thể được lưu trữ cục bộ và/hoặc từ xa.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -85,11 +115,15 @@ Với Intlayer, bạn có thể:
 
 Xem [Mẫu ứng dụng](https://github.com/aymericzip/intlayer-tanstack-start-solid-template) trên GitHub.
 
-### Bước 1: Tạo dự án
+<Steps>
+
+<Step number={1} title="Tạo dự án">
 
 Đầu tiên, tạo một dự án TanStack Start mới theo hướng dẫn [Bắt đầu dự án mới](https://tanstack.com/start/latest/docs/framework/solid/quick-start) trên trang web TanStack Start.
 
-### Bước 2: Cài đặt các gói Intlayer
+</Step>
+
+<Step number={2} title="Cài đặt các gói Intlayer">
 
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
@@ -127,7 +161,9 @@ bun x intlayer init
 - **vite-intlayer**
   Bao gồm plugin Vite để tích hợp Intlayer với [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production), cũng như middleware để phát hiện ngôn ngữ ưa thích của người dùng, quản lý cookie và xử lý chuyển hướng URL.
 
-### Bước 3: Cấu hình dự án của bạn
+</Step>
+
+<Step number={3} title="Cấu hình dự án của bạn">
 
 Tạo tệp cấu hình để thiết lập các ngôn ngữ trong ứng dụng của bạn:
 
@@ -148,7 +184,9 @@ export default config;
 
 > Thông qua tệp cấu hình này, bạn có thể cấu hình các URL đa ngôn ngữ, chuyển hướng middleware, tên cookie, vị trí và phần mở rộng của các khai báo nội dung, tắt log của Intlayer trong console, v.v. Để biết danh sách đầy đủ các tham số khả dụng, hãy tham khảo [tài liệu cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
 
-### Bước 4: Tích hợp Intlayer vào cấu hình Vite
+</Step>
+
+<Step number={4} title="Tích hợp Intlayer vào cấu hình Vite">
 
 Thêm plugin intlayer vào cấu hình của bạn:
 
@@ -176,7 +214,9 @@ export default defineConfig({
 
 > Plugin Vite `intlayer()` được sử dụng để tích hợp Intlayer với Vite. Nó đảm bảo việc xây dựng các tệp khai báo nội dung và theo dõi chúng trong chế độ phát triển. Nó định nghĩa các biến môi trường Intlayer trong ứng dụng Vite. Ngoài ra, nó cung cấp các alias để giảm chi phí hiệu năng.
 
-### Bước 5: Tạo Root Layout
+</Step>
+
+<Step number={5} title="Tạo Root Layout">
 
 Cấu hình layout gốc của bạn để hỗ trợ đa ngôn ngữ bằng cách sử dụng `useParams` để phát hiện ngôn ngữ hiện tại và thiết lập các thuộc tính `lang` và `dir` trên thẻ `html`.
 
@@ -217,7 +257,9 @@ const RootComponent: ParentComponent = (props) => {
 };
 ```
 
-### Bước 6: Tạo Locale Layout (Tùy chọn)
+</Step>
+
+<Step number={6} title="Tạo Locale Layout">
 
 Tạo một layout để xử lý tiền tố ngôn ngữ và thực hiện kiểm tra tính hợp lệ. Layout này sẽ đảm bảo chỉ các ngôn ngữ hợp lệ mới được xử lý.
 
@@ -252,7 +294,9 @@ export const Route = createFileRoute("/{-$locale}")({
 > Đối với chế độ `'prefix-all'`, bạn có thể thích chuyển slot thành `$locale`.
 > Đối với chế độ `'no-prefix'` hoặc `'search-params'`, bạn có thể xóa hoàn toàn slot này.
 
-### Bước 7: Khai báo nội dung của bạn
+</Step>
+
+<Step number={7} title="Khai báo nội dung của bạn">
 
 Tạo và quản lý các khai báo nội dung để lưu trữ bản dịch:
 
@@ -298,7 +342,9 @@ export default appContent;
 
 > Để biết thêm chi tiết, hãy tham khảo [tài liệu khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
 
-### Bước 8: Sử dụng các Component và Hook theo ngôn ngữ
+</Step>
+
+<Step number={8} title="Sử dụng các Component và Hook theo ngôn ngữ">
 
 Tạo một component `LocalizedLink` để điều hướng theo ngôn ngữ:
 
@@ -377,7 +423,9 @@ export const useLocalizedNavigate = () => {
 };
 ```
 
-### Bước 9: Sử dụng Intlayer trong các trang của bạn
+</Step>
+
+<Step number={9} title="Sử dụng Intlayer trong các trang của bạn">
 
 Truy cập các từ điển nội dung của bạn trong toàn bộ ứng dụng:
 
@@ -420,7 +468,9 @@ function RouteComponent() {
 >
 > Để tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/solid-intlayer/useIntlayer.md).
 
-### Bước 10: Tạo Component Chuyển đổi Ngôn ngữ
+</Step>
+
+<Step number={10} title="Tạo Component Chuyển đổi Ngôn ngữ">
 
 Tạo một component để cho phép người dùng thay đổi ngôn ngữ:
 
@@ -464,7 +514,9 @@ export default LocaleSwitcher;
 >
 > Để tìm hiểu thêm về hook `useLocale`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/solid-intlayer/useLocale.md).
 
-### Bước 11: Quản lý các thuộc tính HTML
+</Step>
+
+<Step number={11} title="Quản lý các thuộc tính HTML">
 
 Như đã thấy ở Bước 5, bạn có thể quản lý các thuộc tính `lang` và `dir` của thẻ `html` bằng cách sử dụng `useParams` trong component gốc của mình. Điều này đảm bảo rằng các thuộc tính chính xác được thiết lập trên cả server và client.
 
@@ -483,7 +535,9 @@ const RootComponent: ParentComponent = (props) => {
 
 ---
 
-### Bước 12: Thêm Middleware (Tùy chọn)
+</Step>
+
+<Step number={12} title="Thêm Middleware">
 
 Bạn cũng có thể sử dụng `intlayerProxy` để thêm điều hướng phía server cho ứng dụng của mình. Plugin này sẽ tự động phát hiện ngôn ngữ hiện tại dựa trên URL và thiết lập cookie ngôn ngữ phù hợp. Nếu không có ngôn ngữ nào được chỉ định, plugin sẽ xác định ngôn ngữ phù hợp nhất dựa trên tùy chọn ngôn ngữ trình duyệt của người dùng. Nếu không phát hiện được ngôn ngữ nào, nó sẽ chuyển hướng về ngôn ngữ mặc định.
 
@@ -514,7 +568,9 @@ export default defineConfig({
 
 ---
 
-### Bước 13: Đa ngôn ngữ hóa Metadata của bạn (Tùy chọn)
+</Step>
+
+<Step number={13} title="Đa ngôn ngữ hóa Metadata của bạn">
 
 Bạn cũng có thể sử dụng hàm `getIntlayer` để truy cập các từ điển nội dung của mình trong hàm load `head` cho metadata theo ngôn ngữ:
 
@@ -561,7 +617,9 @@ export const Route = createFileRoute("/{-$locale}/")({
 
 ---
 
-### Bước 14: Lấy ngôn ngữ trong các server action của bạn (Tùy chọn)
+</Step>
+
+<Step number={14} title="Lấy ngôn ngữ trong các server action của bạn">
 
 Bạn có thể muốn truy cập ngôn ngữ hiện tại từ bên trong các server action hoặc API endpoint của mình.
 Bạn có thể làm điều này bằng cách sử dụng helper `getLocale` từ `intlayer`.
@@ -598,7 +656,9 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### Bước 15: Quản lý các trang không tìm thấy (404) (Tùy chọn)
+</Step>
+
+<Step number={15} title="Quản lý các trang không tìm thấy (404)" isOptional={true}>
 
 Khi một người dùng truy cập vào một trang không tồn tại, bạn có thể hiển thị một trang không tìm thấy tùy chỉnh và tiền tố ngôn ngữ có thể ảnh hưởng đến cách trang không tìm thấy được kích hoạt.
 
@@ -672,7 +732,9 @@ export const Route = createFileRoute("/{-$locale}/$")({
 });
 ```
 
-### (Tùy chọn) Bước 16: Trích xuất nội dung từ các component của bạn
+</Step>
+
+<Step number={16} title="Trích xuất nội dung từ các component của bạn" isOptional={true}>
 
 Nếu bạn có một codebase hiện tại, việc chuyển đổi hàng nghìn tệp có thể tốn nhiều thời gian.
 
@@ -785,7 +847,9 @@ bun run build # Hoặc bun run dev
 
 ---
 
-### Bước 17: Cấu hình TypeScript (Tùy chọn)
+</Step>
+
+<Step number={17} title="Cấu hình TypeScript">
 
 Intlayer sử dụng module augmentation để tận dụng các lợi ích của TypeScript và giúp codebase của bạn mạnh mẽ hơn.
 
@@ -816,6 +880,10 @@ Khuyên bạn nên bỏ qua các tệp do Intlayer tạo ra. Điều này cho ph
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Tiện ích mở rộng VS Code
 
 Để cải thiện trải nghiệm phát triển của bạn với Intlayer, bạn có thể cài đặt **Tiện ích mở rộng Intlayer VS Code** chính thức.