현지화

Coroid는 자사에서 사용하는 동일한 엔진으로 귀사의 제품을 현지화합니다. 이 엔진은 총 13개 언어를 지원합니다. 귀사의 카탈로그 파일은 그대로 저장소에 보관되며, 변경 사항이 발생할 때마다 해당 내용은 작업 및 pull request으로 전달됩니다. 새로 추가되거나 변경된 문자열, 또는 오류가 있는 문자열만 모델로 전송됩니다.

현지화 메뉴는 메인 메뉴 내에 별도로 위치해 있습니다. 이 메뉴에서는 각 프로젝트가 지원하는 언어를 한 페이지에 표시하며, 각 프로젝트별로 전용 작업 공간을 제공합니다. 아직 다국어를 지원하지 않는 프로젝트는 다음과 같이 시작됩니다.다국어화 마법사.

모든 프로젝트를 한 페이지에 표시#

현지화 페이지는 읽을 수 있는 프로젝트부터 표시합니다. 각 행에는 프로젝트의 소스 언어, 지원하는 언어 수, 문자열 수가 나타나며, 모든 언어에서 번역된 비율을 나타내는 막대가 함께 표시됩니다.

각 프로젝트 옆에 있는 작은 지구본 아이콘에는 언어별로 구슬이 표시됩니다. 언어 번역이 완료되면 녹색으로, 문자열이 누락되거나 변경된 경우 청록색 링으로, 일부 문자열에 오류가 있으면 호박색으로 표시됩니다.

번역이 진행되지 않은 프로젝트에는 다음과 같이 표시됩니다.아직 다국어화되지 않음. 소유자와 관리자는 해당 행에서 또는프로젝트 다국어화하기페이지 상단에서 마법사를 시작할 수 있습니다.

작업 공간#

프로젝트를 열면 작업 공간이 나타납니다. 왼쪽에는 섹션들이 있고, 그 옆에는 현재 열려 있는 섹션이 표시됩니다.

제안 사항, 기여자 및 자동화 기능에 대해서는 다음에서 자세히 설명합니다.제안 사항을 활용한 번역 유지 관리.

작업 공간은 기본 브랜치에 있는 카탈로그를 읽어옵니다. 카탈로그가 변경되면 다음에 프로젝트를 열 때 Coroid가 다시 해당 내용을 읽어오며, 그전까지는 개요에 '읽고 있는 중'이라고 표시됩니다. Coroid는 이 작업을 위해 귀사 저장소의 코드를 실행하지 않습니다. 커스텀 어댑터를 사용하는 카탈로그는 표시되지 않지만, 해당 문자열은 여전히 작업으로 처리됩니다.

개요: 언어별로 한 줄씩 표시#

개요에는 문자열 수, 언어 수, 번역된 비율, 작업이 필요한 문자열 수라는 네 가지 합계 값이 먼저 표시됩니다. 그 아래에는 각 언어별로 세 단계를 거치는 줄이 나타납니다:

1. 다국어화하기.해당 언어의 카탈로그가 생성되어 문자열을 포함하게 됩니다.
2. 현지화하기.모든 문자열이 현재 소스 텍스트를 기반으로 번역됩니다.
3. 확인하기.모든 문자열에 오류가 없어야 합니다. 즉, 모든 문자열이 올바르게 파싱되고 소스의 플레이스홀더가 그대로 유지되며 해당 언어에 필요한 복수형도 제대로 적용되어야 합니다.

언어의 다음 단계는 해당 줄이 멈춘 지점에 따라 결정됩니다. 녹색으로 멈춘 경우 완료된 상태이며, 청록색 링은 작업이 필요한 단계, 호박색은 오류가 있는 문자열이 있는 상태입니다.

“현지화” 아래에 있는 막대는 다음과 같이 표시됩니다.현지화막대는 처음부터 다음과 같이 색상으로 구분됩니다: 사람이 검토한 문자열은 짙은 녹색, 모델이 작성한 문자열은 연녹색, 주의가 필요한 문자열은 호박색, 누락된 문자열은 빈 공간으로 표시됩니다. 막대 아래의 텍스트에는 “42개 문자열이 누락됨”과 같은 정보가 나타나며, 해당 문자열들을 바로 열어볼 수 있습니다.42개 문자열이 누락됨, 그리고 해당 문자열들을 바로 열어볼 수 있습니다.

미국 영어를 기반으로 영국 영어와 같은 규칙에 따라 파생된 언어의 경우, 모든 문자열에 해당 규칙이 적용되면 다음과 같이 표시됩니다.파생된 언어이며 최신 상태해당 규칙이 모든 문자열에 적용된 경우에 표시됩니다.

누락된 문자열 번역하기#

소유자와 관리자는 개요 상단에 다음과 같은 작업 버튼을 확인할 수 있습니다.번역작업이 필요한 문자열 수(누락된 문자열, 소스에서 변경된 문자열, 오류가 있는 문자열)가 버튼에 함께 표시됩니다. 이 버튼을 클릭하면 작업 공간에서 두 단계에 걸쳐 문자열을 번역합니다:

1. 번역 메모리.조직 내 다른 프로젝트에서 동일한 소스 텍스트로 이미 번역된 문자열이 있을 경우, 해당 번역 내용을 재사용합니다. 사람이 작성한 번역이 모델의 번역보다 우선하며, 이 과정에서는 모델 호출이 이루어지지 않고 추가 비용도 발생하지 않습니다.
2. 번역기 모델.저장소에 저장된 엔진을 통해 나머지 문자열을 번역 게이트웨이를 거쳐 번역하며, 각 응답 결과를 플레이스홀더 및 복수형 기준에 맞춰 확인합니다.

번역이 진행되는 동안 합계 값 아래의 패널에는 작성된 문자열 수와 소요된 비용이 표시되며, 각 언어의 막대는 번역된 문자열이 들어올 때마다 줄무늬 형태로 채워집니다.번역 중단번역 중단 버튼을 누르면 진행이 종료되며, 이미 작성된 내용은 그대로 유지됩니다.

번역된 내용은 즉시 저장소로 전달되지 않고 다음 단계를 기다립니다.커밋다른 변경 사항과 함께 커밋하여 머신 번역으로 표시하고, 이를 확인할 수 있도록 합니다.문자열먼저 확인하세요. 이미 누군가 편집했거나 기여자가 제안한 문자열은 해당 사용자에게 할당됩니다.

문자열#

문자열모든 문자열의 원본 텍스트와 특정 언어로 된 값을 한눈에 보여주며, 이 화면은작업 필요: 누락되었거나 원본이 변경되었거나 오류가 있거나 원본과 동일한 문자열입니다. 다른 언어나 카탈로그를 선택하거나 키 및 텍스트로 검색할 수 있습니다.

문자열을 선택하면 모든 언어로 된 번역본을 확인할 수 있습니다. 플레이스홀더와 마크업은 잠긴 칩 형태로 표시되는데, 이는 번역 과정에서 그대로 유지되어야 하기 때문입니다. 선택한 언어의 경우 세부 정보에는 해당 값을 작성한 사람, 문제점, 복수형 메시지의 경우 해당 언어에 필요한 복수형까지 안내됩니다.

편집 후 커밋#

소유자와 관리자는문자열에서 번역을 수정할 수 있습니다. 문자열을 선택한 뒤편집을 클릭하여 원하는 언어로 편집한 뒤 변경 사항을 저장하세요. 편집기에는 원본의 플레이스홀더가 삽입 가능한 칩 형태로 표시되며, 입력하는 동안 플레이스홀더, 해당 언어에 필요한 복수형, 용어집에 등록된 용어, 길이 등을 실시간으로 확인할 수 있습니다. 저장 시 Coroid가 기본 브랜치와 비교하여 다시 한번 검토합니다.

제안편집기에서 해당 문자열에 대한 번역을 제안할 수 있습니다. 다른 프로젝트에 해당 번역본이 있다면 번역 메모리에서 가져오고, 그렇지 않으면 번역 모델을 활용합니다.이것 사용을 눌러 편집기에 적용하세요. 변경 사항을 저장하기 전까지는 아무것도 저장되지 않습니다.

저장된 변경 사항은 문자열 목록 아래에 있는 바에 표시되며, 여기서 각 항목을 검토하거나 취소할 수 있습니다.커밋커밋 기능은 승인된 기여자의 제안과 머신 번역을 포함한 모든 변경 사항을 하나의 작업으로 묶습니다. 이 작업은 지정된 엔진을 이용해 정확히 해당 값을 적용하고 pull request를 하나 열게 됩니다. 한 번의 커밋에는 최대 5,000개의 변경 사항만 포함되며 나머지는 다음 번에 처리됩니다. 해당 pull request가 병합되기 전까지는 문자열에커밋되지 않음또는적용 중.

커밋된 머신 번역은 엔진 캐시에 머신 번역으로 남아 있으므로 여전히머신으로 분류되며, 사람의 검토를 거쳐야 합니다.

편집 기능을 사용하려면 설정 파일에서 기여 허용 옵션을 활성화해야 합니다.국제화 마법사는 기본적으로 이 기능을 활성화합니다. 기여자도더 나은 표현을 제안할 수 있습니다자체 사이트에서도 이용할 수 있습니다.

파일 교환#

「교환」 메뉴에서 대행사나 번역 도구, 스프레드시트용 문자열을 다운로드한 뒤, 그들이 작성한 번역본을 다시 가져올 수 있습니다.

내보내기 기능을 이용하면 작업이 필요한 문자열이나 모든 문자열을 확인할 수 있습니다. 플레이스홀더와 복수형 메시지는 원본과 동일한 형태로 유지됩니다.

가져오기 작업을 수행하면 보존되기 전에 모든 행이 표시됩니다. 새 번역과 변경 사항은 수락될 수 있습니다. Coroid는 프로젝트에 없는 키, 소스에서 변경된 이후 생성된 번역, 잘못된 플레이스홀더, 해당 언어에 필요한 복수형 형태가 누락된 메시지를 제외합니다. 수락된 행은 커밋을 기다리는 변경 사항이 됩니다.커밋, 예를 들어 다음에서 수행된 편집 내용과 같습니다.문자열.

JSON와 .strings 파일, Android 파일은 포함된 언어를 명시하지 않습니다. Coroid는 파일 이름에서 언어 정보를 추출하거나, 사용자에게 요청합니다.storefront-de.json, 또는 요청합니다.

모든 변경 사항을 검사하기#

이번역품질 관리에서 실행되는 검사는 작업 QA와 풀 요청에서 변경된 문자열만 대상으로 합니다. 이 기능은 pull request가 병합되면 마법사가 기본적으로 활성화합니다.설정기능은 활성화 여부를 표시하고 품질 관리에서 해당 항목을 엽니다. 개요 페이지에서마지막 검사 결과 확인하기아래에 위치합니다.확인하기최신 검사 결과를 엽니다.

각 문제는 문제 코드가 포함된 발견 사항으로 처리됩니다:

검사 설정에서 어떤 코드를 차단할지 선택할 수 있습니다. 용어집, 길이 및 금지어 규칙은 구성 파일에 설정된 경우 각각 자체 코드를 보고합니다.

번역 발견 사항으로 인해 작업이 차단되면, 개발자 에이전트는 매번 동일한 방식으로 문제를 해결합니다. 즉, 해당 작업에 대한 번역 세션을 열고 변경된 문자열에 대해 엔진을 실행합니다. 타겟 카탈로그를 직접 편집하지는 않습니다.

번역기 모델#

번역 기능은 AI 프로필 내에서 별도의 역할로 지정됩니다.번역가, 아키텍트, 개발자, QA, 리뷰어와 함께 배치됩니다. 기본적으로 Hy-MT2 번역 모델을 사용하며, 조직 정책에서 허용하는 경우 GPT-6 Luna를 대체 모델로 적용합니다. 다른 역할과 마찬가지로 AI 프로필에서 이 매핑을 변경할 수 있습니다.

엔진은 또한 문자열을 크기별로 묶고, 모든 응답을 사용자의 플레이스홀더 및 복수형 규칙과 비교하여 검증하며, 실패한 문자열에 대해 재시도하거나 상위 단계로 전달합니다.

비용#

모든 요금제에서 번역 기능을 이용할 수 있습니다. 번역 요청은 Coroid의 번역 게이트웨이를 통해 전달되며, 에이전트 실행과 동일하게 조직의 모델 사용량으로 청구됩니다. 번역 작업도 다른 작업과 마찬가지로 요금제에 할당된 에이전트 시간에 포함됩니다.

기본 번역기 경로를 사용할 경우, 번역 비용은 언어당 1,000개 문자열당 약 2센트입니다. 2,000개 문자열로 구성된 카탈로그를 10개 언어로 번역하는 데 드는 비용은 약 $0.33입니다.

• 변경된 내용에 대해서만 비용이 발생합니다.엔진은 소스 텍스트를 기준으로 캐시를 유지하므로 변경되지 않은 문자열은 다시 전송되지 않습니다.
• 각 작업과 각 실행에는 번역 제한이 적용됩니다.작업의 세션은 기본적으로 $1의 지출 한도에 도달하면 중단됩니다.번역하기워크벤치에서의 실행은 $5 한도에서 중단됩니다. 프로젝트는설정 → 접근 및 지출.
• 번역 메모리는 무료로 제공됩니다.조직에서 이미 다른 곳에서 번역한 문자열은 모델 호출 없이 재사용됩니다.
• 읽기 작업에는 비용이 들지 않습니다.워크벤치와 번역 검사는 카탈로그를 읽기만 하며 모델 호출을 수행하지 않습니다.

Coroid 외부에서의 번역#

엔진은 명령줄 도구이며,coroid-i18n. 사용자의 CI 환경에서도 동일한 고정 버전을 자체 OpenRouter 키와 함께 실행할 수 있습니다. Coroid 내에서는 작업이 항상 번역 게이트웨이를 통해 처리되므로 지출 및 한도가 한곳에서 관리됩니다.

관련 항목#

• 프로젝트 국제화하기
• 제안 기능을 활용한 번역 관리하기
• 품질 정책 및 게이트 설정하기
• 검사, 실행 및 발견 사항 확인하기
• AI 프로필 관리하기