JSON은 웹사이트와 앱이 데이터, 설정, 다국어 문구(i18n 언어 팩)를 담을 때 가장 많이 쓰는 형식입니다. 언어 팩은 보통 "키 이름": "문구" 짝으로 이루어지고 프로그램은 키 이름으로 문구를 찾으므로, 변환할 때 키 이름은 바뀌면 안 됩니다. 구조와 형식도 원본 그대로여야 원래 파일과 비교하기 쉽습니다. 앱이나 웹사이트를 중화권에 맞게 현지화할 때, 간체 언어 팩 하나에서 대만용과 홍콩용 문구를 뽑는 출발점으로 쓸 수 있습니다.
바뀌는 부분
- 문자열 값. 배열과 중첩된 객체 안의 문자열도 포함합니다.
\u5934\u53d1처럼\u이스케이프로 쓴 중국어. 이 예는 头发(머리카락) 두 글자입니다.- 키 이름(선택, 기본은 끔).
그대로인 부분
- 키 이름, 숫자,
true,false,null, 객체와 배열의 구조. - 들여쓰기와 형식. 바뀐 문자열만 다시 인코딩하고 나머지 바이트는 원본 그대로 둡니다.
아래 예시는 ‘대만’ 표준과 ‘지역 어휘 변환’으로 바꾼 결과라서, 打印机 → 印表機처럼 단어까지 대만 표현으로 바뀝니다.
인코딩과 호환
JSON 표준은 시스템끼리 주고받을 때 UTF-8을 쓰도록 정하고 있고, 많은 프로그램도 UTF-8로 읽습니다. GBK나 Big5로 된 파일은 자동으로 인식하며 결과는 언제나 UTF-8입니다. BOM은 기본으로 원본을 따르므로, 원래 BOM이 없던 파일에 BOM이 붙지 않습니다.
변환 예시
| 원문 | 결과 |
|---|---|
| {"title": "软件设置"} | {"title": "軟體設定"} |
| {"menu.file": "文件", "menu.help": "帮助"} | {"menu.file": "檔案", "menu.help": "幫助"} |
| {"msg": "内存不足,请关闭后台程序"} | {"msg": "記憶體不足,請關閉後臺程式"} |
| {"count": 3, "enabled": true, "label": "打印机"} | {"count": 3, "enabled": true, "label": "印表機"} |
| {"tip": "\u70b9\u51fb\u4fdd\u5b58"} | {"tip": "點選儲存"} |
OpenCC(s2twp)로 실제 변환한 결과입니다.
사용 방법
- zh-CN.json 같은 언어 팩을 페이지에 끌어다 놓거나 ‘파일 선택’을 누릅니다. 여러 언어 팩을 한 번에 골라도 됩니다.
- ‘방향’은 ‘간체→번체’, ‘표준’은 ‘대만’이나 ‘홍콩’을 고르고 ‘지역 어휘 변환’을 켭니다. 화면 문구가 그 지역 표현으로 바뀝니다.
- 카드의 변환 개수와 미리보기를 확인합니다. 올바르지 않은 JSON은 따로 표시됩니다.
- 파일을 받습니다. 기본으로 언어 코드가 붙어 messages.zh-CN.json → messages.zh-Hant-TW.json처럼 바뀝니다.
주의할 점
- 지역 어휘는 사전대로 바꿀 뿐 뜻을 헤아리지는 않습니다. ‘대만’ 표준의 文件 → 檔案 변환은 공문서를 뜻할 때도 똑같이 적용되고, 点击保存(클릭해 저장) → 點選儲存처럼 버튼 문구의 동사도 바뀝니다. 화면 문구를 공개하기 전에 그 지역 표현에 익숙한 사람에게 한 번 검토받으세요.
- 문자열 값은 통째로 변환합니다. 값 안에 /分类/软件 같은 중국어 경로나 URL이 있으면 함께 바뀌니 이런 필드는 주의하세요.
- 자리표시자 가운데 {name}, %s 같은 ASCII 자리표시자는 바뀌지 않지만, 중국어로 쓴 자리표시자는 바뀝니다.
자주 묻는 질문
키 이름도 바뀌나요?
기본으로는 바뀌지 않습니다. 프로그램이 키 이름으로 문구를 찾기 때문에, 키 이름이 바뀌면 문구를 찾지 못합니다. 중국어 키 이름도 바꿔야 한다면 고급 옵션에서 ‘JSON: 키 이름도 변환’을 켜세요.
\u 이스케이프로 쓴 중국어도 바뀌나요?
바뀝니다. 이스케이프를 풀어 변환한 뒤, 바뀐 문자열은 UTF-8 글자로 직접 쓰고 바뀌지 않은 문자열은 원래 표기를 그대로 둡니다.
파일 형식이 다시 정리되나요?
아닙니다. 들여쓰기, 공백, 줄바꿈, 키 순서가 모두 그대로이고 바뀌지 않은 부분은 바이트 그대로이므로, Git으로 비교하면 바뀐 문구만 보입니다.
주석이 들어간 JSON은 어떻게 하나요?
주석이나 끝 쉼표가 있는 파일은 올바른 JSON이 아니어서 카드에 ‘올바른 JSON이 아니어서 변환하지 않음’이 표시됩니다. 이때 ‘일반 텍스트로 변환’을 누를 수 있지만, 키 이름 속 중국어도 함께 바뀝니다.
간체 언어 팩으로 홍콩판을 만들려면요?
‘간체→번체’와 ‘홍콩’을 고르고 ‘지역 어휘 변환’을 켭니다. OpenCC의 홍콩 어휘는 몇몇 단어만 바꿉니다. 鼠标 → 滑鼠처럼 바뀌고, 软件 단어는 홍콩에서 흔히 쓰는 軟件 형태가 됩니다.