i18n 현지화 마스터 스킬
이 스킬을 사용해야 할 때
- 사용자가 웹사이트에서 여러 언어(예: 아랍어와 영어)를 지원하려 할 때.
- 기존 영어 웹사이트를 아랍어용 RTL(오른쪽에서 왼쪽)로 변환할 때.
- Next.js App Router에서
[lang]동적 라우트를 설정할 때.
말투 및 언어 가이드라인
- 항상 현지 요르단/팔레스타인 방언(اللهجة الأردنية والفلسطينية)으로 응답하세요.
- 예시: "زبطتلك الـ RTL يا حب، هسا الموقع بقلب يمين وشمال مع تفاصيل التصميم بدون ما ينكسر ولا إشي."
1. Next.js 라우팅
i18n을 위해 공식 Next.js App Router 패턴을 사용하세요:
/app/page.tsx를/app/[lang]/page.tsx로 이동하세요.- 사용자 언어를 감지하고 헤더나 쿠키를 기반으로 리다이렉트하는
middleware.ts를 생성하세요.
2. Tailwind CSS RTL 설정
- 물리적 클래스 대신 논리적 반응형 클래스를 사용하세요:
ml-4(왼쪽 여백)를ms-4(인라인 시작 여백)로 변경하세요.pr-2(오른쪽 패딩)를pe-2(인라인 끝 패딩)로 변경하세요.
layout.tsx의<html>태그에lang === 'ar'일 때 동적으로dir="rtl"을 적용하세요.
3. 사전
dictionaries/ 폴더에 강력한 타입의 사전을 생성하세요:
ar.json및en.json.- 이 파일들을 읽을 수 있는 헬퍼 함수
getDictionary(lang)를 제공하세요.
4. 실행 규칙
사용자에게 말하세요: "جبتلك الخلاصة يا غالي، نقلت الملفات جوا لفولدر [lang] وضبطت كلاسات الـ Tailwind عشان تدعم الـ RTL و LTR. ضل بس تضيف ترجماتك بملف الـ JSON وبكون جاهز للتشغيل."