YAML
카탈로그 키는 그대로 두고 중첩된 YAML 문자열 값을 번역하세요. 루트나 스키마에 특별한 의미가 있다면 다른 핸들러를 선택하세요.
yaml 파일 핸들러는 중첩된 매핑과 시퀀스의 문자열 값을 번역합니다. 애플리케이션 코드가 조회에 사용하는 키와 숫자, 불리언 값은 그대로 유지합니다. 로캘이 달라져도 구조가 같은 카탈로그에 사용하세요.
일반 YAML이 적합한지 판단하기 #
예를 들어 다음 카탈로그는 로캘 래퍼 없이 결제 메시지를 묶어 둡니다.
checkout:
title: Complete your order
steps:
- Review your items
- Confirm delivery
retries: 3핸들러는 checkout.title과 시퀀스의 문자열 두 개를 모두 선택합니다. retries는 숫자로 유지됩니다. 따옴표로 감싼 식별자도 문자열이므로 선택됩니다. 카탈로그에 넣을 데이터를 정할 때 이 차이를 고려하세요.
대상 로캘로 바꿔야 하는 Rails 방식의 en: 래퍼에는 로캘 루트 YAML을 사용하세요. 일반 YAML은 파일 이름이 es.yml로 바뀌어도 en:을 그대로 유지합니다. 이 경우 루트가 여전히 영어를 가리키므로 Rails에서 해당 내용을 무시할 수 있습니다.
API 명세에는 OpenAPI를 사용하세요. 일반 YAML은 문자열 값인 작업 식별자, 참조, 예제까지 선택합니다. .yml 확장자만으로는 이러한 용도를 구분할 수 없습니다.
재사용과 재구성 #
출력 트리는 현재 원본을 기준으로 구성됩니다. 이전 원본은 각 문자열 경로의 변경 여부를 판단하는 기준이 되고, 기존 대상은 일치하는 경로의 값을 제공합니다. 변경된 문자열은 새 번역으로 교체됩니다. 변경되지 않은 문자열은 키나 용어 범위에 따라 선택되더라도 기존 번역을 유지할 수 있습니다.
CLI는 --key에 저장된 기준본을 제공하므로, 이 선택만으로는 변경되지 않은 YAML 문구가 반드시 다시 생성되지는 않습니다. 같은 명령에 --force를 추가해도 마찬가지입니다. 원하는 대로 정확히 수정하려면 대상을 직접 편집하세요. 다시 생성하려면 승인된 대상을 저장한 다음, 범위를 지정한 전체 파일 --force을 --key 없이 사용하세요. 교체 후에는 파일 전체를 검토하세요.
재구성 과정에서는 YAML 구문 트리를 사용해 주석과 앵커 구조를 유지하면서 값을 교체합니다. 직렬화 과정에서 서식이 정규화될 수 있습니다. 주석은 번역 지침이 아니라 문서의 일부로 남습니다. YAML을 읽어 사용하는 도구에서 별칭을 확인하세요. 특히 하나의 값이 여러 참조를 통해 나타나는 경우에는 주의가 필요합니다.
키로 범위를 지정해 실행할 때, 대상 값이 없으면 범위 밖의 미해결 매핑 문자열이 누락될 수 있습니다. 시퀀스 문자열은 위치가 밀리지 않도록 원본 값을 유지합니다. 따라서 일부 범위만 처리한 결과로는 파일의 모든 문자열이 번역되었다고 볼 수 없습니다.
카탈로그 설정 및 불러오기 #
CLI 설정에서 .yaml 또는 .yml 원본에 사용할 format: "yaml"을 명시적으로 설정하세요. 푸시할 파일을 탐색할 때는 형식이 명시되지 않은 YAML 파일이 제외됩니다. GitHub App은 자체 저장소 선택 방식을 사용합니다.
대상 경로를 애플리케이션의 로더에 맞추세요. config/locales/checkout.en.yml과 같은 원본과 locales/en/checkout.yml에 있는 원본은 경로를 도출하는 방식이 서로 달라야 합니다. 시퀀스 내 위치도 메시지를 식별하는 기준이므로, 항목을 이동하면 연결되는 기존 번역이 달라질 수 있습니다. 구조를 수정한 뒤에는 불러온 카탈로그를 점검하세요. Rails의 조회, 로캘 선택, 대체 처리에 대해서는 로캘 루트 핸들러와 함께 Rails 앱 현지화를 참고하세요.