์ž‘๊ฐ€:
    ์ƒ์„ฑ: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()์˜ ๋ฐ˜ํ™˜ ํƒ€์ž…์ž…๋‹ˆ๋‹ค.