@intlayer/docs 9.5.6 → 9.5.8

package/docs/ko/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Intlayer CLI init infra 명령어를 사용하여 데스크톱 앱을 설치하거나 Docker(올인원 컨테이너 또는 Docker Compose 스택)로 Intlayer CMS를 셀프 호스팅하는 방법을 알아봅니다.
+keywords:
+  - CLI
+  - 인프라
+  - 셀프 호스팅
+  - 데스크톱 앱
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "init infra 명령어 추가"
+author: aymericzip
+---
+
+# Intlayer CLI Init Infra 명령어
+
+## 설명
+
+`init infra` 명령어는 로컬 머신에 Intlayer 인프라를 설정합니다. 사용 중인 플랫폼용 호스팅 설치 프로그램(macOS / Linux는 `https://intlayer.org/install.sh`, Windows는 `https://intlayer.org/install.ps1`)을 다운로드하고 터미널에 연결하여 실행하므로 설치 프로그램 메뉴와 진행 상황이 그대로 표시됩니다.
+
+설치 프로그램은 Intlayer 실행 방법을 선택하도록 안내합니다:
+
+- **데스크톱 앱**: 운영체제 및 CPU에 맞는 네이티브 대시보드를 다운로드하여 열거나 설치합니다. 데스크톱 빌드는 Intlayer Cloud 백엔드와 통신합니다.
+- **올인원 Docker**: 단일 볼륨 기반의 단일 컨테이너에서 대시보드 + API + MongoDB + Redis + MinIO를 실행합니다. 시크릿이 생성된 `./intlayer.env`를 작성하고 `intlayer/cms-all` 이미지를 가져옵니다.
+- **Docker Compose**: 확장 가능한 셀프 호스팅을 위한 서비스당 하나의 컨테이너 구성입니다. `./intlayer/`에 `docker-compose.yml` 및 `.env`를 작성하고 이미지를 가져옵니다.
+
+호스팅된 설치 프로그램이 설정 흐름의 유일한 정보원입니다. CLI는 동일한 단계를 다시 구현하지 않고 설치 프로그램을 실행하므로 `npx intlayer init infra`와 `curl -fsSL https://intlayer.org/install.sh | sh`는 완전히 동일하게 작동합니다.
+
+## 사용법
+
+```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]
+```
+
+`npx intlayer init --interactive` 체크리스트의 **인프라 (데스크톱 앱 / 셀프 호스팅)** 항목에서도 동일한 단계가 제공됩니다.
+
+## 옵션
+
+- `-m, --mode <mode>` - 선택 사항. 설치 프로그램 메뉴를 건너뛰고 특정 모드를 직접 실행합니다. 허용되는 값: `desktop`, `docker`(올인원) 또는 `compose`. 다른 값을 입력하면 지원되는 모드 목록과 함께 오류가 발생합니다.
+
+## 예시
+
+### 대화형으로 모드 선택
+
+```bash
+npx intlayer init infra
+```
+
+### 데스크톱 앱 설치
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### 올인원 컨테이너로 셀프 호스팅
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Docker Compose로 셀프 호스팅
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## 출력 예시
+
+```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
+```
+
+## 설치 프로그램 설정
+
+설치 프로그램은 몇 가지 환경 변수를 읽으며, CLI는 이를 그대로 전달합니다. 명령을 실행하기 전에 셸에서 설정하세요:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| 변수                      | 기본값                    | 적용 대상 | 설명                                                |
+| ------------------------- | ------------------------- | --------- | --------------------------------------------------- |
+| `INTLAYER_MODE`           | _(질문됨)_                | 모두      | `desktop`, `docker` 또는 `compose`, `--mode`와 동일 |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop   | 앱 설치 프로그램이 저장되는 위치                    |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker    | 가져올 올인원 이미지                                |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker    | 환경 설정 파일을 작성할 위치                        |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker    | 컨테이너 이름                                       |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker    | `/data`에 마운트된 네임드 볼륨                      |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker    | 대시보드 호스트 포트                                |
+| `INTLAYER_API_PORT`       | `3100`                    | docker    | API 호스트 포트                                     |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker    | MinIO S3 API 호스트 포트                            |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker    | MinIO 콘솔 호스트 포트                              |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose   | `docker-compose.yml` 및 `.env`가 작성되는 위치      |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | 둘 다     | compose 파일 및 env 템플릿을 가져오는 Git ref       |
+
+> 포트 변수는 매핑의 **호스트** 측만 변경합니다. 게시된 이미지에는 `http://localhost:3000`, `http://localhost:3100`, `http://localhost:9000`이 대시보드 번들에 컴파일되어 있으므로 자체 이미지를 빌드하지 않는 한 기본값을 유지하세요: [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md#limitations)를 참조하세요.
+
+## 요구 사항
+
+- **데스크톱 앱**은 [Node.js](https://nodejs.org)가 필요합니다: 앱은 대시보드 서버를 내장하고 있으며 머신의 `node` 바이너리로 시작합니다.
+- **Docker 모드**는 [Docker](https://docs.docker.com/get-docker/)가 필요합니다(Windows에서는 WSL 2 백엔드의 Docker Desktop). Compose 모드에는 `docker compose` 플러그인도 필요합니다.
+
+## 참고 사항
+
+- 명령을 다시 실행해도 안전합니다: 기존 환경 파일은 절대 덮어쓰지 않으므로 업그레이드 경로로도 사용됩니다(최신 이미지를 가져오고 시크릿을 유지함).
+- 설치 프로그램은 임시 디렉터리에 다운로드되며 결과에 관계없이 종료 시 삭제됩니다.
+- 명령어의 종료 코드는 설치 프로그램의 종료 코드입니다. 다운로드 자체가 실패하면 CLI에서 직접 설치 프로그램을 실행할 수 있도록 해당하는 `curl … | sh`(또는 `irm … | iex`) 명령을 출력합니다.
+- Docker 모드에서는 로그인 이메일을 전송하기 위해 메일러가 필요합니다. 설치 프로그램이 완료된 후 생성된 환경 파일에서 Resend 또는 SMTP를 구성하세요: [글로벌 메일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md#global-mailer)를 참조하세요.
+
+## 관련 문서
+
+- [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md) - 각 모드의 아키텍처, 초기 실행 단계 및 제한 사항
+- [Intlayer 초기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/init.md) - 상위 `init` 명령어 및 대화형 체크리스트
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md) - 방금 설치한 대시보드의 기능

package/docs/ko/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Intlayer 초기화
 description: 프로젝트에서 Intlayer를 초기화하는 방법을 알아봅니다.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "init infra 하위 명령어 추가"
   - version: 8.6.4
     date: 2026-03-31
     changes: "--no-gitignore 옵션 추가"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 이 명령어는 모든 설정 파일을 구성하지만 `.gitignore`는 수정하지 않습니다.
 
+### 인프라 설정 (데스크톱 앱 또는 셀프 호스팅):
+
+```bash
+npx intlayer init infra
+```
+
+호스팅된 설치 프로그램(macOS / Linux의 `https://intlayer.org/install.sh`, Windows의 `install.ps1`)을 다운로드하고 실행하여 Intlayer 실행 방법을 선택하도록 안내합니다:
+
+- **데스크톱 앱** - Intlayer Cloud에 연결된 네이티브 대시보드를 로컬 머신에 설치합니다.
+- **올인원 Docker** - 단일 컨테이너 내에 대시보드 + API + MongoDB + Redis + MinIO가 모두 포함됩니다.
+- **Docker Compose** - 확장 가능한 셀프 호스팅을 위한 서비스당 하나의 컨테이너 구성입니다.
+
+`--mode` 옵션으로 메뉴를 건너뛸 수 있습니다:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+`npx intlayer init --interactive`에서도 동일한 단계가 제공됩니다. 설치 프로그램 설정은 [`init infra` 레퍼런스](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/infra.md)를, 각 모드가 설정하는 세부 내용은 [셀프 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md)를 참조하세요.
+
 ## 출력 예시:
 
 ```bash

package/docs/ko/cli/upgrade.md

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Intlayer 패키지 업그레이드
+description: Intlayer CLI upgrade 명령어를 사용하여 프로젝트 또는 모노레포의 모든 Intlayer 패키지를 나열하고 최신 버전으로 업그레이드하는 방법을 알아봅니다.
+keywords:
+  - CLI
+  - Upgrade
+  - 업그레이드
+  - Packages
+  - 패키지
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "upgrade 명령어 추가"
+author: aymericzip
+---
+
+# 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
+```
+
+`upgrade` 명령어는 모노레포 워크스페이스를 포함하여 프로젝트의 모든 `package.json`에 선언된 Intlayer 패키지를 나열하고 최신 배포 버전으로 업그레이드합니다. `intlayer init`과 동일한 패키지 업그레이드 단계를 독립적으로 실행합니다.
+
+## 인수:
+
+- `--project-root [projectRoot]` - 선택 사항. 프로젝트 루트 디렉터리입니다. 기본적으로 현재 작업 디렉터리 상위의 가장 가까운 `package.json`부터 시작합니다.
+- `--dry-run` - 선택 사항. 파일을 수정하지 않고 패키지와 대상 버전을 나열합니다.
+- `--tag <tag>` - 선택 사항. 업그레이드할 npm dist-tag입니다(예: `canary`). 기본값은 `latest`입니다.
+
+## 동작 방식:
+
+1. **Intlayer 패키지 나열** - 프로젝트의 각 `package.json`(`node_modules` 및 빌드 출력 제외)을 스캔하여 `intlayer`, `@intlayer/*`, `*-intlayer`, `intlayer-*` 종속성 및 devDependencies를 찾습니다.
+2. **대상 버전 가져오기** - npm 레지스트리에서 각 패키지의 선택된 dist-tag(기본값: `latest`) 버전을 읽어옵니다.
+3. **버전 범위 재작성** - 각 오래된 범위를 파일 내에서 직접 업데이트하며, 연산자(`^`, `~` 또는 없음) 및 파일 들여쓰기를 유지합니다.
+4. **한 번만 설치** - 잠금 파일(lock file)을 소유한 패키지 관리자를 사용하여 워크스페이스 루트(잠금 파일이 있는 가장 가까운 디렉터리)에서 단일 설치를 실행합니다:
+
+| 잠금 파일                     | 명령어         |
+| ----------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`      | `bun install`  |
+| `pnpm-lock.yaml`              | `pnpm install` |
+| `yarn.lock`                   | `yarn install` |
+| `package-lock.json` 또는 없음 | `npm install`  |
+
+잠금 파일이 없는 경우 npm으로 대체하기 전에 `package.json`의 `packageManager` 필드(예: `"bun@1.2.0"`)가 사용됩니다.
+
+`workspace:*`, `file:`, `link:`, `catalog:` 또는 git URL과 같이 레지스트리를 가리키지 않는 범위는 수정되지 않습니다.
+
+## 예제:
+
+### 변경 사항을 적용하지 않고 사용 가능한 업그레이드 나열:
+
+```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
+```
+
+### 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
+```
+
+## 출력 예시:
+
+```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
+```
+
+## 참고:
+
+- 리포지토리 루트에서 명령어를 실행하면 모든 워크스페이스가 업그레이드됩니다. 특정 워크스페이스에서 실행하면 해당 워크스페이스만 업그레이드됩니다.
+- 버전을 가져올 수 없는 패키지(오프라인, 비공개 또는 미게시 패키지)는 목록에 표시되지만 변경되지 않습니다.
+- 설치에 실패하더라도 업그레이드된 범위는 `package.json`에 유지됩니다. 패키지 관리자의 설치 명령어를 수동으로 실행하세요.

package/docs/ko/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-03-24
+updatedAt: 2026-09-21
 title: HTML 콘텐츠
 description: Intlayer에서 커스텀 컴포넌트를 사용하여 HTML 콘텐츠를 선언하고 사용하는 방법을 알아보세요. 이 문서를 따라 국제화된 프로젝트에서 동적인 컴포넌트 교체와 함께 풍부한 HTML 유사 콘텐츠를 임베드하세요.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
 slugs:
   - doc
   - concept
@@ -235,6 +237,83 @@ HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    Remix 3에서 HTML 노드는 HTML 문자열로 확인됩니다. Remix JSX의 `innerHTML` prop 또는 `html-template` 뷰의 `html.raw`를 사용하여 삽입하세요.
+
+    ```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는 기본적으로 보간된 값을 이스케이프합니다. `innerHTML`과 `html.raw`는 HTML 문자열에 필요한 두 가지 이스케이프 제외 방법입니다.
+
+    태그를 재정의하거나 커스텀 컴포넌트를 매핑하려면 `.use()` 메서드를 사용하세요. 재정의는 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">
+    Astro에서 HTML 노드는 HTML 문자열로 확인됩니다. 템플릿의 `set:html` 디렉티브 또는 클라이언트 `<script>`의 `innerHTML`을 사용하여 삽입하세요.
+
+    ```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는 기본적으로 `{표현식}`을 이스케이프합니다. `set:html`은 HTML 문자열에 필요한 이스케이프 제외 방법입니다.
+
+    태그를 재정의하거나 커스텀 컴포넌트를 매핑하려면 `.use()` 메서드를 사용하세요. 재정의는 HTML 문자열을 반환하는 함수입니다:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## `HTMLProvider`를 사용한 전역 구성
@@ -470,6 +549,41 @@ HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트
     > HTML 렌더러를 동적으로 가져오는 것은 애플리케이션의 번들 크기를 줄이는 좋은 방법입니다.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    Remix에는 프로바이더를 담을 컴포넌트 트리가 없으므로 설정은 서버 시작 시 싱글톤으로 한 번 설치됩니다. `useHTMLRenderer()`가 반환하는 렌더러를 구성합니다. `useIntlayer`가 반환하는 `html` 노드는 있는 그대로 렌더링되며, 노드별로 `.use()`를 사용하여 태그를 재정의하세요.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > 렌더러 자체를 지연 로드하려면 `installIntlayerHTMLDynamic(async () => …)`를 사용하세요. 로더는 첫 번째 호출 시에만 실행됩니다.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    Astro에는 프로바이더를 담을 컴포넌트 트리가 없으므로 설정은 미들웨어(서버) 및 클라이언트 `<script>`(브라우저)에서 싱글톤으로 한 번 설치됩니다. `useHTMLRenderer()`가 반환하는 렌더러를 구성합니다. `useIntlayer`가 반환하는 `html` 노드는 있는 그대로 렌더링되며, 노드별로 `.use()`를 사용하여 태그를 재정의하세요.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // 서버 시작 시 한 번 실행됩니다. Intlayer 미들웨어 자체는
+    // 이 파일보다 앞서 통합에 의해 등록됩니다.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > 렌더러 자체를 지연 로드하려면 `installIntlayerHTMLDynamic(async () => …)`를 사용하세요. 로더는 첫 번째 호출 시에만 실행됩니다.
+
+  </Tab>
 </Tabs>
 
 ### 수동 렌더링 및 고급 도구
@@ -643,15 +757,69 @@ HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### `useHTMLRenderer()` 훅
+
+    `installIntlayerHTML()`로 사전 구성된 렌더러 함수를 가져옵니다. HTML 문자열을 반환합니다.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### `renderHTML()` 유틸리티
+
+    전역 구성을 무시하는 독립형 유틸리티입니다.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### `useHTMLRenderer()` 훅
+
+    `installIntlayerHTML()`로 사전 구성된 렌더러 함수를 가져옵니다. HTML 문자열을 반환합니다.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### `renderHTML()` 유틸리티
+
+    전역 구성을 무시하는 독립형 유틸리티입니다.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## 옵션 참조
 
 이 옵션들은 `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer`, 및 `renderHTML`에 전달할 수 있습니다.
 
-| 옵션         | 타입                  | 기본값 | 설명                                                                                  |
-| :----------- | :-------------------- | :----- | :------------------------------------------------------------------------------------ |
-| `components` | `Record<string, any>` | `{}`   | HTML 태그 또는 커스텀 컴포넌트 이름을 컴포넌트에 매핑한 맵.                           |
-| `renderHTML` | `Function`            | `null` | 기본 HTML 파서를 완전히 대체하는 커스텀 렌더링 함수 (Vue/Svelte 프로바이더에만 해당). |
+| 옵션         | 타입                  | 기본값 | 설명                                                                                           |
+| :----------- | :-------------------- | :----- | :--------------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`   | HTML 태그 또는 커스텀 컴포넌트 이름을 컴포넌트에 매핑한 맵.                                    |
+| `renderHTML` | `Function`            | `null` | 기본 HTML 파서를 완전히 대체하기 위한 커스텀 렌더링 함수 (Vue, Svelte, Remix 및 Astro 제공자). |
 
 > 참고: React 및 Preact의 경우 표준 HTML 태그가 자동으로 제공됩니다. 태그를 재정의하거나 커스텀 컴포넌트를 추가하려는 경우에만 `components` prop을 전달하면 됩니다.