프로젝트의 국제화 작업 수행

국제화 마법사는 프로젝트를 다국어로 만듭니다. 이 마법사는 사용자의 저장소를 읽고 발견한 내용을 바탕으로 모든 단계를 시작하며, 결국 하나의 작업을 통해 pull request를 열게 됩니다. 언어 코드를 직접 입력하거나 JSON을 편집할 필요가 없으며, 원하는 항목만 변경하면 되고 병합하기 전까지는 저장소에 아무런 변화도 일어나지 않습니다.

소유자와 관리자는 마법사를 실행할 수 있습니다. 다음 위치에서 시작하세요:현지화: 선택하세요프로젝트 국제화하기, 또는마법사 시작하기프로젝트 행에서 해당 작업을 수행할 수 있습니다. 이미 다국어로 설정된 프로젝트의 경우,설정 → 언어 변경하기동일한 마법사를 열어 변경 사항을 제안합니다.

단계별 안내#

1. 스캔#

Coroid는 코드를 실행하지 않고 기본 브랜치를 읽습니다. 카탈로그와 그에 포함된 언어, 사용 중인 프레임워크, 그리고 코드에 직접 작성된 텍스트를 파일별로 확인합니다.

• 카탈로그를 발견했습니다.마법사는 이를 유지합니다: Coroid가 검증 절차를 추가하고 누락된 내용을 번역합니다. 이 과정을 '적용'이라고 합니다.
• **아직 카탈로그가 없습니다.**Coroid가 코드 내의 텍스트를 카탈로그로 옮기고 조회 함수로 대체합니다. 이를 '도입'이라고 합니다.
• 이미 설정되어 있습니다.해당 프로젝트에는 이미 Coroid 설정이 존재하며, 마법사는 이를 수정할 것을 제안합니다.

2. 소스 언어#

제품이 작성된 언어로, 다른 모든 언어는 이 언어를 기준으로 번역됩니다. 마법사는 카탈로그에서 이 언어를 감지하거나 코드 내의 텍스트를 바탕으로 추측합니다. 어떤 언어든 소스 언어가 될 수 있으며, 스웨덴어 제품을 영어와 독일어로 번역하는 경우에도 동일하게 적용됩니다.

3. 언어#

언어를 하나씩 선택하거나 한 번에 특정 시장의 언어를 추가할 수 있습니다:사용 인구가 가장 많은 언어, 유럽, 북유럽, 동아시아, 아메리카또는오른쪽에서 왼쪽으로 쓰이는 언어. 각 언어는 해당 언어명, 오른쪽에서 왼쪽으로 쓰이는지 여부, 그리고 필요한 복수형의 개수를 표시합니다.

지역별 변형은 번역 대신 파생시킬 수 있습니다. 영국식 영어는 미국식 영어를 바탕으로 영국 철자법을 적용한 것이며, 스위스 독일어도 독일어를 바탕으로 스위스 철자법을 적용한 것으로, 이 경우 추가 비용이 들지 않고 상위 언어와 일치하게 유지됩니다.

4. 문자열#

적용하는 경우, Coroid가 번역을 유지할 카탈로그를 선택하며 키와 구조는 그대로 유지됩니다. 도입하는 경우, Coroid가 텍스트를 카탈로그로 옮길 파일을 선택하며 제외된 파일은 변경되지 않습니다.

5. 스타일 및 용어#

모두 선택 사항이며 모든 언어에 적용됩니다:

• 격식 있는 표현 또는 비격식적인 표현.독일어처럼 독자에게 격식 있거나 비격식적으로 접근하는 언어의 경우Sie와du. 기본적으로 각 표현은 소스 텍스트의 어조를 따릅니다.
• 원문 그대로 유지되는 용어.모든 언어에서 동일하게 사용되는 제품명, 브랜드명, 기능명입니다.
• 제품에 대한 설명.제품과 그 이용자에 관한 몇 가지 문장으로, 번역 시 적절한 단어를 선택하는 데 도움을 줍니다.

6. 품질 및 자동화#

기본적으로 모두 활성화되어 있으며 나중에 개별적으로 변경할 수 있습니다:

• 변경 사항마다 번역 내용을 확인합니다.품질 관리의 '번역 확인' 기능은 문자열이 누락되거나 손상된 경우 변경 사항을 다시 보냅니다.
• Coroid 외부에서 병합된 문자열을 번역합니다.누군가 Coroid를 거치지 않고 새 텍스트를 병합하면, 해당 텍스트를 번역하는 작업이 생성됩니다.
• 매일 밤 수정 사항을 적용합니다.기여자가 제안한 승인된 내용은 매일 밤 하나의 pull request로 반영됩니다.
• 초대된 사용자가 표현 방식을 제안할 수 있도록 허용합니다.초대된 원어민 사용자가 사이트에서 직접 번역을 수정할 수 있습니다. 다음을 참고하세요: 제안 기능을 이용한 번역 관리하기.

설정 파일에는 마지막에 적용된 구성 내용이 저장됩니다. Coroid는 pull request이 병합된 후 소유자나 관리자가 현지화 메뉴를 열 때 해당 설정을 한 번만 적용합니다. 나중에 설정을 껐다가 다시 켜도 이전에 껐던 상태가 유지됩니다.

7. 리뷰#

프로젝트 요약, 작업의 수행 내용, 소스 언어, 대상 언어 및 파생 언어, 번역 분량, 원문 그대로 유지되는 용어, 병합 후 활성화될 기능 등이 표시됩니다. 번역 비용은 다른 에이전트 작업과 마찬가지로 모델 사용량으로 청구되며 작업별로 한도가 정해져 있습니다.

다음을 선택하세요:국제화하기. Coroid는 사양서와 수용 기준을 포함한 하나의 작업을 생성하고 즉시 시작합니다.

작업의 수행 내용#

• 적용하기마법사가 작성한 대로 구성 파일을 그대로 작성한 뒤, 누락된 문자열을 모두 번역합니다.
• 소개프레임워크를 연결하고 선택한 파일의 텍스트를 카탈로그로 옮긴 뒤, 언어 라우팅, 폴백 및 오른쪽에서 왼쪽으로 표시 기능을 추가한 다음 번역을 진행합니다.
• 변경하기새로운 구성을 작성하고 변경으로 인해 영향을 받는 번역 내용을 복구합니다.

이 작업은 하나의 pull request에서 완료됩니다. 이 항목이 기본 브랜치에 병합되면 모든 언어가 현지화에 표시됩니다.

형식#

Coroid는 다음 형식의 카탈로그를 읽습니다:

구성 파일#

마법사가 작성하는.coroid/i18n.json. 이 파일은 저장소 구조를 기술하며 저장소 내에 위치하고 풀 요청을 통해 변경됩니다:

{
  "version": 1,
  "cli": { "version": "1.9.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "derivedLocales": [
    { "locale": "en-GB", "from": "en", "rules": "en-gb-spelling" }
  ],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "protectedTerms": ["Storefront"],
  "localeInstructions": {
    "de": "Address the reader informally (du)."
  }
}

• cli엔진의 정확한 버전과 체크섬을 지정합니다. Coroid는 매 실행 전에 해당 버전을 다운로드하여 검증하므로 업데이트로 인해 예기치 않게 출력 결과가 바뀌는 일이 없습니다.
• derivedLocales규칙에 따라 생성되는 지역별 변형 목록을 표시합니다.
• protectedTerms및localeInstructions에는 사용자가 선택한 내용이 저장됩니다. 스타일 및 용어.

이 파일에는 용어집, 제품 컨텍스트, 언어별 번역 경로 및 기여자를 위한 제안 바인딩 정보도 포함될 수 있습니다.

설정 → 구성 파일워크벤치에서 기본 브랜치의 정확한 파일 내용을 확인할 수 있습니다. 해당 파일을 변경하려면 제안서를 편집한 뒤변경 제안: Coroid는 해당 파일을 적용하고 변경으로 인해 영향을 받는 번역 내용을 복구하는 작업을 생성합니다. 언어 및 스타일 설정의 경우 마법사를 이용하는 것이 더 간편합니다.

관련 항목#

• 현지화
• 제안 기능을 활용한 번역 관리
• 사양