์ด ํ์ด์ง์ ์ํ๋ AI ์ด์์คํดํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์์ฝํฉ๋๋ค
๋ฒ์ ๊ธฐ๋ก
- "useIntlayer, useDictionary, useLocale ํ
, ๋ฏธ๋ค์จ์ด ๋ฐ ํฌ๋งทํฐ ๋ฌธ์ ์ถ๊ฐ"v9.5.52026. 9. 19.
- "๋ชจ๋ ๋ด๋ณด๋ด๊ธฐ์ ๋ํ ํตํฉ ๋ฌธ์"v8.0.02026. 1. 21.
์ด ํ์ด์ง์ ์ฝํ ์ธ ๋ AI๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ์ญ๋์์ต๋๋ค.
์์ด ์๋ณธ ๋ด์ฉ์ ์ต์ ๋ฒ์ ์ ๋ณด๊ธฐ์ด ๋ฌธ์๋ฅผ ๊ฐ์ ํ ์์ด๋์ด๊ฐ ์์ผ์๋ฉด GitHub์ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ์ฌ ์์ ๋กญ๊ฒ ๊ธฐ์ฌํด ์ฃผ์ธ์.
๋ฌธ์์ ๋ํ GitHub ๋งํฌ๋ฌธ์์ Markdown์ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
astro-intlayer ํจํค์ง
astro-intlayer ํจํค์ง๋ Astro ์ ํ๋ฆฌ์ผ์ด์
์ Intlayer๋ฅผ ํตํฉํ๋ ๋ฐ ํ์ํ ๋๊ตฌ๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ก์ผ์ผ ๊ธฐ๋ฐ ๋ผ์ฐํ
, ์ฌ์ ๊ด๋ฆฌ, ๋น๋ ํ์ ํ์ด์ง ์ฌ์์ฑ, ์์ฒญ ๋ฏธ๋ค์จ์ด, ๊ทธ๋ฆฌ๊ณ ์๋ฒ ๋ ๋๋ง๋ .astro ์ปดํฌ๋ํธ์ ํด๋ผ์ด์ธํธ ์ฌ์ด๋ ์คํฌ๋ฆฝํธ ๋ชจ๋์์ ๋ค๊ตญ์ด ์ฝํ
์ธ ์ ์ ๊ทผํ๊ธฐ ์ํ ํ
์ ๊ตฌ์ฑํฉ๋๋ค.
์ค์น
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ด๋ณด๋ด๊ธฐ
ํตํฉ
astro-intlayer ํจํค์ง๋ ํ๋ก์ ํธ์ Intlayer๋ฅผ ์ค์ ํ๋ Astro ํตํฉ์ ์ ๊ณตํฉ๋๋ค.
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋๋ astro.config.mjs์์์ ๊ธฐ๋ณธ ๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
intlayer | ์ฌ์ ์ ์ค๋นํ๊ณ , Vite ํ๋ฌ๊ทธ์ธ(๋ณ์นญ, ๋ผ์ฐํ ํ๋ก์, ๊ฐ์ง์น๊ธฐ)์ ๊ตฌ์ฑํ๋ฉฐ, ์์ฒญ ๋ฏธ๋ค์จ์ด๋ฅผ ์๋ ๋ฑ๋กํ๊ณ ์ฌ์์ฑ๋ ๋ก์ผ์ผ URL๋ก ์ฌ์ ๋ ๋๋ง๋ ํ์ด์ง๋ฅผ ์ถ๋ ฅํ๋ Astro ํตํฉ์ ๋๋ค. | intlayer |
ํ (์๋ฒ ๋ฐ ํด๋ผ์ด์ธํธ)
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
useIntlayer | ํค๋ก ํ๋์ ์ฌ์ ์ ์ ํํ๊ณ ํ์งํ๋ ์ฝํ
์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. .astro ํ๋ก ํธ๋งคํฐ์์๋ Astro.locals์์ ์์ฒญ ๋ก์ผ์ผ์ ์ฝ๊ณ , <script>์์๋ ํด๋ผ์ด์ธํธ ์คํ ์ด์์ ์ฝ์ต๋๋ค. | useIntlayer |
useDictionary | ์ฌ์ ๊ฐ์ฒด๋ฅผ ๋ณํํ๊ณ ํด๊ฒฐ๋ ๋ก์ผ์ผ์ ๋ง๋ ์ฝํ ์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. ํ๋ก ํธ๋งคํฐ ๋ฐ ํด๋ผ์ด์ธํธ ์คํฌ๋ฆฝํธ์์ ์๋ํฉ๋๋ค. | useDictionary |
useLocale | ํ์ฌ ๋ก์ผ์ผ, ๊ธฐ๋ณธ ๋ก์ผ์ผ, ์ฌ์ฉ ๊ฐ๋ฅํ ๋ก์ผ์ผ ๋ชฉ๋ก ๋ฐ ๋ก์ผ์ผ ์ ๋ฐ์ดํธ ํจ์๋ฅผ ๋ฐํํฉ๋๋ค. | useLocale |
๋ฏธ๋ค์จ์ด (astro-intlayer/middleware)
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ๋ด๋ณด๋ด๊ธฐ | ํ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|---|
onRequest | MiddlewareHandler | ์์ฒญ ๋ก์ผ์ผ์ ๊ฐ์งํ๊ณ Astro.locals.intlayer๋ฅผ ์ฐ๊ฒฐํ๋ Astro ๋ฏธ๋ค์จ์ด์
๋๋ค. intlayer()์ ์ํด ์๋ ๋ฑ๋ก๋๊ฑฐ๋, ์๋์ผ๋ก ๊ตฌ์ฑํ๊ธฐ ์ํด ๊ฐ์ ธ์ต๋๋ค. | onRequest |
์ ํธ๋ฆฌํฐ
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
getIntlayerLocals | Astro.locals ์ธ๋ถ์ ์์ฒญ ์ ์ฅ์ ์ค์ฝํ์์ ํ์ฌ IntlayerLocals ๊ฐ์ฒด๋ฅผ ๊ฒ์ํ๋ ๋์ฐ๋ฏธ ํจ์์
๋๋ค. | - |
ํด๋ผ์ด์ธํธ ์ ํธ๋ฆฌํฐ (astro-intlayer/client)
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ธ๋ผ์ฐ์ ๋๋ ํด๋ผ์ด์ธํธ <script> ํ๊ทธ ๋ด์์ ๊ฐ์ ธ์ฌ ๋ astro-intlayer๋ ์๋์ผ๋ก astro-intlayer/client(vanilla-intlayer ๊ธฐ๋ฐ)๋ก ๋งคํ๋์ด ํด๋ผ์ด์ธํธ ์ธก ์ฌ์ ๊ฒํฐ, ์คํ ์ด ๊ตฌ๋
์ ๋ฐ ๋ก์ผ์ผ ์ง์์ฑ ๋๊ตฌ๋ฅผ ์ ๊ณตํฉ๋๋ค.
ํฌ๋งทํฐ (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)
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ๋ด๋ณด๋ด๊ธฐ | ํ์ | ์ค๋ช |
|---|---|---|
renderHTML | Function | HTML ๋ ธ๋๋ฅผ ๋ ๋๋งํ๊ธฐ ์ํ ๋ ๋ฆฝ ์คํํ ์ ํธ๋ฆฌํฐ ํจ์์ ๋๋ค. |
useHTML | Hook | HTML ํ๋ก๋ฐ์ด๋ ์ปจํ ์คํธ ๋ฐ ๊ตฌ์ฑ์ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. |
useHTMLRenderer | Hook | ์ฌ์ ๊ตฌ์ฑ๋ HTML ๋ ๋๋ฌ ํจ์๋ฅผ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. |
Markdown ์ ํธ๋ฆฌํฐ (astro-intlayer/markdown)
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ๋ด๋ณด๋ด๊ธฐ | ํ์ | ์ค๋ช |
|---|---|---|
compileMarkdown | Function | ๋งํฌ๋ค์ด ๋ฌธ์์ด์ ๊ตฌ์กฐํ๋ ํํ์ผ๋ก ์ปดํ์ผํฉ๋๋ค. |
renderMarkdown | Function | ๋งํฌ๋ค์ด ์ฝํ ์ธ ๋ฅผ ์ถ๋ ฅ ๋ ธ๋๋ก ๋ ๋๋งํฉ๋๋ค. |
parseMarkdown | Function | ์์ ๋งํฌ๋ค์ด ์ฝํ ์ธ ๋ฅผ AST๋ก ๊ตฌ๋ฌธ ๋ถ์ํฉ๋๋ค. |
useMarkdown | Hook | ๋งํฌ๋ค์ด ํ๋ก๋ฐ์ด๋ ์ปจํ ์คํธ๋ฅผ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. |
useMarkdownRenderer | Hook | ์ฌ์ ๊ตฌ์ฑ๋ Markdown ๋ ๋๋ฌ ํจ์๋ฅผ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. |
ํ์
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ์ | ์ค๋ช |
|---|---|
IntlayerLocals | locale, defaultLocale, availableLocales๋ฅผ ํฌํจํ์ฌ Astro.locals.intlayer์ ์ฐ๊ฒฐ๋ ๊ฐ์ฒด์
๋๋ค. |
UseLocaleProps | useLocale()์์ ํ์ฉํ๋ ์ ํ์ ๊ตฌ์ฑ ์์ฑ์
๋๋ค. |
UseLocaleResult | ๋ก์ผ์ผ ์์ฑ ๋ฐ ์
๋ฐ์ดํธ ๋ฉ์๋๋ฅผ ์ ๊ณตํ๋ useLocale()์ ๋ฐํ ํ์
์
๋๋ค. |
