현지화 언어 기여 가이드

새로운 현지화 언어 지원을 추가하는 방법

1단계: 언어 템플릿 파일 복사

# lang/en.json을 템플릿으로 복사
cp lang/en.json lang/xx.json

여기서 xx는 추가할 언어의 ISO639-1 언어 코드(zh-CN, ja, ko 등)입니다. 전체 언어 코드 및 언어명은 부록 언어 코드를 참조하세요.

2단계: 템플릿 파일 내용 업데이트

새로 생성한 lang/xx.json 파일, 예를 들어 lang/ko.json을 편집하여 모든 영어 내용을 대상 언어로 번역합니다. 다음은 완전한 한국어 언어 파일 예제입니다:

{
  "name": "Korean",
  "author": "https://github.com/your-username",
  "months": "1월|2월|3월|4월|5월|6월|7월|8월|9월|10월|11월|12월",
  "short_months": "1월|2월|3월|4월|5월|6월|7월|8월|9월|10월|11월|12월",
  "weeks": "일요일|월요일|화요일|수요일|목요일|금요일|토요일",
  "short_weeks": "일|월|화|수|목|금|토",
  "seasons": "봄|여름|가을|겨울",
  "constellations": "양자리|황소자리|쌍둥이자리|게자리|사자자리|처녀자리|천칭자리|전갈자리|사수자리|염소자리|물병자리|물고기자리",
  "year": "%d 년",
  "month": "%d 개월",
  "week": "%d 주",
  "day": "%d 일",
  "hour": "%d 시간",
  "minute": "%d 분",
  "second": "%d 초",
  "now": "방금",
  "ago": "%s 전",
  "from_now": "%s 후",
  "before": "%s 전",
  "after": "%s 후"
}

필드 설명

필드	설명	예시
name	ISO 언어명	"Korean"
author	기여자 링크	"https://github.com/your-username"
months	전체 월 이름, |로 구분	"1월|2월|3월..."
short_months	짧은 월 이름, |로 구분	"1월|2월|3월..."
weeks	전체 요일 이름, |로 구분	"일요일|월요일|화요일..."
short_weeks	짧은 요일 이름, |로 구분	"일|월|화..."
seasons	계절 이름, |로 구분	"봄|여름|가을|겨울"
constellations	별자리 이름, |로 구분	"양자리|황소자리|쌍둥이자리..."
year	연도 형식, 단수/복수 지원	"%d 년"
month	월 형식, 단수/복수 지원	"%d 개월"
week	주 형식, 단수/복수 지원	"%d 주"
day	일 형식, 단수/복수 지원	"%d 일"
hour	시간 형식, 단수/복수 지원	"%d 시간"
minute	분 형식, 단수/복수 지원	"%d 분"
second	초 형식, 단수/복수 지원	"%d 초"
now	"now"의 번역	"방금"
ago	"ago"의 번역	"%s 전"
from_now	"from now"의 번역	"%s 후"
before	"before"의 번역	"%s 전"
after	"after"의 번역	"%s 후"

단수/복수 설명

1. 동아시아 언어(중국어, 일본어, 한국어 등): 일반적으로 하나의 형식만 사용

   "year": "%d 년",
   "month": "%d 개월"

2. 인도유럽어족(영어, 프랑스어, 독일어 등): 단수/복수를 구분해야 함

   "year": "1 year|%d years",
   "month": "1 month|%d months"

3. 슬라브어족(러시아어, 우크라이나어 등): 더 복잡한 복수 규칙이 있을 수 있음

   "year": "1 год|2 года|3 года|4 года|%d лет"

3단계: Pull Request 제출

1. 브랜치 생성

   git checkout -b add-xx-language-support

2. 변경사항 커밋

   git add lang/xx.json
   git commit -m "add XX language support #39"

3. 푸시 및 Pull Request 생성

   git push origin add-xx-language-support

4. Pull Request 제목 형식

   Add XX Language Support #39

4단계: 테스트 검증

제출 전에 다음을 확인하세요:

1. JSON 형식이 올바름: JSON 검증 도구를 사용하여 구문 확인
2. 필드가 완전함: 필요한 20개의 필드가 모두 포함되어 있는지 확인
3. 구분자가 올바름: 배열 구분자로 | 사용
4. 플레이스홀더가 올바름: 숫자 플레이스홀더로 %d, 문자열 플레이스홀더로 %s 사용
5. 일관성 유지: 번역 스타일이 기존 언어 파일과 일관성 있는지 확인
6. 문화적 적응성: 대상 언어의 문화적 배경과 표현 습관 고려

Carbon 프로젝트에 새로운 현지화 언어 지원을 기여해 주셔서 감사합니다!