작가:
    생성:2026-01-21마지막 업데이트:2026-09-19

    astro-intlayer 패키지

    astro-intlayer 패키지는 Astro 애플리케이션에 Intlayer를 통합하는 데 필요한 도구를 제공합니다. 로케일 기반 라우팅, 사전 관리, 빌드 타임 페이지 재작성, 요청 미들웨어, 그리고 서버 렌더링된 .astro 컴포넌트와 클라이언트 사이드 스크립트 모두에서 다국어 콘텐츠에 접근하기 위한 훅을 구성합니다.

    설치

    bash
    npm install astro-intlayer
    

    내보내기

    통합

    astro-intlayer 패키지는 프로젝트에 Intlayer를 설정하는 Astro 통합을 제공합니다.

    가져오기:

    tsx
    import { intlayer } from "astro-intlayer";
    

    또는 astro.config.mjs에서의 기본 가져오기:

    ts
    import { defineConfig } from "astro/config";
    import intlayer from "astro-intlayer";
    
    export default defineConfig({
      integrations: [intlayer()],
    });
    
    함수설명관련 문서
    intlayer사전을 준비하고, Vite 플러그인(별칭, 라우팅 프록시, 가지치기)을 구성하며, 요청 미들웨어를 자동 등록하고 재작성된 로케일 URL로 사전 렌더링된 페이지를 출력하는 Astro 통합입니다.intlayer

    훅 (서버 및 클라이언트)

    가져오기:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    
    설명관련 문서
    useIntlayer키로 하나의 사전을 선택하고 현지화된 콘텐츠를 반환합니다. .astro 프론트매터에서는 Astro.locals에서 요청 로케일을 읽고, <script>에서는 클라이언트 스토어에서 읽습니다.useIntlayer
    useDictionary사전 객체를 변환하고 해결된 로케일에 맞는 콘텐츠를 반환합니다. 프론트매터 및 클라이언트 스크립트에서 작동합니다.useDictionary
    useLocale현재 로케일, 기본 로케일, 사용 가능한 로케일 목록 및 로케일 업데이트 함수를 반환합니다.useLocale

    미들웨어 (astro-intlayer/middleware)

    가져오기:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    
    내보내기타입설명관련 문서
    onRequestMiddlewareHandler요청 로케일을 감지하고 Astro.locals.intlayer를 연결하는 Astro 미들웨어입니다. intlayer()에 의해 자동 등록되거나, 수동으로 구성하기 위해 가져옵니다.onRequest

    유틸리티

    가져오기:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    
    함수설명관련 문서
    getIntlayerLocalsAstro.locals 외부의 요청 저장소 스코프에서 현재 IntlayerLocals 객체를 검색하는 도우미 함수입니다.-

    클라이언트 유틸리티 (astro-intlayer/client)

    가져오기:

    tsx
    import {
      useIntlayer,
      useDictionary,
      useDictionaryDynamic,
      useLocale,
      useLocaleStorage,
      useLocaleCookie,
      getIntlayer,
      getDictionary,
      installIntlayer,
      setLocaleInStorage,
      setLocaleCookie,
      localeInStorage,
      localeCookie,
    } from "astro-intlayer/client";
    

    브라우저 또는 클라이언트 <script> 태그 내에서 가져올 때 astro-intlayer는 자동으로 astro-intlayer/client(vanilla-intlayer 기반)로 매핑되어 클라이언트 측 사전 게터, 스토어 구독자 및 로케일 지속성 도구를 제공합니다.

    포맷터 (astro-intlayer/format)

    가져오기:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "astro-intlayer/format";
    
    설명
    useIntl캐싱 및 구독 기능과 함께 요청 또는 클라이언트 로케일에 바인딩된 Intl 인스턴스를 반환합니다.
    useDate현재 로케일에 미리 바인딩된 날짜 형식화 함수를 반환합니다 (Intl.DateTimeFormat).
    useNumber현재 로케일에 미리 바인딩된 숫자 형식화 함수를 반환합니다 (Intl.NumberFormat).
    useCurrency현재 로케일에 미리 바인딩된 통화 형식화 함수를 반환합니다.
    usePercentage현재 로케일에 미리 바인딩된 백분율 형식화 함수를 반환합니다.
    useRelativeTime현재 로케일에 미리 바인딩된 상대 시간 형식화 함수를 반환합니다 (Intl.RelativeTimeFormat).
    useList현재 로케일에 미리 바인딩된 목록 형식화 함수를 반환합니다 (Intl.ListFormat).
    useUnit현재 로케일에 미리 바인딩된 단위 형식화 함수를 반환합니다.
    useCompact현재 로케일에 미리 바인딩된 컴팩트 숫자 형식화 함수를 반환합니다 (예: 1.5K).

    HTML 유틸리티 (astro-intlayer/html)

    가져오기:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    
    내보내기타입설명
    renderHTMLFunctionHTML 노드를 렌더링하기 위한 독립 실행형 유틸리티 함수입니다.
    useHTMLHookHTML 프로바이더 컨텍스트 및 구성을 가져오는 훅입니다.
    useHTMLRendererHook사전 구성된 HTML 렌더러 함수를 가져오는 훅입니다.

    Markdown 유틸리티 (astro-intlayer/markdown)

    가져오기:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "astro-intlayer/markdown";
    
    내보내기타입설명
    compileMarkdownFunction마크다운 문자열을 구조화된 표현으로 컴파일합니다.
    renderMarkdownFunction마크다운 콘텐츠를 출력 노드로 렌더링합니다.
    parseMarkdownFunction원시 마크다운 콘텐츠를 AST로 구문 분석합니다.
    useMarkdownHook마크다운 프로바이더 컨텍스트를 가져오는 훅입니다.
    useMarkdownRendererHook사전 구성된 Markdown 렌더러 함수를 가져오는 훅입니다.

    타입

    가져오기:

    tsx
    import type {
      IntlayerLocals,
      UseLocaleProps,
      UseLocaleResult,
    } from "astro-intlayer";
    
    타입설명
    IntlayerLocalslocale, defaultLocale, availableLocales를 포함하여 Astro.locals.intlayer에 연결된 객체입니다.
    UseLocalePropsuseLocale()에서 허용하는 선택적 구성 속성입니다.
    UseLocaleResult로케일 속성 및 업데이트 메서드를 제공하는 useLocale()의 반환 타입입니다.