์ด ํ์ด์ง์ ์ํ๋ AI ์ด์์คํดํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์์ฝํฉ๋๋ค
์ด ํ์ด์ง์ ์ฝํ ์ธ ๋ AI๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ์ญ๋์์ต๋๋ค.
์์ด ์๋ณธ ๋ด์ฉ์ ์ต์ ๋ฒ์ ์ ๋ณด๊ธฐ์ด ๋ฌธ์๋ฅผ ๊ฐ์ ํ ์์ด๋์ด๊ฐ ์์ผ์๋ฉด GitHub์ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ์ฌ ์์ ๋กญ๊ฒ ๊ธฐ์ฌํด ์ฃผ์ธ์.
๋ฌธ์์ ๋ํ GitHub ๋งํฌ๋ฌธ์์ Markdown์ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฌ๋ฐ๋ฅธ React i18n ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ ํํ๋ ๋ฐฉ๋ฒ
React๋ ๊ธฐ๋ณธ i18n ํ๋ฆฌ๋ฏธํฐ๋ธ๋ฅผ ์ ๊ณตํ์ง ์์ต๋๋ค. ์ฒซ๋ ์ ํํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋ฒ์ญ ์ ์ฅ ๋ฐฉ์, ๋ฒ๋ค ํฌํจ ๋ฐฉ์, ํฅํ ์๋ ๊ฐ ๊ฐ๋ฐ์๊ฐ ์ง์ ๊ฐ๋นํด์ผ ํ ์์ ์ ์์ ๊ฒฐ์ ํฉ๋๋ค. ๋๋ถ๋ถ์ ํ์ ์ธ๊ธฐ๋๋ฅผ ๊ธฐ์ค์ผ๋ก ์ ํํ๋ค๊ฐ, ํค๊ฐ 2,000๊ฐ์ ๋๋ฌํ์ ๋ ๋น๋ก์ ํธ๋ ์ด๋์คํ๋ฅผ ๊นจ๋ซ๊ฒ ๋ฉ๋๋ค.
์ด ๊ฐ์ด๋๋ ๋ฐ๋๋ก ์ ๊ทผํฉ๋๋ค. ๋จผ์ ํ๋ก์ ํธ์ ๋ํ ๋ช ๊ฐ์ง ์ง๋ฌธ์ ๋ตํ ๋ค์, ํด๋น ๋ต๋ณ์ ๋ง๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋งคํํฉ๋๋ค. ์ด ๊ธ์ ์์ React(Vite, React Router, TanStack Start)์ ์ด์ ์ ๋ง์ถฅ๋๋ค. Next.js๋ ๊ณ ์ ํ ์ ์ฝ ์ฌํญ์ด ์์ผ๋ฉฐ, ์ด๋ Next.js ๋น๊ต์์ ๋ค๋ฃน๋๋ค.
๋ชฉ์ฐจ
๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋น๊ตํ๊ธฐ ์ ์ ๋ตํด์ผ ํ 6๊ฐ์ง ์ง๋ฌธ
์์ ์๊ฒ ์ด๋ค ๊ธฐ์ค์ด ์ค์ํ์ง ๋ชจ๋ฅธ๋ค๋ฉด ๊ธฐ๋ฅ ๋น๊ตํ๋ ๋ฌด์ฉ์ง๋ฌผ์ ๋๋ค. ๋ค์ ํญ๋ชฉ์ ๋จผ์ ๊ฒํ ํ์ธ์.
- ์ฑ์ด ์ด๋ป๊ฒ ๋ ๋๋ง๋๋์? SPA ์ ์ฉ, hydration์ ํฌํจํ SSR, ๋๋ React Server Components(RSC). Context ๊ธฐ๋ฐ hook์ SPA ์ด๋์๋ ์๋ํฉ๋๋ค. RSC์์๋ hook์ ์ฌ์ฉํ๋ฉด ํ
์คํธ๋ฅผ ๋ ๋๋งํ๋ ๋ชจ๋ ์ปดํฌ๋ํธ์
"use client"๊ฐ ๊ฐ์ ๋๋ฏ๋ก ์๋ฒ ์ฌ์ด๋ API๋ ํ์ํฉ๋๋ค. - ๋๊ฐ ๋ฒ์ญ์ ์์ฑํ๋์? ๊ฐ๋ฐ์, TMS๋ฅผ ์ฌ์ฉํ๋ ์ฌ๋ด ํ, ICU ํ์ผ์ ์ ๋ฌํ๋ ์์ด์ ์, ๋๋ AI ํ์ดํ๋ผ์ธ. ์ด๋ ์ด๋ค API ์ธ๋ถ์ฌํญ๋ณด๋ค ์นดํ๋ก๊ทธ ํ์์ ์ง์ ์ ์ผ๋ก ๊ฒฐ์ ํฉ๋๋ค.
- ๋ก์ผ์ผ๊ณผ ํ์ด์ง ์๋ ์ผ๋ง๋ ๋๋์? 2๊ฐ ๋ก์ผ์ผ๊ณผ 5๊ฐ ํ์ด์ง๋ผ๋ฉด ๋ชจ๋ ๋ฒ์ญ์ ํ ๋ฒ์ ์ ์กํด๋ ๊ด์ฐฎ์ต๋๋ค. ํ์ง๋ง 10๊ฐ ๋ก์ผ์ผ๊ณผ 50๊ฐ ๋ผ์ฐํธ๋ผ๋ฉด ๋ถ๊ฐ๋ฅํ๋ฉฐ, ๋ก๋ฉ ์ ๋ต์ด ์ฃผ์ ๋น์ฉ ์์ธ์ด ๋ฉ๋๋ค.
- ํค์ ๋ํ ํ์
์ด ํ์ํ๊ฐ์?
t("checkout.totl")๊ณผ ๊ฐ์ ์คํ๋ ํ์ ์ ์ง์ ์ฐ๊ฒฐํ์ง ์๋ ํ ๋ชจ๋ ํค ๊ธฐ๋ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ๊ทธ๋๋ก ์ปดํ์ผ๋ฉ๋๋ค. ์ด๋ฅผ ๊ฐ์ํ ์ ์๋์ง ๊ฒฐ์ ํ์ธ์. - ๋ฌธ์์ด์ ๋ฌด์์ด ํฌํจ๋๋์? ์ผ๋ฐ ํ
์คํธ, ๋ณต์ํ(plurals), ๋๋ ์ค๊ฐ์
<Link>๊ฐ ํฌํจ๋ ๋ฌธ์ฅ. ๋ฆฌ์น ์ฝํ ์ธ (rich content)๋ ๋๋ถ๋ถ์ API๊ฐ ๋ค๋ฃจ๊ธฐ ๊น๋ค๋ก์์ง๋ ์์ญ์ ๋๋ค. - ํ๋ก์ ํธ ์๋ช ์ด ์ผ๋ง๋ ๋๋์? 3๊ฐ์์ง๋ฆฌ ํ๋กํ ํ์ ๊ณผ 5๋ ๋์ ์ ์ง๋ ํ๋ก๋์ ์ ํ์ ํ์ํ ๋น๋ ๋๊ตฌ์ ๊ท๋ชจ๊ฐ ๋ค๋ฆ ๋๋ค.
๋ต๋ณ์ ์ ์ด๋์ธ์. ์๋์ ๋ชจ๋ ๋ด์ฉ์ ์ด ๋ต๋ณ๋ค์ ๊ธฐ์ค์ผ๋ก ์ค๋ช ํฉ๋๋ค.
ํ๋์ ๋ณด๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ํ๊ฒฝ
์ง๋ 15๋ ๊ฐ์ JavaScript i18n ์ญ์ฌ๋ 4๊ฐ์ ์ํคํ ์ฒ ํ๋ฆ์ผ๋ก ๋๋๋ฉฐ, ๋น๊ต ๋์ React ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ค๋ ์๋ก ๋ค๋ฅธ ์ธ๋์ ์ํด ์์ต๋๋ค.

๋ฉ๋ชจ๋ฆฌ์ ๋ก๋๋๋ JSON ์นดํ๋ก๊ทธ, ๋ฐํ์์ ์กฐํ๋๋ t("a.b"), ๋ธ๋ผ์ฐ์ ์์ ํ์ฑ๋๋ ICU ๋๋ ์ปค์คํ
๋ฌธ๋ฒ. ๊ฐ์ฅ ํฐ ์ํ๊ณ๋ฅผ ๊ฐ์ถ๊ณ ์์ง๋ง ๋ฐํ์์ด ๊ฐ์ฅ ๋ฌด๊ฒ๊ณ , ํ์
์ง์์ ์ ํ ์ฌํญ์
๋๋ค.
๋น๋ ์ ๋ฉ์์ง๋ฅผ ์ถ์ถํ์ฌ ์ปดํฉํธํ ์นดํ๋ก๊ทธ๋ก ์ปดํ์ผํ๊ณ ์ธ์๋ฅผ ํ์
ํํฉ๋๋ค. ๋ ์์ ๋ฒ๋ค์ ์ป๋ ๋์ ์ถ๊ฐ ๋น๋ ๋จ๊ณ(extract, compile)๊ฐ ํ์ํฉ๋๋ค.
SSR ๋ฐ Server Components๋ฅผ ์ค์ฌ์ผ๋ก ์ค๊ณ๋์์ต๋๋ค. ์๋ฒ์์ ๋ ๋๋งํ๊ณ ํด๋ผ์ด์ธํธ๊ฐ ํ์ํ ๋ถ๋ถ๋ง hydrateํฉ๋๋ค. ์ฌ์ ํ ํค ๊ธฐ๋ฐ ๋ฐ ์ค์์ง์ค์ ๋ฐฉ์์ ๋ฐ๋ฆ ๋๋ค.
์ฝํ ์ธ ๊ฐ ํธ๋ฆฌ ์์ดํน ๊ฐ๋ฅํ ํจ์๋ ์ปดํฌ๋ํธ๋ณ ๋์ ๋๋ฆฌ๋ก ์ปดํ์ผ๋ฉ๋๋ค. ํ์ ์ด ์๋ ์์ฑ๋๊ณ , ๋๋ฝ๋ ๋ฒ์ญ์ด ์์ผ๋ฉด ๋น๋๊ฐ ์คํจํ๋ฉฐ, CLI์์ AI ๋ฒ์ญ์ ์คํํ ์ ์์ต๋๋ค.
JavaScript i18n์ ์ญ์ฌ์์ ๊ฐ ํ๋ฆ์ด ์ด์ ์ธ๋์ ๋ฌธ์ ๋ฅผ ์ด๋ป๊ฒ ํด๊ฒฐํ๋์ง ์์ธํ ํ์ธํ ์ ์์ต๋๋ค.
๊ฐ์ฅ ์ค์ํ ๊ฒฐ์ : ์ฝํ ์ธ ์ ์์น์ ๋ก๋ฉ ์์
๋ชจ๋ React i18n ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ store, provider, hook์ด๋ผ๋ ๋์ผํ ๊ตฌ์กฐ๋ฅผ ๊ฐ์ง๋๋ค. provider๊ฐ ๋ฐ๋ ๋ฐ์ดํฐ๋ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ฒ๋ค์ด๋ hydration ํ์ด๋ก๋์ ํฌํจ๋ฉ๋๋ค. ๋ฐ๋ผ์ ๋ ๊ฐ์ง ๊ตฌ์กฐ์ ์ ํ์ด ํต์ฌ์ ๋๋ค:
- ์ค์์ง์ค์ vs ๋ฒ์ ์ ํ(scoped) ์ฝํ
์ธ . ์ฑ ์ ์ฒด๋ฅผ ์ํ ํ๋์
en.json์ ๋ ๊ฒ์ธ์ง, ์ปดํฌ๋ํธ๋ณ(๋๋ ๋ค์์คํ์ด์ค๋ณ) ์ ์ธ์ ๋ ๊ฒ์ธ์ง. - ์ ์ import vs ๋์ import. ์์ ์ ๋ชจ๋ ๊ฒ์ ๋ฒ๋ค๋งํ ๊ฒ์ธ์ง, ํ์ฑ ๋ก์ผ์ผ๊ณผ ๋ผ์ฐํธ๋ฅผ ํ์์ ๋ฐ๋ผ ์จ๋๋งจ๋๋ก ๊ฐ์ ธ์ฌ ๊ฒ์ธ์ง.
์๋ ๊ทธ๋ํ๋ ํ์ด์ง๋น ์ฝ 30KB์ ํ ์คํธ๊ฐ ํฌํจ๋ 1~10๊ฐ ํ์ด์ง์ 1~10๊ฐ ๋ก์ผ์ผ๋ก ๋ฒ์ญ๋ ๊ฐ์ ์ฑ์ ํ์ด๋ก๋๋ฅผ ์ถ์ ํ ๊ฒ์ ๋๋ค.

์ ์ import๋ฅผ ์ฌ์ฉํ๋ ์ค์์ง์ค์ ์ฝํ ์ธ ๋ ๋ ์ถ ๋ชจ๋์์ ์ฆ๊ฐํฉ๋๋ค. 10๊ฐ ํ์ด์ง x 10๊ฐ ๋ก์ผ์ผ์ ๋ชจ๋ ํ์ด์ง์์ 300KB์ ํ ์คํธ๋ฅผ ์๋ฏธํฉ๋๋ค. ๋์ import๋ ๋ก์ผ์ผ ์ถ์ ๋ถ๋ด์ ์์ฑ๋๋ค. ๋ฒ์ ์ ํ(scoping)์ ํ์ด์ง ์ถ์ ๋ถ๋ด์ ์์ฑ๋๋ค. ์ค์ง ๋ ๊ฐ์ง๋ฅผ ์กฐํฉํด์ผ๋ง ์ผ์ ํ ํฌ๊ธฐ๋ฅผ ์ ์งํ ์ ์์ต๋๋ค.
์ด๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์์ฒด์ ํน์ฑ์ด ์๋๋ผ ๊ด๋ฆฌ ๊ท์จ์ ๋ฌธ์ ์
๋๋ค. react-i18next๋ ๋ค์์คํ์ด์ค์ lazy ๋ฐฑ์๋๋ก ๋ฒ์๋ฅผ ๋๋ ์ ์๊ณ , use-intl์ ๋ผ์ฐํธ๋ณ๋ก ๋ถํ ํ ์ ์์ต๋๋ค. ํ์ง๋ง ์ด๋ฅผ ๊ฐ์ ํ๋ ์ฅ์น๊ฐ ์๊ธฐ ๋๋ฌธ์, ๊ณต์ ์ปดํฌ๋ํธ์ธ <Button>์ด t("common:cta")๋ฅผ ์ฐธ์กฐํ๋ ์๊ฐ common ๋ค์์คํ์ด์ค๊ฐ ๋ชจ๋ ๋ผ์ฐํธ์ ์์กด์ฑ์ด ๋์ด ๋ฒ๋ฆฝ๋๋ค. ๋ฒค์น๋งํฌ์์๋ ์ด๋ฅผ "๋ค๋ฅธ ๋ผ์ฐํธ๋ก๋ถํฐ์ ๋์" ๋ฐ "๋ค๋ฅธ ๋ก์ผ์ผ๋ก๋ถํฐ์ ๋์"๋ก ์ธก์ ํ๋ฉฐ, ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฐ์ ๊ฒฉ์ฐจ ๋๋ถ๋ถ์ด ์ฌ๊ธฐ์ ๋ฐ์ํฉ๋๋ค.
3๋ฒ ์ง๋ฌธ์ "๋ง์ ๋ก์ผ์ผ, ๋ง์ ํ์ด์ง"๋ผ๊ณ ๋ตํ๋ค๋ฉด ์ด๋ค API ์ ํธ๋๋ณด๋ค ์ด ์น์ ์ ์ค์ํ๊ฒ ๊ณ ๋ คํ์ธ์. ์ปดํฌ๋ํธ๋ณ vs ์ค์์ง์ค์ i18n ํฌ์คํธ์์ ๋์ผํ ์ ํ์ ์ ์ง๋ณด์ ์ธก๋ฉด์ ๋ ๊น์ด ๋ค๋ฃน๋๋ค.
ํ๋ณด ๋ผ์ด๋ธ๋ฌ๋ฆฌ
๋ผ์ด๋ธ๋ฌ๋ฆฌ ํฌ๊ธฐ๋ TanStack Start ๋ฒค์น๋งํฌ๋ฅผ ๊ธฐ์ค์ผ๋ก ํฉ๋๋ค. ๋น ์ปดํฌ๋ํธ์์ provider์ hook์ ๋ฒ๋ค๋ง, ํธ๋ฆฌ ์์ดํน, minification์ ๊ฑฐ์น ํ ์ธก์ ํ ์์น์ด๋ฉฐ(10๊ฐ ํ์ด์ง, 10๊ฐ ๋ก์ผ์ผ), ์ฝํ ์ธ ํฌ๊ธฐ๋ ๋ณ๋๋ก ์ธก์ ๋์์ต๋๋ค.

ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ๋ผ์ด๋ธ๋ฌ๋ฆฌ | ์ธ๋ | ์ฝํ ์ธ ๋ชจ๋ธ | ํ์ ์์ ์ฑ | ๋ฉ์์ง ํฌ๋งท | ๋ผ์ด๋ธ๋ฌ๋ฆฌ ํฌ๊ธฐ |
|---|---|---|---|---|---|
react-i18next | Runtime | ์ค์ JSON, ๋ค์์คํ์ด์ค | 2/5 - ์ตํธ์ธ (CustomTypeOptions) | i18next (์ ๋ฏธ์ฌ ๋ณต์ํ) | ~18.4 kB |
react-intl (FormatJS) | Runtime | ์ค์ JSON, ICU | 2/5 - ์ตํธ์ธ (์ถ์ถ + ์ ๋์จ) | ICU | ~15.3 kB |
use-intl | Server-first | ์ค์ JSON, ICU | 2/5 - ์ตํธ์ธ (declaration merging) | ICU | ~14.1 kB |
@tolgee/react | Runtime | ์ค์ ์ง์ค, ์ธ์ปจํ ์คํธ ํธ์ง | 1/5 - ๋ฏธ์ง์ | ICU | ~11.1 kB |
| Lingui | Macro | ์ฝ๋ ๋ด ์์ค ํ ์คํธ, ์ปดํ์ผ๋ ์นดํ๋ก๊ทธ | 2/5 - ์ฐ์ (์ปดํ์ผ๋ฌ ์ง์) | ๋งคํฌ๋ก๋ฅผ ํตํ ICU | ~11.8 kB |
| Paraglide | Compiler | inlang ํ๋ก์ ํธ, ์์ฑ๋ ํจ์ | 3.5/5 - ์๋ ์์ฑ | ์์ฒด ํฌ๋งท | ๊ฑฐ์ 0์ ๊ฐ๊น์ (์ฝ๋๋ฒ ์ด์ค์ ์์ฑ๋๋ ์ฝ๋ ๋๋ฌธ) |
| Intlayer | Compiler | ์ปดํฌ๋ํธ๋ณ .content.ts | 5/5 - ์๋ ์์ฑ, ๊ธฐ๋ณธ ํ์ฑํ | Intlayer (+ ICU, i18next, PO) | ~5.0 kB |
์์น๋ ๋ฒค์น๋งํฌ ํ ์คํธ ๋น์ ๋ฒ์ ๊ธฐ์ค์ด๋ฉฐ ๋ฆด๋ฆฌ์ค์ ๋ฐ๋ผ ๋ฌ๋ผ์ง๋๋ค. ํฌ๊ธฐ๋ง์ผ๋ก ๊ฒฐ์ ํ๊ธฐ ์ ์ ์์ฒด ์ฑ์์ ์ง์ ๋ฒค์น๋งํฌ๋ฅผ ์คํํด ๋ณด์ธ์. ํ์ ์์ ์ฑ: 5/5๋ URL ํฌ๋งทํฐ์ ํฌํผ๋ฅผ ํฌํจํ์ฌ ํค, ๋งค๊ฐ๋ณ์, ๋ชจ๋ ๋ก์ผ์ผ์ด ์๋ ์ค์ ์์ด ๊ฒ์ฌ๋จ์ ์๋ฏธํฉ๋๋ค.
์ ํ์ ๋ํ๋์ง ์๋ ๋ ๊ฐ์ง ์ฌํญ์ด ์์ต๋๋ค. Paraglide๋ ์ฝ๋๋ฒ ์ด์ค์ ์ฝ๋๋ฅผ ์ง์ ์์ฑํ๋ฏ๋ก ๋ผ์ด๋ธ๋ฌ๋ฆฌ ํฌ๊ธฐ๊ฐ ๊ฑฐ์ ์์ง๋ง, ๋งค ์ปค๋ฐ ์ ์ฌ์์ฑ ๋จ๊ณ๊ฐ ํ์ํ๊ณ ์์ฑ๋ ํ์ผ์์ ๋จธ์ง ์ถฉ๋์ด ๋ฐ์ํ ์ ์์ต๋๋ค. ๊ทธ๋ฆฌ๊ณ Intlayer๋ ๋ฒ๋ค๋ฌ ํ๋ฌ๊ทธ์ธ(vite-intlayer ๋ฑ)์ด ํ์์ ์ด๋ฏ๋ก ๋น๋ ๊ณผ์ ์ด ์๋ ํ๊ฒฝ์์๋ ์ฌ์ฉํ ์ ์์ต๋๋ค.
์ปค๋ฐ ํ๋
์ปค๋ฐ ์๋ ๊ฐ ํ๋ก์ ํธ์ ์ผ๋ง๋ ๋ง์ ์์ ์ด ํฌ์ ๋๋์ง๋ฅผ ๋ณด์ฌ์ค๋๋ค. ๋ชจ๋ ธ๋ ํฌ๋ ๋ฐฐํฌํ๋ ๋ชจ๋ ํจํค์ง๋ฅผ ํฌํจํ๋ฏ๋ก, ์ด ์์น๋ ํ์ง์ด ์๋ ํ๋๋์ ์ ํธ๋ก ์ฝ์ด์ผ ํฉ๋๋ค.
- i18next/react-i18next
- formatjs/formatjs
- amannn/next-intl
- tolgee/tolgee-js
- lingui/js-lingui
- opral/paraglide-js
- aymericzip/intlayer
๊ธฐ๋ณธ ๋ธ๋์น์ ์ปค๋ฐ ์, ์ถ์ฒ: GitHub API.
npm ๋ค์ด๋ก๋
- react-i18next
- react-intl
- use-intl
- @tolgee/react
- @lingui/react
- @inlang/paraglide-js
- react-intlayer
์ถ์ฒ: npm ๋ ์ง์คํธ๋ฆฌ ๋ค์ด๋ก๋ API.
๋ค์ด๋ก๋ ์๋ ๊ฐ์ฅ ์ข์ ์๋ฃจ์ ์ด ์๋๋ผ ๊ฐ์ฅ ์ค๋๋ ์๋ฃจ์ ์ ๋ณด์์ ์ค๋๋ค. ์๋ ์ ์ ์ถ์๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋น์ ์ด๋ฅผ ์ ํํ ๋ชจ๋ ํ๋ก์ ํธ, ๋ชจ๋ CI ์คํ, ์ด์ ์์กดํ๋ ๋ชจ๋ ํจํค์ง์ ์ํด ์ฌ์ ํ ์ค์น๋ฉ๋๋ค. ์ด ์์น๋ ์๋ก์ด ์ ํ๋ณด๋ค ๊ด์ฑ์ ์ธก์ ํฉ๋๋ค.
AI ์ด์์คํดํธ๋ ์ด ํจ๊ณผ๋ฅผ ๋ ํค์๋๋ค. next-intl, i18next, vue-i18n์ AI๊ฐ ํ์ตํ ์ฝ๋ ๊ณณ๊ณณ์ ์์ผ๋ฏ๋ก, AI๋ ๋์์ ๋น๊ตํ์ง ์๊ณ ์ด๋ค์ ๊ธฐ๋ณธ์ผ๋ก ์ถ์ฒํฉ๋๋ค. ์ถ์ฒ์ด ๋ค์ด๋ก๋๋ฅผ ๋๋ฆฌ๊ณ , ๊ทธ ๋ค์ด๋ก๋๊ฐ ๋ค์ ์ถ์ฒ์ ๋ถ์ถ๊น๋๋ค. ๋ค์ด๋ก๋ ์๊ฐ ์๋๋ผ ๋ฒค์น๋งํฌ๋ก ๋น๊ตํ์ธ์.
๋ต๋ณ์ ๋ง๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฐพ๊ธฐ
์๋ํ๋ ๊ฐ์ฅ ๋จ์ํ ๋๊ตฌ๋ฅผ ์ ํํ๊ณ ๊ณผ๋ํ ํฌ์๋ฅผ ํผํ์ธ์. ๋ก์ผ์ผ๋น ๋จ์ผ JSON์ ์ฌ์ฉํ๋ react-i18next๋ก๋ ์ถฉ๋ถํ๋ฉฐ, ์ง๋ 10๋
๊ฐ ์์ธ Stack Overflow ๋ต๋ณ๋ค์ด ์๊ฐ์ ์ ์ฝํด ์ค ๊ฒ์
๋๋ค. ํ์ํด์ง๊ธฐ ์ ๊น์ง๋ ๋ค์์คํ์ด์ค ์ค์ ์ ๊ฑด๋๋ฐ์ด๋ ์ข์ต๋๋ค. ํ๋กํ ํ์
์ด ์ ์ ์ ํ์ด ๋๋ค๋ฉด ๋ฒ์ ์ ํ ์ฝํ
์ธ ๋ก ๋ง์ด๊ทธ๋ ์ด์
ํ ๊ณํ์ ์ธ์ฐ์ธ์. react-i18next ํธํ ์ด๋ํฐ๋ฅผ ์ฌ์ฉํ๋ฉด ์ ์ง์ ์ผ๋ก ์ ํํ ์ ์์ต๋๋ค.
์นดํ๋ก๊ทธ ํ์์ด ์ด๋ฏธ ๊ฒฐ์ ๋ ์ํ์
๋๋ค. react-intl์ ICU ๋ค์ดํฐ๋ธ์ด๋ฉฐ FormatJS ์ถ์ถ ๋๊ตฌ๋ ํด๋น ํ์ดํ๋ผ์ธ์ ๋ง์ถฐ์ ธ ์์ต๋๋ค. use-intl ์ญ์ ICU๋ฅผ ์ง์ํฉ๋๋ค. react-i18next๋ ICU ํ๋ฌ๊ทธ์ธ์ด ํ์ํ๋ฉฐ, ๊ทธ๋ ์ง ์์ผ๋ฉด ์์ฒด ๋ณต์ํ ํค๋ฅผ ์ฌ์ฉํด์ผ ํฉ๋๋ค. Intlayer์ ICU ์ง์์ ์์ง ์ผ๋ถ ์์
์ค์ด๋ฏ๋ก, ํ์ฌ ICU ๋ฌธ์์ด์ ์ง์ ์ ๋ฌ๋ฐ๋๋ค๋ฉด ์๋ฒฝํ ์ง์๋ ๋๊น์ง ์ด๋ฅผ ๊ฒํ ์์๋ก ์ผ์์ผ ํฉ๋๋ค.
๊ท์น์ด ์๋ ๊ธฐ๋ณธ ๋์์ผ๋ก์ ๋ฒ์ ์ ํ ์ฝํ
์ธ ์ ๋์ ๋ก๋ฉ์ ์ง์ํ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ ํธํ์ธ์. Lingui์ Paraglide๋ ์ปดํ์ผ์ ํตํด ์ด๋ฅผ ๋ฌ์ฑํฉ๋๋ค. Intlayer๋ ์ปดํฌ๋ํธ๋ณ ์ ์ธ์ ํตํด ์ด๋ฅผ ๊ตฌํํ๋ฉฐ, ์ปดํ์ผ๋ฌ๊ฐ ๋ผ์ฐํธ์์ ๋ ๋๋งํ๋ ์ฝํ
์ธ ๋ง ์ ์กํฉ๋๋ค. react-i18next๋ use-intl์ ์ฌ์ฉํ๋ค๋ฉด ๋ค์์คํ์ด์ค์ lazy ๋ก๋ฉ ์ ๋ต์ ์ฒซ๋ ๋ถํฐ ๊ณํํ๊ณ ์ฝ๋ ๋ฆฌ๋ทฐ์์ ์๊ฒฉํ ๊ด๋ฆฌํด์ผ ํฉ๋๋ค. ๋๊ตฌ๊ฐ ์ด๋ฅผ ์๋์ผ๋ก ๊ฐ์ ํด์ฃผ์ง ์๊ธฐ ๋๋ฌธ์
๋๋ค.
๋ชจ๋ ํค ๊ธฐ๋ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ํ์
์ ์ง์ํ ์ ์์ง๋ง, ๊ธฐ๋ณธ์ผ๋ก ํ์ฑํ๋ ๊ฒฝ์ฐ๋ ๊ฑฐ์ ์์ต๋๋ค. lazy ๋ก๋ฉ๋๋ ๋ค์์คํ์ด์ค์ ๋ง์ถฐ declaration merging์ ์ง์ ์ ์ง๋ณด์ํ๊ณ ์ถ์ง ์๋ค๋ฉด, ์ฝํ
์ธ ๋ก๋ถํฐ ํ์
์ด ์๋ ์์ฑ๋๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ(Lingui, Paraglide, Intlayer)๋ฅผ ์ ํํ์ธ์. ๋๋ฝ๋ ๋ฒ์ญ ๊ฐ์ง ๊ธ์์ ๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋น๋ ํ์์ ๋ฌด์์ ๊ฐ์งํ๋์ง ๋น๊ตํฉ๋๋ค.
๋ฆฌ์น ๋
ธ๋๋ t()๊ฐ ๋จ์ ๋ฌธ์์ด์ ๋ฐํํ๋ ๋ฐฉ์์ ํ๊ณ๊ฐ ๋๋ฌ๋๋ ์ง์ ์
๋๋ค. react-i18next์ Lingui๋ <Trans>๋ฅผ ์ ๊ณตํ๊ณ , react-intl์ ๋ฆฌ์น ํ
์คํธ ํ๊ทธ๋ฅผ ์ ๊ณตํ์ง๋ง, ๋ชจ๋ ์ผ๋ฐ ๋ฌธ์์ด ๋ฐฉ์๋ณด๋ค ์ฌ์ฉํ๊ธฐ ๋ฒ๊ฑฐ๋กญ์ต๋๋ค. Intlayer์ ์ฝํ
์ธ ๋
ธ๋๋ JSX, ๋งํฌ๋ค์ด, ์ค์ฒฉ ๊ฐ์ฒด๋ฅผ ์ง์ ์ง์ํ๋ฏ๋ก ์ฝํ
์ธ ๊ฐ ๋จ์ UI ๋ผ๋ฒจ ์ด์์ผ ๋ ํจ์ฌ ์ ํฉํฉ๋๋ค.
๊ฐ์ ธ์ฌ TMS๊ฐ ์๋ค๋ฉด ์ค์์ง์ค์ JSON์ ๋ ์ด์ ํ์๊ฐ ์๋๋๋ค. ์ฝ๋ก์ผ์ด์
(colocated)๋ ์ฝํ
์ธ ์ ๋๋ฝ๋ ๋ก์ผ์ผ์ ์ฑ์์ฃผ๋ CLI ์กฐํฉ์ด ๊ฐ์ฅ ๋น ๋ฅธ ๋ฐฉ๋ฒ์
๋๋ค. Intlayer์ fill ๋ช
๋ น์ด๋ ์ฌ์ฉ์์ ์์ฒด API ํค(OpenAI, Anthropic, Mistral, Gemini)๋ฅผ ์ฌ์ฉํ์ฌ ๋ณ๊ฒฝ๋ ๋ด์ฉ๋ง ๋ฒ์ญํฉ๋๋ค. Paraglide์ Tolgee๋ ์์ฒด ํ๋์ ํตํด ํธ์คํ
๋๋ ์ ์ฌ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค.
React context๋ ์๋ฒ์ ํด๋ผ์ด์ธํธ ๊ฒฝ๊ณ๋ฅผ ๋์ง ๋ชปํฉ๋๋ค. ํด๋ผ์ด์ธํธ hook์๋ง ์์กดํ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ(react-i18next, react-intl)๋ RSC๋ฅผ ๋์
ํ๋ ์๊ฐ ๋ณ๋์ ์๋ฒ API๊ฐ ํ์ํ๊ฒ ๋ฉ๋๋ค. use-intl(next-intl๋ก ์ ๊ณต)๊ณผ Intlayer(next-intlayer๋ก ์ ๊ณต)๋ ์ด๋ฏธ ์ด๋ฌํ ๋ถ๋ฆฌ๋ฅผ ์ง์ํฉ๋๋ค. ํจํด์ ํ์คํํ๊ธฐ ์ ์ Next.js i18n ๊ฐ์ด๋๋ฅผ ์ฝ์ด๋ณด์ธ์.
๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ํ๊ณ์
๋ชจ๋ ์ ํ์๋ ํธ๋ ์ด๋์คํ๊ฐ ๋ฐ๋ฅด๋ฏ๋ก ์์งํ ํ๊ณ์ ์ ๊ณต์ ํฉ๋๋ค.
react-i18next: ํ๋ณด ์ค ๊ฐ์ฅ ๋ฌด๊ฑฐ์ด ๋ฐํ์, ๋ ์์ ์ธ ๋ณต์ํ ํฌ๋งท, ์ง์ ์ ์ง๋ณด์ํด์ผ ํ๋ ํ์ ์ฐ๊ฒฐ, ์กฐ์ฉํ ์์ด๋ ๋ฏธ์ฌ์ฉ ๋ฐ๋ ํค.react-intl: ๋ค์ ์ฅํฉํ ๊ฐ๋ฐ์ ๊ฒฝํ(useIntl()ํformatMessage({ id })), ์ฌ๋ฌ ๋ ธ๋์ ๊ฒฐํฉ๋ ์ ์ญ ์ธ์คํด์ค.use-intl: ์์์ ๊ฐ๋จํ์ง๋ง ์ต์ ํ๊ฐ ๊น๋ค๋ก์. ๋ค์์คํ์ด์ค, ๋์ ๋ก๋ฉ, ํ์ ์ค์ ์ ๋์์ ๊ด๋ฆฌํ๋ ค๋ฉด ๊ฐ๋ฐ ์๋๊ฐ ๋๋ ค์ง ์ ์์.Lingui: ์ถ๊ฐ์ ์ธextract/compile๋น๋ ๋จ๊ณ ํ์, ์ฌ๋ฌ ์ค๋ณต ๋ฌธ๋ฒ(t(), ํ๊ทธ๋ ํ ํ๋ฆฟ,i18n.t(),<Trans>)์ผ๋ก ์ธํด ์ฌ๋๊ณผ AI ์ด์์คํดํธ ๋ชจ๋ ํผ๋์ ๊ฒช์ ์ ์์.Paraglide: ๋ฆฌํฌ์งํ ๋ฆฌ ๋ด์ ํ์ผ ์์ฑ, React ๋ฒค์น๋งํฌ์์ ํธ๋ฆฌ ์์ดํน์ด ์จ์ ํ ์ ์ฉ๋์ง ์์, ๋ก์ผ์ผ์ ์ค์ store๊ฐ ์๋ ๊ฐ๋ณ ๋ ธ๋์ ์คํ ๋ฆฌ์ง์์ ๋งค๋ฒ ์ฝ์ด์ด.Tolgee: ํค ํ์ ๋ฏธ์ง์, ์๋์ ์ผ๋ก ์ด๋ ค์ด ์จ๋ณด๋ฉ, ์ธ์ปจํ ์คํธ ํธ์ง ๊ธฐ๋ฅ์ด ์ฃผ์ ๊ฐ์ .Intlayer: ํ์ ๋ฒ๋ค๋ฌ ํ๋ฌ๊ทธ์ธ ํ์, ์๋์ ์ผ๋ก ์์ ์ํ๊ณ, ๋ถ๋ถ์ ์ธ ICU ์ง์, ๊ตฌ์กฐ์ ์ฝํ ์ธ ๊ฐ ์ฝ๋๋ฒ ์ด์ค ์ ๋ฐ์ ๋ถ์ฐ๋์ด ์์ด ๋ฒ์ญ๊ฐ์๊ฒ ๋จ์ผ JSON์ ์ถ์ถํด ์ ๋ฌํ๋ ค๋ฉด ๋ณ๋ ๋๊ตฌ๊ฐ ํ์ํจ.gt-react,lingo.dev: ๋ฒค์น๋งํฌ์์ ๊ถ์ฅ๋์ง ์์: ๋น๋ ์ ์ฟผํฐ ์ค๋ฅ ๋ฐ์, ๋ฒค๋ ์ข ์์ฑ, provider์ ๋ฆฌ๋ ๋๋ง์ ๊ฐ์ ํด์ผ ํ๋ ๋ฐ์์ฑ ๋ฌธ์ .
์ฝ๋๋ก ์ดํด๋ณด๋ ๊ฐ ์ต์
์ ๋ชฉ๊ณผ ๋ณต์ํ์ด ํฌํจ๋ ๋์ผํ ์ฅ๋ฐ๊ตฌ๋ ์์ฝ ์ปดํฌ๋ํธ๋ฅผ ๊ฐ ํ๋ณด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ก ์์ฑํ ์์์ ๋๋ค. ์ค์ํ ๊ฒ์ ์ปดํฌ๋ํธ ์์ฒด๊ฐ ์๋๋ผ ์ฝํ ์ธ ๊ฐ ์ด๋์ ์ ์ฅ๋๋ฉฐ ํ์ ์ฒด์ปค๊ฐ ์ด๋ฅผ ์ด๋ป๊ฒ ์ธ์ํ๋์ง์ ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ณต์ํ์ Intl.PluralRules๋ฅผ ํตํด ํด์๋๋ ์ ๋ฏธ์ฌ ํค์
๋๋ค. CustomTypeOptions๋ฅผ ์ ์ธํ์ง ์์ผ๋ฉด t๋ (key: string) => string ํ์
์ด ๋๋ฏ๋ก t("titel") ๊ฐ์ ์คํ๋ ์ ์์ ์ผ๋ก ์ปดํ์ผ๋ฉ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋๋ถ๋ถ์ TMS ํ๋ซํผ์ด ๋ด๋ณด๋ด๋ ํ์์ธ ICU๋ฅผ ์ฒ์๋ถํฐ ๋๊น์ง ์ฌ์ฉํฉ๋๋ค. id์ ๋ํ ํ์
์ ๊ธฐ๋ณธ ์ ๊ณต๋์ง ์์ผ๋ฉฐ, formatjs ์ถ์ถ ๋จ๊ณ์ ์์ฑ๋ ์ ๋์จ ํ์
์ ํตํด ์ง์๋ฉ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
Next.js ๋ฐ์ธ๋ฉ์ด ์ ์ธ๋ next-intl๊ณผ ๋์ผํ ๊ตฌ์กฐ์
๋๋ค. AppConfig์ ๋ฉ์์ง ํ์
์ ํ์ฅ(augment)ํ๋ฉด ํค์ ํ์
์ด ์ ์ฉ๋๋ฉฐ, ๋ค์์คํ์ด์ค ๋ถํ ์ ์ฌ์ฉ์๊ฐ ์ง์ ๊ด๋ฆฌํด์ผ ํฉ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๊ธฐ๋ณธ ์์ค ์ธ์ด๋ ์ปดํฌ๋ํธ ๋ด์ ์์นํ๋ฉฐ, ๋ค๋ฅธ ๋ก์ผ์ผ์ lingui extract ํ ํด์๋ ID๋ฅผ ๊ฐ์ง .po ํ์ผ์ ์ ์ฅ๋ฉ๋๋ค. extract๋ compile์ ์์ผ๋ฉด ๊ฒฝ๊ณ ์์ด ๊ธฐ๋ณธ ์์ด๋ก ํด๋ฐฑ๋ฉ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ชจ๋ ๋ฉ์์ง๊ฐ ํ์
์ด ์ง์ ๋ ์์ฑ ํจ์์ด๋ฏ๋ก ํค๊ฐ ๋๋ฝ๋๋ฉด import ์๋ฌ๊ฐ ๋ฐ์ํฉ๋๋ค. paraglide/ ํด๋๊ฐ ์ฝ๋๋ฒ ์ด์ค ๋ด์ ์์ฑ๋๋ฉฐ ๋ณ๊ฒฝ๋ ๋๋ง๋ค ๋ค์ ์์ฑ๋ฉ๋๋ค.
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ชจ๋ ๋ก์ผ์ผ์ด ์ปดํฌ๋ํธ ๋ฐ๋ก ์์ ๋จ์ผ ํ์ผ์ ์์นํฉ๋๋ค. ํ์
์ด ๋น๋ ์ ์์ฑ๋๋ฏ๋ก title์ด ์๋ ์์ฑ๋๊ณ , ์คํ๊ฐ ์์ผ๋ฉด declaration merging ์์ด๋ tsc ์๋ฌ๊ฐ ๋ฐ์ํฉ๋๋ค. ์ปดํฌ๋ํธ ํด๋๋ฅผ ์ญ์ ํ๋ฉด ๊ด๋ จ ๋ฌธ์์ด๋ ํจ๊ป ์ ๋ฆฌ๋ฉ๋๋ค.
์ด๋ฏธ react-i18next, react-intl, Lingui๋ฅผ ์ฌ์ฉ ์ค์ด์ ๊ฐ์? ํธํ ์ด๋ํฐ(react-i18next, react-intl, Lingui)๊ฐ ๋ฒ๋ค๋ฌ ์์ค์์ import๋ฅผ ๋ณ์นญ ์ฒ๋ฆฌ(alias)ํ์ฌ ์ปดํฌ๋ํธ ๋จ์๋ก ์ด์ ํ๋ ๋์์๋ ๊ธฐ์กด API๊ฐ ๊ทธ๋๋ก ์๋ํ๋๋ก ์ง์ํฉ๋๋ค. ๊ทธ ์ธ์ ๋ด์ฉ์ ๋ง์ด๊ทธ๋ ์ด์
๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ต์ข ๊ฒฐ์ ์ ํ์ธํ ์ฌํญ
๊ธฐ๋ฅ ํ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ํ์ฌ ๋ฌด์์ ํ ์ ์๋์ง๋ง ๋ณด์ฌ์ค๋๋ค. ๋ค์ ํญ๋ชฉ๋ค์ ์ค์ ๋ก ์ด์ํ๋ฉด์ ๋ง์ฃผํ๊ฒ ๋ ๊ฒฝํ์ ์๋ ค์ค๋๋ค.
์ ์ฅ์ ํ๋์ฑ์ ํ์ธํ์ธ์.
์ปค๋ฐ ์ฃผ๊ธฐ, ์ด์ ์๋ต ์๊ฐ, ์ต๊ทผ ๋ง์ด๋ ๋ฆด๋ฆฌ์ค๊ฐ ์ฌํด ์์๋์ง ํ์ธํ์ธ์. ์ ์ง๋ณด์์๊ฐ ์๋ ํ๋ฅญํ ์ค๊ณ๋ ๊ฒฐ๊ตญ ๋ง์ด๊ทธ๋ ์ด์ ๋ถ์ฑ๊ฐ ๋ฉ๋๋ค.
npm ๋ค์ด๋ก๋ ์๋ง ๋ณด๊ณ ์ ํํ์ง ๋ง์ธ์.
๊ฐ์ฅ ๋ง์ด ์ค์น๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๊ฐ์ฅ ๋จผ์ ์ถ์๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ผ ๋ฟ, 2026๋ React ์ฝ๋๋ฒ ์ด์ค์ ๊ฐ์ฅ ์ ํฉํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์๋ ์ ์์ต๋๋ค. ๋ค์ด๋ก๋ ์๋ ์ ํฉ์ฑ์ด ์๋ ์ญ์ฌ๋ฅผ ๋ํ๋ ๋๋ค.

์ ์ง๋ณด์ ๋น์ฉ์ ๋๊ฐ ์ง์ํ๊ณ , ๋ฌด์์ ํ๋งคํ๋์ง ์ดํด๋ณด์ธ์.
i18next๋ Locize์ ์ง์์ ๋ฐ์ต๋๋ค. next-intl / use-intl, vue-i18n, svelte-i18n, Lingui๋ Crowdin์ ์ง์์ ๋ฐ์ต๋๋ค. Tolgee, Paraglide(inlang), Intlayer๋ ๊ฐ๊ฐ ์์ฒด ํ๋ซํผ์ ์ด์ํฉ๋๋ค. ํธ์คํ
๋ฒ์ญ ์๋น์ค๊ฐ ์ฃผ ์์ต์์ธ ํ์ฌ๋ ๋๊ตฌ ์ฒด์ธ ๋ด์์ ๋ฒ์ญ์ ๋ฌด๋ฃ๋ก ์ ๊ณตํ ์ ์ธ์ด ์ ์ต๋๋ค. Intlayer๋ ์์ฒด API ํค๋ฅผ ํ์ฉํ CLI ๊ธฐ๋ฐ AI ๋ฒ์ญ๊ณผ ์
ํ ํธ์คํ
๊ฐ๋ฅํ CMS๋ฅผ ํจ๊ป ์ ๊ณตํ๋ ์ ์ผํ ๋๊ตฌ์
๋๋ค.
AI ์์ด์ ํธ ์นํ์ ์ธ๊ฐ์?
AI ์์ด์ ํธ๋ ์ฌ์ ํ i18n ์์ ์์ ์ค์๋ฅผ ๋ฒํฉ๋๋ค. ๋ก์ผ์ผ์ ๋๋ฝํ๊ฑฐ๋, ์๋ ํค๋ฅผ ์์๋ก ๋ง๋ค๊ณ , ๋ฉ์์ง ๋ฌธ๋ฒ์ ํผ๋ํ๊ณค ํฉ๋๋ค. ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์์ด์ ํธ๊ฐ ์ฝํ ์ธ ๋ฅผ ์กฐํ, ์ฑ์ฐ๊ธฐ(fill), ํ ์คํธํ ์ ์๋ Agent Skills๋ MCP ์๋ฒ๋ฅผ ์ ๊ณตํ๋์? ๋ํ ์ฝํ ์ธ ๋ก๋ฉ์ด ๊ธฐ๋ณธ์ ์ผ๋ก ์ต์ ํ๋์ด ์๋์ง, ์๋๋ฉด ๋ถ๊ธฐ๋ง๋ค ๋ค์์คํ์ด์ค์ lazy import๋ฅผ ์๋์ผ๋ก ๊ฒํ ํด์ผ ํ๋์ง ํ์ธํ์ธ์.
๊ธฐ๋ณธ์ผ๋ก ์ ๊ณต๋๋ ํ์ ์์ ์ฑ.
"์ถ๊ฐ ์ค์ ์ ํตํด ํ์
์ ์ง์ ํ ์ ์์"์ด ์๋๋ผ "์๋ก ์ค์นํ์๋ง์ ์๋ชป๋ ํค๋ฅผ ์ฌ์ฉํ๋ฉด tsc๊ฐ ์คํจํจ"์ ์๋ฏธํฉ๋๋ค. ์กด์ฌํ์ง ์๋ ํค๋ฅผ ์ฌ์ฉํ ๋์ ํน์ ๋ก์ผ์ผ์ ๋ฒ์ญ์ด ํ๋ ๋๋ฝ๋์์ ๋ ์ด๋ค ์ผ์ด ๋ฐ์ํ๋์ง ํ์ธํด ๋ณด์ธ์.
๋ฏธ์ฌ์ฉ ์ฝํ ์ธ ๊ฐ์ง.
์นดํ๋ก๊ทธ๋ ์๊ฐ์ด ์ง๋จ์ ๋ฐ๋ผ ๋์ด๋๊ธฐ๋ง ํฉ๋๋ค. Intlayer ๋น๋๋ ์ฌ์ฉ๋์ง ์๋ ํ๋๋ฅผ ์ ๊ฑฐํ๊ณ ๋ก๊ทธ๋ฅผ ๋จ๊น๋๋ค(build.purge). Paraglide๋ ํธ์ถ๋์ง ์์ ๋ฉ์์ง ํจ์๊ฐ ํธ๋ฆฌ ์์ดํน๋๋ฏ๋ก ์ํคํ
์ฒ์ ์ผ๋ก ์ด๋ฅผ ํด๊ฒฐํฉ๋๋ค. ๊ทธ ์ธ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋ฏธ์ฌ์ฉ ํค ์ ๋ฆฌ๋ฅผ ์ ์ ์ผ๋ก ๊ฐ๋ฐ์์๊ฒ ๋งก๊น๋๋ค.
๊ฐ๋ฐ์ ๊ฒฝํ (DX).
์ฒซ ๋ฒ์ญ ๋ฌธ์์ด๊น์ง์ ์ค์ ์๊ฐ, ๋ง์ฐ์ค ํธ๋ฒ ์ ๋ฒ์ญ์ ๋ฏธ๋ฆฌ ๋ณด์ฌ์ฃผ๊ณ ์ ์ธ ์์น๋ก ๋ฐ๋ก ์ด๋ํ ์ ์๋ LSP ๋๋ VS Code ํ์ฅ ํ๋ก๊ทธ๋จ, fill, test, push๋ฅผ ์ง์ํ๋ CLI, ์ปดํฌ๋ํธ์ ํ๋์ฝ๋ฉ๋ ๋ฌธ์์ด์ ์ถ์ถํด ํค ํ๋ํ๋๋ฅผ ์ง์ ๊ด๋ฆฌํ์ง ์์๋ ๋๊ฒ ํด์ฃผ๋ ์ปดํ์ผ๋ฌ ๋๋ ์ถ์ถ๊ธฐ, ๋น๊ฐ๋ฐ์๊ฐ ํ ๋ฆฌํ์คํธ ์์ด๋ ์ฝํ ์ธ ๋ฅผ ํธ์งํ ์ ์๋ ๋๊ตฌ(๋น์ฃผ์ผ ์๋ํฐ ๋๋ CMS)๊ฐ ์ ๊ณต๋๋์ง ํ์ธํ์ธ์.
์์ฃผ ๋ฌป๋ ์ง๋ฌธ (FAQ)
๋๋ถ๋ถ์ ํ์๊ฒ๋ ๊ทธ๋ ์ต๋๋ค. ๊ฐ์ฅ ํฐ ์ํ๊ณ์ ์จ๋ผ์ธ์ ๊ฐ์ฅ ๋ง์ ๋ฌธ์ ํด๊ฒฐ ์๋ฃ๋ฅผ ๋ณด์ ํ๊ณ ์์ต๋๋ค. ๋ค๋ง ๊ฐ์ฅ ๋ฌด๊ฑฐ์ด ๋ฐํ์, ๋ ์์ ์ธ ๋ณต์ํ ํฌ๋งท, ์ง์ ์ค์ ํ๊ณ ๊ด๋ฆฌํด์ผ ํ๋ ํ์ ์์ ์ฑ ๋ฐ ์ค์ฝํ ๋ฑ ๋ช ํํ๊ณ ์์ธก ๊ฐ๋ฅํ ํธ๋ ์ด๋์คํ๊ฐ ์กด์ฌํฉ๋๋ค.
๋ฒ๋ค ํฌ๊ธฐ, ์๋ ์์ฑ๋๋ ํ์ , ๋น๋ ํ์ ๋๋ฝ ํค ๊ฒ์ฌ๊ฐ ์๊ตฌ์ฌํญ์ ํฌํจ๋ ๊ฒฝ์ฐ์๋ง ํ์ํฉ๋๋ค. 2๊ฐ ๋ก์ผ์ผ์ ๊ฐ์ง ์๊ท๋ชจ ์ฑ์ด๋ผ๋ฉด ๋ฐํ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋ ๊ฐ๋จํฉ๋๋ค. ์ปดํ์ผ๋ฌ vs ์ ์ธํ i18n ํฌ์คํธ์์ ์ปดํ์ผ๋ฌ๊ฐ ์ ๊ณตํ๋ ์ด์ ๊ณผ ์ฃผ์ํ ์ ์ ์ค๋ช ํฉ๋๋ค.
๋ถ๋ถ์ ์ผ๋ก ๊ฐ๋ฅํฉ๋๋ค. ํค ๊ธฐ๋ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ค์ ์ ์ฌํ ๊ตฌ์กฐ๋ฅผ ๊ณต์ ํ๋ฏ๋ก ํธํ ์ด๋ํฐ๋ฅผ ํตํด ํ๋์ API๋ฅผ ๋ค๋ฅธ API๋ก ๋ณ์นญ(alias) ์ฒ๋ฆฌํ ์ ์์ผ๋ฉฐ, ์ด๊ฒ์ด Intlayer ์ด๋ํฐ์ ์๋ ๋ฐฉ์์ ๋๋ค. ๋ค๋ง ๋ฉ์์ง ํฌ๋งท(ICU vs i18next vs ํฌํผ)์ ์๋์ผ๋ก ๋ณํ๋์ง ์์ผ๋ฏ๋ก ๋ณต์ํ์ด๋ ๋ณด๊ฐ(interpolation) ๋ถ๋ถ์ ์ง์ ์์ ํด์ผ ํฉ๋๋ค.
๊ฐ์ ์ ์ผ๋ก ์ํฅ์ ๋ฏธ์นฉ๋๋ค. ํฌ๋กค๋ฌ๊ฐ ๋ณด๋ ๋ด์ฉ์ ๋ผ์ฐํ
, hreflang, <html lang> ์ค์ , ๊ทธ๋ฆฌ๊ณ ํ
์คํธ๊ฐ ์๋ฒ ๋ ๋๋ง๋ HTML์ ํฌํจ๋๋์ง์ ๋ฐ๋ผ ๊ฒฐ์ ๋ฉ๋๋ค. ์ผ๋ถ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ด๋ฅผ ๋๋ ํฌํผ๋ฅผ ์ ๊ณตํ์ง๋ง ๋๋ถ๋ถ์ ๊ฐ๋ฐ์๊ฐ ์ง์ ์ฒ๋ฆฌํด์ผ ํฉ๋๋ค. ์์ธํ ๋ด์ฉ์ hreflang ๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํ์ธ์.
๋ ์์๋ณด๊ธฐ
๋๊ธ
์์ง ๋๊ธ์ด ์์ต๋๋ค. ์ฒซ ๋ฒ์งธ๋ก ์๊ฒฌ์ ๋๋ ๋ณด์ธ์.
