파일 형식

애플리케이션에 필요한 구조는 그대로 유지하면서 텍스트를 번역할 파일 처리기를 찾아보세요.

로캘 파일에는 단어만 있는 것이 아닙니다. 키는 메시지와 코드를 연결하고, 자리표시자는 애플리케이션 값을 받아들이며, 파일 구조는 프레임워크가 결과를 불러오는 방식을 결정합니다. 문서에는 제목, 링크, 예제, 메타데이터도 담깁니다. 파일을 번역할 때는 이러한 연결을 유지하면서 언어를 바꿔야 합니다.

Lingo.dev 형식 처리기는 번역할 텍스트를 선택하고 결과를 재구성합니다. 파일의 용도에 맞는 처리기를 선택하세요. Rails 카탈로그와 오픈에이피아이 명세는 모두 확장자가 .yml일 수 있지만, 문자열을 모두 번역하면 각각 다른 문제가 생깁니다. Rails 로캘 루트는 바꿔야 하지만, 애플리케이션 프로그래밍 인터페이스의 작업 식별자는 그대로 유지해야 합니다.

파일 형식 찾기 #

원본처리기 종류레퍼런스
중첩 구조의 제이슨 카탈로그json제이슨
맥락 주석이 있는 제이슨jsonc제이슨시
야믈 카탈로그yaml야믈
로캘 루트가 하나인 야믈yaml-root-key로캘 루트 야믈
정적 타입스크립트 로캘 모듈typescript타입스크립트
정적 피에이치피 로캘 배열php피에이치피
마크다운 문서md마크다운
제이에스엑스 컴포넌트가 있는 마크다운mdx엠디엑스
마크독 문서markdoc마크독
오픈에이피아이 3 계열 야믈yaml-openapi오픈에이피아이
안드로이드 리소스 엑스엠엘android안드로이드
Flutter 애플리케이션 리소스 번들flutterFlutter 에이알비
애플 문자열 테이블xcode-strings애플 스트링스
애플 복수형 리소스 속성 목록xcode-stringsdict애플 스트링스딕트
애플 다중 로캘 카탈로그xcode-xcstrings애플 문자열 카탈로그
겟텍스트 피오 카탈로그po겟텍스트
엑스리프 교환 문서xliff엑스리프
서브립 자막srt서브립
줄 단위로 번역하는 일반 텍스트txt일반 텍스트
에이치티엠엘 문서 또는 조각html에이치티엠엘
로캘마다 열을 하나씩 둔 CSV 표csvCSV
자바 속성 리소스 번들properties자바 속성
Payload 콘텐츠 관리 시스템에서 선택한 필드payloadPayload

레퍼런스 문서에서는 기존 파일 처리기와 각 처리기의 추출 및 재구성 한계를 설명합니다. CLI 및 GitHub App에서는 위에 나열된 22가지 설정된 유형 중 Payload를 제외한 유형을 사용할 수 있습니다. 에이치티엠엘 형식은 .html 및 .htm를 바탕으로 판별합니다. 출력 시 수정되지 않은 원본은 그대로 보존하고, 명시적으로 선언된 <html> 요소의 lang 값을 대상 로캘로 설정합니다. 저장소 설정에서 사용할 야믈 변형이나 안드로이드 형식을 명시적으로 선택하세요. 시에스브이는 애플 문자열 카탈로그와 마찬가지로 모든 로캘을 원본 파일에 유지합니다. CLI 빠른 시작에서는 파일 하나로 설정부터 결과 파일 받기까지 안내하며, GitHub에서는 관리형 저장소 워크플로를 다룹니다.

현재 제공되는 공급자 연결은 각자의 연동 규약에 따라 콘텐츠를 선택하고 기록합니다.

구조화된 데이터를 직접 번역하려면 인라인 제이슨을 제출하세요. 원본 파일을 업로드하고 형식을 유지하려면 파일 문서의 안내를 따르세요. 두 방식 모두 번역 작업의 수명 주기는 동일합니다.

번역본과 해당 원본 리비전을 함께 보관하기 #

증분 파일 번역은 현재 원본과 이전 원본을 비교하고, 이전 원본에 대응하는 기존 번역본을 사용합니다. 이 입력들을 함께 활용하면 변경되지 않은 메시지는 승인된 표현을 유지하고, 새로 추가되거나 변경된 메시지는 번역할 수 있습니다.

키가 있어야 이러한 비교가 제 역할을 합니다. checkout.title 및 account.title에 동일한 영어 텍스트가 들어 있어도 서로 다른 번역을 유지할 수 있습니다. 배열 위치, 자막 큐 번호, 일반 텍스트의 줄 위치, 문서 구조도 대응 항목을 찾는 기준이 됩니다. 항목을 이동하거나 번역된 문서의 구조를 바꾸면 대응 관계가 달라질 수 있으므로, 번역본은 생성에 사용한 원본 리비전과 짝지어 보관하세요.

대부분의 형식은 대상 로캘마다 별도의 파일을 생성합니다. 반면 애플 문자열 카탈로그는 여러 로캘을 원본 파일에 병합합니다. Payload 결과물이나 문자열 카탈로그에는 일부 대상 값만 있고 나머지는 누락되어 있을 수도 있습니다. 파일의 존재 여부만 보지 말고 실제 대상 항목을 검토하세요.

텍스트 선택과 출력을 별도로 제어하기 #

텍스트를 번역에서 제외한다는 말은 여러 의미로 쓰일 수 있습니다. 잠긴 카탈로그 값은 원본에서 가져오고, 보존되는 값은 기존 번역본에서 가져오며, 무시되는 값은 출력에서 빠질 수 있습니다. 사용할 수 있는 제어 방식은 형식과 호출 인터페이스에 따라 달라집니다.

제이슨과 제이슨시, 야믈, 로캘 루트 야믈, 피에이치피, 타입스크립트에는 CLI 키 범위를 사용하세요. 부분 업데이트를 하면 선택 범위 밖의 기존 번역 표현은 유지되지만, 원본에만 있는 항목과 배열 위치를 처리하는 방식은 형식에 따라 다릅니다. 해당 형식의 레퍼런스를 참고해 전체 결과를 확인하세요.

맥락 메타데이터의 동작 방식도 유형에 따라 다릅니다. 제이슨시의 @context 주석은 바로 다음 문자열 값을 설명합니다. 에이알비의 @message.description는 해당 메시지를 설명합니다. 겟텍스트의 msgctxt는 메시지를 구분하고 맥락을 제공합니다. 일반 주석은 번역 지침으로 쓰이지 않더라도 재구성 과정에서 유지될 수 있습니다. 리액트의 @src 및 @orphan 주석은 카탈로그 유지 관리 워크플로에 속합니다.

파일을 가져온 뒤에는 실제로 해당 파일을 사용하는 시스템에서 불러오세요. 번역의 의미뿐 아니라 선택된 로캘, 변수, 복수형, 링크, 보호된 데이터도 함께 확인하세요. 애플리케이션 가이드에서는 웹 앱, 네이티브 리소스, 정적 콘텐츠별로 이 작업을 마무리하는 방법을 안내합니다.