@intlayer/docs 9.5.6 → 9.5.8

package/docs/vi/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Tìm hiểu cách sử dụng lệnh init infra của Intlayer CLI để cài đặt ứng dụng máy tính để bàn hoặc tự lưu trữ Intlayer CMS với Docker (vùng chứa tất cả trong một hoặc ngăn xếp Docker Compose).
+keywords:
+  - CLI
+  - Cơ sở hạ tầng
+  - Tự lưu trữ
+  - Ứng dụng máy tính để bàn
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Thêm lệnh init infra"
+author: aymericzip
+---
+
+# Lệnh Intlayer CLI Init Infra
+
+## Mô tả
+
+Lệnh `init infra` thiết lập cơ sở hạ tầng Intlayer trên máy của bạn. Nó tải xuống trình cài đặt được lưu trữ cho nền tảng của bạn (`https://intlayer.org/install.sh` trên macOS / Linux, `https://intlayer.org/install.ps1` trên Windows) và chạy nó trong terminal của bạn, hiển thị trực tiếp menu và tiến trình cài đặt.
+
+Trình cài đặt sẽ hỏi bạn muốn chạy Intlayer như thế nào:
+
+- **Ứng dụng máy tính để bàn**: tải xuống bảng điều khiển gốc cho hệ điều hành và CPU của bạn rồi mở hoặc cài đặt nó. Phiên bản máy tính để bàn kết nối với backend Intlayer Cloud.
+- **Docker tất cả trong một (All-in-one)**: bảng điều khiển + API + MongoDB + Redis + MinIO trong một vùng chứa duy nhất với một ổ đĩa lưu trữ. Ghi tệp `./intlayer.env` với các khóa bí mật được tạo và kéo hình ảnh `intlayer/cms-all`.
+- **Docker Compose**: một vùng chứa cho mỗi dịch vụ, để tự lưu trữ có thể mở rộng. Ghi `docker-compose.yml` và `.env` vào `./intlayer/` và kéo các hình ảnh.
+
+Trình cài đặt được lưu trữ là nguồn chân lý duy nhất cho quy trình thiết lập: CLI chạy nó thay vì triển khai lại các bước tương tự, do đó `npx intlayer init infra` và `curl -fsSL https://intlayer.org/install.sh | sh` thực hiện hoàn toàn giống nhau.
+
+## Cách sử dụng
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+Bước tương tự cũng được cung cấp trong danh sách kiểm tra của `npx intlayer init --interactive`, tại mục **Cơ sở hạ tầng (ứng dụng máy tính để bàn / tự lưu trữ)**.
+
+## Tùy chọn
+
+- `-m, --mode <mode>` - Tùy chọn. Bỏ qua menu của trình cài đặt và chạy trực tiếp một chế độ. Các giá trị được chấp nhận: `desktop`, `docker` (tất cả trong một) hoặc `compose`. Bất kỳ giá trị nào khác sẽ thoát với lỗi liệt kê các chế độ hợp lệ.
+
+## Ví dụ
+
+### Chọn chế độ tương tác
+
+```bash
+npx intlayer init infra
+```
+
+### Cài đặt ứng dụng máy tính để bàn
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Tự lưu trữ với vùng chứa tất cả trong một
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Tự lưu trữ với Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Đầu ra ví dụ
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## Cài đặt của trình cài đặt
+
+Trình cài đặt đọc một số biến môi trường mà CLI chuyển tiếp nguyên vẹn. Hãy đặt chúng trong shell của bạn trước khi chạy lệnh:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Biến                      | Mặc định                  | Áp dụng cho | Mô tả                                                     |
+| ------------------------- | ------------------------- | ----------- | --------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(được hỏi)_              | tất cả      | `desktop`, `docker` hoặc `compose`, tương tự như `--mode` |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop     | Nơi lưu trình cài đặt ứng dụng                            |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker      | Hình ảnh tất cả trong một cần tải                         |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker      | Nơi ghi tệp cấu hình môi trường                           |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker      | Tên vùng chứa                                             |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker      | Ổ đĩa có tên được gắn tại `/data`                         |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker      | Cổng máy chủ cho bảng điều khiển                          |
+| `INTLAYER_API_PORT`       | `3100`                    | docker      | Cổng máy chủ cho API                                      |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker      | Cổng máy chủ cho MinIO S3 API                             |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker      | Cổng máy chủ cho bảng điều khiển MinIO                    |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose     | Nơi ghi `docker-compose.yml` và `.env`                    |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | cả hai      | Nhánh Git dùng để lấy tệp compose và mẫu env              |
+
+> Các biến cổng chỉ thay đổi phía **máy chủ (host)** của ánh xạ. Các hình ảnh đã xuất bản đã biên dịch sẵn `http://localhost:3000`, `http://localhost:3100` và `http://localhost:9000` vào gói bảng điều khiển, vì vậy hãy giữ nguyên mặc định trừ khi bạn tự xây dựng hình ảnh: xem [hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md#limitations).
+
+## Yêu cầu
+
+- **Ứng dụng máy tính để bàn** cần [Node.js](https://nodejs.org): ứng dụng nhúng máy chủ bảng điều khiển và khởi chạy nó bằng tệp nhị phân `node` của máy.
+- **Chế độ Docker** cần [Docker](https://docs.docker.com/get-docker/) (Docker Desktop với backend WSL 2 trên Windows). Chế độ Compose cũng cần tiện ích mở rộng `docker compose`.
+
+## Ghi chú
+
+- Chạy lại lệnh là an toàn: tệp môi trường hiện có không bao giờ bị ghi đè, đóng vai trò là cách nâng cấp (trình cài đặt kéo các hình ảnh mới nhất và giữ nguyên khóa bí mật của bạn).
+- Trình cài đặt được tải xuống một thư mục tạm thời và bị xóa ngay sau khi thoát, bất kể kết quả thế nào.
+- Mã thoát của lệnh là mã thoát của trình cài đặt. Nếu quá trình tải xuống không thành công, CLI sẽ in lệnh tương đương `curl … | sh` (hoặc `irm … | iex`) để bạn có thể chạy trực tiếp trình cài đặt.
+- Các chế độ Docker vẫn cần một dịch vụ gửi email để gửi email đăng nhập. Sau khi trình cài đặt hoàn tất, hãy định cấu hình Resend hoặc SMTP trong tệp môi trường được tạo: xem [Trình gửi thư toàn cầu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md#global-mailer).
+
+## Liên quan
+
+- [Hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md) - Kiến trúc, các bước khởi chạy đầu tiên và giới hạn của từng chế độ
+- [Khởi tạo Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/init.md) - Lệnh `init` cha và danh sách kiểm tra tương tác của nó
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md) - Bảng điều khiển bạn vừa cài đặt làm được những gì

package/docs/vi/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Khởi tạo Intlayer
 description: Tìm hiểu cách khởi tạo Intlayer trong dự án của bạn.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Thêm lệnh con init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Thêm tùy chọn --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Thao tác này sẽ thiết lập tất cả các tệp cấu hình nhưng sẽ không sửa đổi tệp `.gitignore` của bạn.
 
+### Thiết lập cơ sở hạ tầng (ứng dụng máy tính để bàn hoặc tự lưu trữ):
+
+```bash
+npx intlayer init infra
+```
+
+Tải xuống và chạy trình cài đặt được lưu trữ (`https://intlayer.org/install.sh`, hoặc `install.ps1` trên Windows), hỏi bạn cách muốn chạy Intlayer:
+
+- **Ứng dụng máy tính để bàn** - cài đặt bảng điều khiển gốc trên máy của bạn, kết nối với Intlayer Cloud.
+- **Docker tất cả trong một (All-in-one)** - bảng điều khiển + API + MongoDB + Redis + MinIO trong một vùng chứa duy nhất.
+- **Docker Compose** - một vùng chứa cho mỗi dịch vụ, để tự lưu trữ có thể mở rộng.
+
+Bỏ qua menu với `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+Bước tương tự cũng được cung cấp bởi `npx intlayer init --interactive`. Xem [tài liệu tham khảo `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/infra.md) để biết cài đặt của trình cài đặt và [hướng dẫn tự lưu trữ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md) để biết những gì mỗi chế độ thiết lập.
+
 ## Ví dụ đầu ra:
 
 ```bash

package/docs/vi/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Nâng cấp các gói Intlayer
+description: Tìm hiểu cách sử dụng lệnh upgrade của Intlayer CLI để liệt kê từng gói Intlayer trong dự án hoặc monorepo của bạn và nâng cấp chúng lên phiên bản mới nhất.
+keywords:
+  - CLI
+  - Upgrade
+  - Nâng cấp
+  - Gói
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Thêm lệnh upgrade"
+author: aymericzip
+---
+
+# Nâng cấp các gói Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+Lệnh `upgrade` liệt kê các gói Intlayer được khai báo trong mỗi `package.json` của dự án, bao gồm cả các workspace monorepo, và nâng cấp chúng lên phiên bản mới nhất đã xuất bản. Lệnh này chạy bước nâng cấp gói tương tự như `intlayer init` một cách độc lập.
+
+## Đối số:
+
+- `--project-root [projectRoot]` - Tùy chọn. Thư mục gốc của dự án. Theo mặc định, lệnh bắt đầu từ `package.json` gần nhất phía trên thư mục làm việc hiện tại.
+- `--dry-run` - Tùy chọn. Liệt kê các gói và phiên bản mục tiêu của chúng mà không sửa đổi bất kỳ tệp nào.
+- `--tag <tag>` - Tùy chọn. npm dist-tag cần nâng cấp lên (ví dụ `canary`). Mặc định là `latest`.
+
+## Chức năng hoạt động:
+
+1. **Liệt kê các gói Intlayer** - Quét từng `package.json` của dự án (bỏ qua `node_modules` và kết quả bản dựng) để tìm các phụ thuộc và devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` và `intlayer-*`.
+2. **Lấy phiên bản mục tiêu** - Đọc phiên bản của dist-tag đã chọn (mặc định là `latest`) của từng gói từ npm registry.
+3. **Viết lại dải phiên bản** - Cập nhật trực tiếp từng dải phiên bản đã lỗi thời trong tệp, giữ nguyên toán tử (`^`, `~` hoặc không có) và thụt lề của tệp.
+4. **Cài đặt một lần** - Chạy một lượt cài đặt duy nhất từ thư mục gốc của workspace (thư mục gần nhất có tệp khóa), sử dụng trình quản lý gói sở hữu tệp khóa đó:
+
+| Tệp khóa (Lock file)           | Lệnh           |
+| ------------------------------ | -------------- |
+| `bun.lock` / `bun.lockb`       | `bun install`  |
+| `pnpm-lock.yaml`               | `pnpm install` |
+| `yarn.lock`                    | `yarn install` |
+| `package-lock.json` hoặc không | `npm install`  |
+
+Nếu không có tệp khóa, trường `packageManager` của `package.json` (ví dụ `"bun@1.2.0"`) sẽ được sử dụng trước khi chuyển sang npm.
+
+Các dải phiên bản không trỏ đến registry, chẳng hạn như `workspace:*`, `file:`, `link:`, `catalog:` hoặc URL git, sẽ không bao giờ bị sửa đổi.
+
+## Ví dụ:
+
+### Liệt kê các nâng cấp có sẵn mà không áp dụng chúng:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Nâng cấp lên bản phát hành canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Ví dụ đầu ra:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Ghi chú:
+
+- Chạy lệnh từ thư mục gốc của kho lưu trữ để nâng cấp mọi workspace. Chạy lệnh từ một workspace cụ thể để chỉ nâng cấp riêng workspace đó.
+- Các gói không thể lấy được phiên bản (ngoại tuyến, gói riêng tư hoặc chưa xuất bản) sẽ được liệt kê và giữ nguyên.
+- Nếu quá trình cài đặt thất bại, các dải phiên bản đã nâng cấp vẫn được giữ lại trong `package.json`. Hãy chạy lệnh cài đặt của trình quản lý gói theo cách thủ công.

package/docs/vi/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-01-22
+updatedAt: 2026-09-21
 title: Nội dung HTML
 description: Tìm hiểu cách khai báo và sử dụng nội dung HTML với các component tùy chỉnh trong Intlayer. Theo dõi tài liệu này để nhúng nội dung giống HTML phong phú với việc thay thế component động trong dự án quốc tế hóa của bạn.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
 slugs:
   - doc
   - concept
@@ -235,6 +237,83 @@ Khi bạn truy cập nội dung qua `useIntlayer`, các nút HTML đã được
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    Trong Remix 3, các nút HTML giải quyết thành một chuỗi HTML. Chèn chuỗi đó bằng prop `innerHTML` của Remix JSX hoặc với `html.raw` trong chế độ xem `html-template`.
+
+    ```tsx fileName="src/views/home.tsx"
+    import { useIntlayer } from "remix-intlayer";
+
+    export const HomePage = () => () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return <div innerHTML={myHtmlContent.value} />;
+    };
+    ```
+
+    ```ts fileName="src/views/home.ts"
+    import { html } from "remix/html-template";
+    import { useIntlayer } from "remix-intlayer";
+
+    export const renderHomePage = () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return html.raw`<div>${myHtmlContent.value}</div>`;
+    };
+    ```
+
+    > Remix mặc định thoát các giá trị được nội suy. `innerHTML` và `html.raw` là hai cách từ chối thoát, đây là điều mà một chuỗi HTML cần.
+
+    Sử dụng phương thức `.use()` để ghi đè các thẻ hoặc ánh xạ các thành phần tùy chỉnh. Các ghi đè là các hàm trả về một chuỗi HTML:
+
+    ```tsx
+    <div
+      innerHTML={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    Trong Astro, các nút HTML giải quyết thành một chuỗi HTML. Chèn chuỗi đó bằng chỉ thị `set:html` trong mẫu hoặc với `innerHTML` trong `<script>` phía client.
+
+    ```astro fileName="src/pages/index.astro"
+    ---
+    import { useIntlayer } from "astro-intlayer";
+
+    const { myHtmlContent } = useIntlayer("app");
+    ---
+
+    <div set:html={myHtmlContent.value} />
+    ```
+
+    ```astro fileName="src/components/Content.astro"
+    <div id="content"></div>
+
+    <script>
+      import { useIntlayer } from "astro-intlayer";
+
+      const { myHtmlContent } = useIntlayer("app");
+
+      document.querySelector("#content")!.innerHTML = myHtmlContent.value;
+    </script>
+    ```
+
+    > Astro mặc định thoát `{biểu thức}`. `set:html` là cách từ chối thoát, đây là điều mà một chuỗi HTML cần.
+
+    Sử dụng phương thức `.use()` để ghi đè các thẻ hoặc ánh xạ các thành phần tùy chỉnh. Các ghi đè là các hàm trả về một chuỗi HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Cấu hình toàn cục với `HTMLProvider`
@@ -470,6 +549,41 @@ Bạn có thể cấu hình cách render HTML ở mức toàn cục cho toàn b
     > Import trình render HTML của bạn theo cách động là một cách tốt để giảm kích thước bundle của ứng dụng.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    Remix không có cây thành phần để chứa provider, do đó cấu hình được cài đặt một lần, dưới dạng singleton, khi máy chủ khởi động. Nó cấu hình renderer được trả về bởi `useHTMLRenderer()`. Các nút `html` được trả về bởi `useIntlayer` được kết xuất nguyên trạng; ghi đè các thẻ của chúng trên mỗi nút bằng `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > Sử dụng `installIntlayerHTMLDynamic(async () => …)` để tải chậm chính renderer; trình tải chỉ chạy trong lần gọi đầu tiên.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    Astro không có cây thành phần để chứa provider, do đó cấu hình được cài đặt một lần, dưới dạng singleton, trong middleware (máy chủ) và trong `<script>` phía client (trình duyệt). Nó cấu hình renderer được trả về bởi `useHTMLRenderer()`. Các nút `html` được trả về bởi `useIntlayer` được kết xuất nguyên trạng; ghi đè các thẻ của chúng trên mỗi nút bằng `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // Chạy một lần khi máy chủ khởi động; bản thân middleware Intlayer
+    // được đăng ký bởi tích hợp, trước tệp này.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > Sử dụng `installIntlayerHTMLDynamic(async () => …)` để tải chậm chính renderer; trình tải chỉ chạy trong lần gọi đầu tiên.
+
+  </Tab>
 </Tabs>
 
 ### Kết xuất Thủ công & Công cụ Nâng cao
@@ -642,15 +756,69 @@ Nếu bạn cần kết xuất chuỗi HTML thô hoặc muốn kiểm soát nhi
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Hook `useHTMLRenderer()`
+
+    Lấy một hàm renderer được cấu hình sẵn bởi `installIntlayerHTML()`. Nó trả về một chuỗi HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### Tiện ích `renderHTML()`
+
+    Tiện ích độc lập bỏ qua cấu hình toàn cục.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Hook `useHTMLRenderer()`
+
+    Lấy một hàm renderer được cấu hình sẵn bởi `installIntlayerHTML()`. Nó trả về một chuỗi HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### Tiện ích `renderHTML()`
+
+    Tiện ích độc lập bỏ qua cấu hình toàn cục.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Tham chiếu Tùy chọn
 
 Các tùy chọn này có thể được truyền cho `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer`, và `renderHTML`.
 
-| Tùy chọn     | Kiểu                  | Mặc định | Mô tả                                                                                                                |
-| :----------- | :-------------------- | :------- | :------------------------------------------------------------------------------------------------------------------- |
-| `components` | `Record<string, any>` | `{}`     | Bản đồ các thẻ HTML hoặc tên component tùy chỉnh tới các component tương ứng.                                        |
-| `renderHTML` | `Function`            | `null`   | Một hàm render/kết xuất tùy chỉnh để thay thế hoàn toàn bộ parser HTML mặc định (Chỉ dành cho Vue/Svelte providers). |
+| Tùy chọn     | Kiểu                  | Mặc định | Mô tả                                                                                                                          |
+| :----------- | :-------------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`     | Bản đồ các thẻ HTML hoặc tên component tùy chỉnh tới các component tương ứng.                                                  |
+| `renderHTML` | `Function`            | `null`   | Hàm hiển thị tùy chỉnh để thay thế hoàn toàn trình phân tích cú pháp HTML mặc định (nhà cung cấp Vue, Svelte, Remix và Astro). |
 
 > Lưu ý: Đối với React và Preact, các thẻ HTML chuẩn được cung cấp tự động. Bạn chỉ cần truyền prop `components` nếu bạn muốn ghi đè chúng hoặc thêm các component tùy chỉnh.