메인 콘텐츠로 건너뛰기

지원하는 언어

rosetta는 50개 언어에 대한 구조화된 구성 파일인 Language Cards를 제공해요. 각 카드에는 어조(register) 프리셋, 존댓말 체계 메타데이터, 번역 방식 지원 플래그, 타이포그래피 규칙 및 문자 정보가 포함되어 있어요. LLM이 알고 있는 언어라면 구성 파일에 한 줄만 추가하여 어떤 언어든 추가할 수 있어요. 여기에 나열된 언어들은 프로덕션 환경에 바로 사용할 수 있도록 엄선된 어조가 준비된 언어들이에요.

번역 방식​

각 언어는 다음 번역 방식 중 하나 이상을 사용할 수 있어요.

아이콘방식작동 원리비용
🟢Google Translate신경망 기계 번역(Neural MT) 베이스라인. 130개 이상 언어 지원. 키-값 문자열 전용 — Markdown 콘텐츠는 안전하게 번역할 수 없어요.100만 자당 약 $20
🔵LLM (OpenRouter)모델이 알고 있는 모든 언어 지원. 어조가 조정된 프롬프트. 키-값 및 Markdown 콘텐츠를 모두 처리해요.모델에 따라 다름
🟣LLM-CoachedLLM + 문법 사전 + 프롬프트에 주입된 코칭 데이터. 형태론적으로 복잡한 언어에 가장 적합해요.모델에 따라 다름
🟠API (Plugin)HTTP를 통해 제공되는 커뮤니티 호스팅 번역 파이프라인. OCAP 호환.제공자에 따라 다름

Google Translate의 경우 GOOGLE_TRANSLATE_API_KEY를 설정하고, LLM 방식의 경우 OPENROUTER_API_KEY를 설정하세요. 자세한 내용은 번역 방식을 참고해 주세요.

우선 지원 언어​

웹 및 모바일 애플리케이션에서 가장 많이 요청되는 로케일이며, rosetta가 권장하는 접근성 우선 순위로 나열되어 있어요.

국기언어코드GoogleLLMCoached문자참고
🇸🇦아랍어ar✅✅✅—우측에서 좌측으로 읽음(RTL). 현대 표준 아랍어(فصحى).
🇵🇭필리핀어(타글리시)tl / fil✅✅✅—Docusaurus 구성에서는 fil를 사용하세요. rosetta는 둘 다 처리할 수 있어요.
🇫🇷프랑스어fr✅✅✅—Vous 형태. 성 포용적(Connecté·e).
🇪🇸스페인어es✅✅✅—중립적인 라틴 아메리카 스페인어.
🇩🇪독일어de✅✅✅—Sie 형태. 성 포용적(Benutzer:innen).
🇯🇵일본어ja✅✅✅—본문 텍스트는 です/ます, UI 레이블은 する 형태.
🇨🇳중국어(간체)zh✅✅✅—简体中文.
🇮🇹이탈리아어it✅✅✅—Lei 형태.
🇧🇷포르투갈어(브라질)pt✅✅✅—브라질 포르투갈어.
🇰🇷한국어ko✅✅✅—해요체.

주요 세계 언어​

국기언어코드GoogleLLMCoached문자참고
🇧🇩벵골어bn✅✅✅—শুদ্ধ ভাষা 선호.
🇧🇬불가리아어bg✅✅✅—
🇨🇿체코어cs✅✅✅—Vykání (vy 형태).
🇩🇰덴마크어da✅✅✅—
🇬🇷그리스어el✅✅✅—현대 Δημοτική.
🇮🇷페르시아어fa✅✅✅—우측에서 좌측으로 읽음(RTL).
🇫🇮핀란드어fi✅✅✅—문법적 성별 없음.
🇮🇱히브리어he✅✅✅—우측에서 좌측으로 읽음(RTL).
🇮🇳힌디어hi✅✅✅—शुद्ध हिन्दी. 영어 외래어 최소화.
🇭🇺헝가리어hu✅✅✅—Ön 형태.
🇮🇩인도네시아어id✅✅✅—
🇲🇾말레이어ms✅✅✅—
🇳🇱네덜란드어nl✅✅✅—U 형태.
🇳🇴노르웨이어nb✅✅✅—보크몰(Bokmål).
🇵🇱폴란드어pl✅✅✅—Pan/Pani 형태.
🇵🇹포르투갈어(유럽)pt-PT✅✅✅—유럽 포르투갈어.
🇷🇴루마니아어ro✅✅✅—
🇷🇺러시아어ru✅✅✅—Вы 형태.
🇸🇰슬로바키아어sk✅✅✅—Vykanie (vy 형태).
🇷🇸세르비아어sr✅✅✅🔤 라틴 문자→키릴 문자결정론적 문자 변환기.
🇸🇪스웨덴어sv✅✅✅—
🇰🇪스와힐리어sw✅✅✅—
🇹🇭태국어th✅✅✅—ครับ/ค่ะ 존댓말 조사.
🇹🇷튀르키예어tr✅✅✅—Siz 형태.
🇺🇦우크라이나어uk✅✅✅—Ви 형태.
🇵🇰우르두어ur✅✅✅—우측에서 좌측으로 읽음(RTL). آپ 형태.
🇻🇳베트남어vi✅✅✅—
🇹🇼중국어(번체)zh-TW✅✅✅—繁體中文.
🇬🇪조지아어ka✅✅——ქართული. 카르트벨리어족.
🇳🇬요루바어yo✅✅——Èdè Yorùbá. 성조 언어(3성).

지역별 변형 언어​

국기언어코드GoogleLLMCoached문자참고
🇲🇽멕시코 스페인어es-MX✅✅✅—Tú 형태. 따뜻한 어조.
🇨🇦캐나다 프랑스어fr-CA✅✅✅—퀘벡어 관용구.

토착어 및 자원이 부족한 언어​

이 언어들은 상용 기계 번역 서비스에서 지원하지 않아요. rosetta는 언어 커뮤니티가 OCAP 원칙에 따라 자체적인 번역 방식을 구축할 수 있도록 도구를 제공해요.

언어코드GoogleLLMCoached문자상태
🪶평원 크리어crk❌✅✅🔤 SRO→음절 문자🚧 개발 중
🌄케추아어qu✅✅——Runasimi. 증거성 접미사.

:::info 평원 크리어는 현재 활발히 개발 중이에요 평원 크리어의 어조, 코칭 인프라, 문자 변환기 및 평가 도구(harness)는 모두 작동하지만, 번역 파이프라인은 아직 출시되지 않았어요. 출시 전 품질을 보장하기 위해 OCAP 원칙에 따라 언어 커뮤니티와 협력하고 있어요. 전체 내용과 기여 방법에 대해서는 자원이 부족한 언어 지원하기를 참고해 주세요. :::

:::tip 자원이 부족한 언어 추가하기 rosetta의 번역 방식 플러그인 시스템은 이를 위해 설계되었어요. 언어 커뮤니티는 맞춤형 번역 방식을 구축하고 자체적으로 호스팅하여 API 방식을 통해 제공할 수 있어요. 번역 방식 리더보드는 모든 언어 쌍의 점수를 추적해요. 번역 방식을 구축하고, 평가 도구를 실행하여 최고 점수를 달성해 보세요. :::

인공어​

인공어(Conlangs)는 LLM 어조와 선택적 문자 변환기를 통해 지원돼요. 실제 언어와 동일한 인프라를 사용하며, 품질 검증(quality gate), 코칭 시스템, 문자 변환 파이프라인이 동일하게 작동해요.

언어코드GoogleLLM문자참고
🖖클링온어tlh❌✅🔤 로마자 표기→pIqaDPUA 폰트 필요. Marc Okrand 어휘.
🧝신다린(톨킨 엘프어)x-elvish-s❌✅🔤 라틴 문자→텡과르CSUR PUA 폰트 필요.
🏴‍☠️해적 영어x-pirate❌✅—어조 전용. 해상 은유.
🦸크립톤어x-kryptonian❌✅🔤 라틴 문자→크립톤 문자PUA 폰트 필요.
🎭셰익스피어 영어x-shakespeare❌✅—어조 전용. Thee/thou, -eth/-est 형태.
🐸요다어x-yoda❌✅—어조 전용. OSV 어순.

PUA 폰트 요구 사항, 유니코드 제한 사항 및 직접 추가하는 방법에 대해서는 인공어, 문자 및 정서법을 참고해 주세요.

언어 프리셋​

init 마법사는 빠른 설정을 위해 프리셋 이름을 지원해요. 프리셋과 개별 코드를 혼합해서 사용할 수 있어요.

프리셋확장 결과
europeanfr, de, es, it, pt, nl
asianja, zh, ko
globalfr, es, de, ja, zh, ko, pt, ar
nordicda, fi, nb, sv
# Mix presets with individual codes
i18n-rosetta init
# → Target languages: european, ja
# → Resolves to: fr, de, es, it, pt, nl, ja

모든 언어 추가하기​

rosetta는 LLM이 알고 있는 모든 언어로 번역할 수 있어요. 위 표는 내장된 어조 프리셋이 있는 언어들만 나열한 것이에요. 목록에 없는 언어를 추가하려면 구성 파일에 해당 언어의 BCP-47 코드를 포함하세요.

{
  "languages": {
    "sw": {},
    "am": {
      "register": "Formal Amharic. Professional register with Geʽez script."
    }
  }
}

LLM은 해당 언어에 대해 학습된 지식을 사용하여 번역을 수행해요. register를 설정하면 어조, 격식, 정서법 관례를 제어할 수 있어요. 자세한 내용은 구성을 참고해 주세요.

Language Cards​

내장된 각 언어에는 성능을 위해 두 계층으로 나뉜 구조화된 JSON 구성인 Language Card가 있어요.

2계층 아키텍처​

계층디렉터리로드 시점목적
런타임(Runtime)lib/data/language-cards/import에서 즉시(Eagerly)번역 엔진: 어조, 격식, 규칙, 번역 방식 지원
레퍼런스(Reference)lib/data/language-reference/필요할 때 지연(Lazily)개발자 문서: 언어적 과제, 백과사전 데이터, NLP 리소스

런타임 계층은 작게 유지되어(카드당 약 2KB) rosetta를 가져올 때 수 메가바이트의 문서 데이터를 로드하지 않아요. 레퍼런스 계층은 도구, 웹사이트 및 평가 도구(eval harness)를 위해 getLanguageReference(code)를 통해 사용할 수 있어요.

런타임 카드 필드​

필드포함 내용
nativeName내명(Endonym) — 해당 언어의 고유 문자로 표기한 언어의 자체 이름 (예: ქართული, Runasimi)
Formality systemT-V 구분, 높임말 체계, 경어(keigo), 조사 등
Register presets해당 언어의 특성에 맞춘 이름이 지정된 LLM 프롬프트 프리셋
Method support이 언어를 지원하는 번역 API
Gender guidance문법적 성별 규칙 및 포용적 글쓰기 팁
Script/directionISO 15924 문자 코드 및 RTL/LTR 방향
Rules타이포그래피(따옴표, 띄어쓰기), 대소문자 표기, 복수형 범주
Eval datasets이 언어를 다루는 벤치마크
glottocode상호 참조를 위한 표준 Glottolog 식별자
humanReviewed원어민 화자가 카드를 검토했는지 여부

레퍼런스 카드 필드​

필드포함 내용
Linguistic challenges기계 번역(MT) 특유의 함정 (예: 증거성, 성조 발음 구별 기호, 교착성)
Encyclopedic어족, 분류, 화자 수, 지역
ResourcesNLP 도구, 병렬 말뭉치, 사전 학습된 모델

새 Language Card 스캐폴딩하기​

생성기를 사용하여 신뢰할 수 있는 데이터 소스(IANA, CLDR, Glottolog)에서 두 계층을 스캐폴딩하세요.

# Preview what would be generated
node scripts/generate-language-card.mjs sw --dry-run

# Generate both runtime + reference cards
node scripts/generate-language-card.mjs sw

생성기는 메타데이터(코드, 문자, 방향, 복수형, 따옴표, 번역 방식 지원, 어족)를 자동으로 채우고, 언어적 판단이 필요한 필드는 사람이 큐레이션할 수 있도록 TODO로 표시해요.

프리셋 키 사용하기​

전체 어조 텍스트를 작성하는 대신 프리셋 키 이름을 사용할 수 있어요.

{
  "languages": {
    "fr": "casual-tu",
    "ko": "formal-hapsyo",
    "ja": "polite"
  }
}

Rosetta는 키를 전체 어조 프롬프트로 변환해요. 각 언어에서 사용할 수 있는 프리셋을 확인하려면 npx i18n-rosetta init을 실행하세요.

프리셋 예시​

언어프리셋기본값
프랑스어formal-vous, casual-tuformal-vous
한국어polite-haeyo, formal-hapsyo, casual-haepolite-haeyo
일본어polite, formal-keigo, casualpolite
독일어formal-Sie, casual-duformal-Sie
태국어neutral-professional, polite-male, polite-femaleneutral-professional
스페인어neutral-professional, formal-usted, casual-tuteoneutral-professional

필드 유효성 검사 및 PR 체크리스트를 포함한 전체 사양은 Language Card 기여하기를 참고해 주세요.

참고 항목​