국제화된 프로젝트에는 작업 영역 내에 두 개의 섹션이 있습니다.국제화이 섹션은 작업 영역에 위치합니다.글로벌 대응력이는 이미 존재하는 코드와 관련이 있습니다.문화이는 귀사가 진출한 시장과 관련이 있습니다.글로벌화 검사이 검사는 글로벌 대응력에서 발견된 문제가 새 코드에 추가되는 것을 방지합니다.
글로벌 대응력
글로벌 대응력은 기본 브랜치에 있는 코드가 여전히 특정 언어나 문화에 대해 가정하는 내용을 목록으로 나타냅니다. Coroid는 글로벌화 검사가 변경 사항에 적용하는 동일한 규칙으로 코드를 분석하여 발견된 모든 항목을 보고합니다. 여기서 차단되는 사항은 없으며, 이는 기존 코드이므로 사용자가 원하는 속도로 수정할 수 있습니다.
- 월드 리디네스특정 언어를 전제로 하는 코드
- 문화각 시장이 기대하는 내용
- 개요각 언어의 현재 상태를 확인할 수 있습니다.
- 문자열모든 언어의 모든 문자열을 확인할 수 있습니다.
- 제안 사항결정을 기다리는 내용들입니다.
- 교환다른 도구용 파일
- 기여자용어 제안을 할 수 있는 사람들을 확인하세요.
- 자동화야간 및 병합 시 자동 처리 내용을 확인하세요.
- 설정언어, 접근 권한 및 비용 관련 설정을 조정할 수 있습니다.
기본 브랜치의 코드가 여전히 특정 언어나 문화를 전제로 하는 부분을 식별하세요. 소규모 작업으로 이를 수정하며, 글로벌화 검사 기능이 신규 코드가 추가로 그러한 문제를 유발하지 않도록 방지합니다.
검증 완료: 3f2c9a1 2시간 전
- 코드에 직접 작성된 텍스트기본적으로 새 코드에서 차단됨사람들이 읽는 텍스트가 카탈로그 대신 코드에 직접 작성되어 있습니다.142-9수정 작업 생성하기
- 부분들로 조합된 문장기본적으로 새 코드에서 차단됨문장이 여러 부분으로 연결되어 있습니다. 언어마다 단어 순서가 다르기 때문입니다.23-3
- 로케일을 반영하지 않은 숫자 형식읽는 사람의 로케일을 반영하지 않은 숫자 형식입니다.31-4
- 수동으로 연결된 목록사람들이 읽는 목록이 쉼표나 "and"로 연결되어 있으며, 다른 언어에서는 이와 다르게 표기됩니다.12-2
- 단어가 조합되는 동안 입력 처리중국어, 일본어 또는 한국어 단어를 선택하기 전에 Enter 키를 눌러 폼을 제출합니다.6
- src/components/checkout/summary.tsx코드에 직접 작성된 텍스트: 18 · 로케일을 반영하지 않은 숫자 형식: 418
- 42:9
주문 요약
- 57:13
모든 주문에 무료 배송
- 61:11
코드 적용하기
- 42:9
- src/app/account/page.tsx코드에 직접 작성된 텍스트: 11 · 부분들로 조합된 문장: 211
- src/components/cart/empty-state.tsx코드에 직접 작성된 텍스트: 77
워크벤치 내의 월드 리디네스: 기본 브랜치의 코드가 특정 언어나 문화를 전제로 하는 부분을 문제 코드별로 표시하며, 수정할 파일과 수정 작업을 안내합니다. 설명용 데이터입니다.
이 섹션에는 다음 내용이 표시됩니다:
- 발견 사항, 읽힌 파일 수와 마지막 검사 이후의 변경 사항이 함께 표시됩니다.
- 발견된 항목: 발견 유형별로 한 행씩 표시되며 각각의 개수도 함께 나타납니다. 코드에 직접 작성된 텍스트와 부분적으로 구성된 문장은새 코드에서 기본적으로 차단됨으로 표시되는데, 이는 글로벌화 검사에서 해당 항목을 추가하는 변경 사항을 반환하기 때문입니다.
- 파일: 발견된 항목이 가장 많은 파일부터 순서대로 표시됩니다. 특정 유형을 선택하면 해당 유형의 파일만, 파일을 선택하면 각 발견 항목의 줄 번호와 텍스트 내용을 확인할 수 있습니다.
글로벌 대응력을 열었을 때 기본 브랜치의 코드가 마지막 검사 이후 변경된 경우, Coroid가 다시 검사를 수행합니다.다시 검사하기를 클릭하면 즉시 검사가 진행됩니다. 발견 항목이 20,000개를 초과하는 프로젝트의 경우 처음 20,000개만 목록에 표시되며, 개수는 모든 발견 항목을 포함합니다.
발견 유형과 각각의 수정 방법은모든 시장을 위한 디자인. 의도적으로 제외한 코드는i18n-ignore주석에 그 이유를 기재하며, 전체 폴더는 설정 파일에서 제외할 수도 있습니다(자세한 내용은검사에서 읽는 내용).
수정 작업 생성
소유자와 관리자는수정 작업 생성하기를 발견 유형별로 선택합니다. Coroid는 해당 유형에 맞는 수정할 파일과 줄 번호, 수정 방법을 포함한 작업을 하나 생성합니다. 작업에는 최대 15개의 파일 또는 150개의 발견 항목만 포함되며, 가장 심각한 문제가 있는 파일부터 우선적으로 처리되어 검토가 용이합니다. 작업이 병합되면 다음 검사에서 남은 항목이 표시됩니다.
작업은 시작될 때까지 대기합니다. 작업이 진행 중일 때 다시 요청해도 동일한 작업이 열립니다. 해당 행에는 수정 작업의 진행 상태, 완료 여부 또는 중단 여부가 표시됩니다.
문화
문화 섹션에서는 프로젝트가 진출한 각 시장에서 날짜·숫자·통화·주소·전화번호·이름 등에 대해 기대하는 사항을 확인할 수 있습니다. 이 정보는 공개된 데이터를 기반으로 제공됩니다. 형식, 달력, 단위, 용지 크기는 Unicode CLDR에서, 주소와 우편번호는 Google의 주소 데이터에서, 전화번호는 libphonenumber에서 가져옵니다. 읽기 환경의 로케일을 기준으로 형식을 지정하는 코드는 대부분 이 정보를 자동으로 올바르게 적용합니다.
- 월드 리디네스특정 언어를 전제로 하는 코드
- 문화각 시장이 기대하는 내용
- 개요각 언어의 현재 상태를 확인할 수 있습니다.
- 문자열모든 언어의 모든 문자열을 확인할 수 있습니다.
- 제안 사항결정을 기다리는 내용들입니다.
- 교환다른 도구용 파일
- 기여자용어 제안을 할 수 있는 사람들을 확인하세요.
- 자동화야간 및 병합 시 자동 처리 내용을 확인하세요.
- 설정언어, 접근 권한 및 비용 관련 설정을 조정할 수 있습니다.
각 시장에서 요구하는 날짜, 숫자, 통화, 주소, 전화번호 및 이름 표기 방식은 Unicode CLDR과 우편 서비스에서 제공하는 주소 데이터를 기준으로 결정됩니다. 사용자의 로케일에 맞게 형식을 지정하는 코드는 이러한 규칙을 자동으로 올바르게 적용합니다.
- 포매터
- next-intl의 포매터
useFormatter from next-intl - 시장별 금액
- 독일어: EUR · 일본어: JPY · 아랍어: SAR · 스웨덴어: SEK
| 시장 | 숫자 | 금액 | 날짜 | 시간 | 주간 시작일 | 인쇄 용지 |
|---|---|---|---|---|---|---|
| 영어en-US · 원본 | 12,345.678 | $1,299.50 | 3/14/26 | 4:05 PM | 일 | Letter |
| 독일어de-DE | 12.345,678 | 1.299,50 € | 14.03.26 | 16:05 | 월 | A4 |
| 일본어ja-JP | 12,345.678 | ￥1,300 | 2026/03/14 | 16:05 | 일 | A4 |
| 아랍어ar-SA | ١٢٬٣٤٥٫٦٧٨ | ١٬٢٩٩٫٥٠ ر.س. | ١٤/٣/٢٠٢٦ | ٤:٠٥ م | 일 | A4 |
| 스웨덴어sv-SE | 12 345,678 | 1 299,50 kr | 2026-03-14 | 16:05 | 월 | A4 |
출처: 유니코드 CLDR 48, 구글의 주소 데이터(libaddressinput) 및 libphonenumber. 샘플에서는 모든 시장에서 동일한 순간과 금액을 사용합니다.
워크벤치 내의 문화: 각 시장은 숫자, 가격, 날짜 및 시간을 자체 방식으로 표기하며, 주간 시작일과 인쇄 용지도 다릅니다. 값은 사용자의 브라우저와 유니코드 CLDR에서 가져옵니다.
상단에는:
- 포맷터.코드가 읽는 사람의 환경에 맞게 숫자·날짜·통화를 형식화하는 방식으로, 예로 next-intl의 포맷터, react-intl, i18next의 형식화 기능, Angular의 파이프 또는 일반적인
Intl이 있습니다. 포맷터가 없으면 에이전트가Intl와 읽는 사람의 로케일을 기준으로 형식화합니다. - 시장별 통화.각 시장에서 사용하는 통화로, 각 시장은 해당 지역의 고유 통화로 시작됩니다.
시장에서는 모든 시장의 숫자·통화·날짜·시간·주 시작 요일·도로 거리·용지 크기를 나란히 비교할 수 있습니다. 모든 값은 동일한 시점과 금액을 기준으로 합니다. 원본 시장과 다른 값은 굵은 글씨로 표시됩니다.
특정 시장을 열면 더 자세한 정보를 확인할 수 있습니다:
| 그룹 | 표시 내용 |
|---|---|
| 달력 및 시간 | 사용되는 달력과 각 달력에서의 동일한 날짜, 12시간제/24시간제, 주 시작 요일, 주말, 주 번호 매기기 방식 |
| 숫자 및 통화 | 숫자 자릿수, 숫자 값, 백분율 및 가격 |
| 측정 단위 및 용지 | 미터법, 미국 관용 단위 또는 둘 다; 도로 거리, 온도, 신장·체중; A4 또는 Letter 용지 |
| 사람 및 텍스트 | 성씨가 먼저 오는지 여부, 국내용 및 국제용 전화번호 형태, 예시가 포함된 우편번호, 텍스트 방향, 목록 연결 방식 및 정렬 방식 |
| 주소 | 해당 시장의 우편물에 기재되는 주소 형식으로, 해당 시장에서 다른 문자를 사용할 경우 라틴 문자로 표기되며 필수 항목이나 대문자로 작성되는 필드와 각 필드의 명칭도 함께 확인할 수 있습니다. |
마법사의 문화 단계에서 포맷터와 시장별 통화를 변경할 수 있습니다.문화(마법사에서 변경하기). 선택한 내용은 설정 파일에world.formatter및world.currencies및 CLI 1.14.0 이상이 필요하며, 마법사가 기존 핀을 이동시킵니다.
에이전트에게 전달되는 지침
국제화 프로젝트를 수행하는 개발자 에이전트는 포매터를 제공받으며, 각 시장별로 소스 시장과 다른 항목인 통화, 달력, 숫자 표기법, 시계, 주 시작일 및 주말, 용지 규격, 단위, 이름 순서, 텍스트 방향 및 우편번호만을 처리합니다. 또한 우편번호와 전화번호는 텍스트 형태로 유지하고, 전화번호는 E.164 형식으로 저장하며, 해당 시장에서 이름을 분리해야 하는 경우를 제외하고는 이름을 하나의 필드에 입력하고, 유효성 검증 시 모든 스크립트를 허용하도록 지침을 받습니다.