일반 텍스트

텍스트 파일을 한 줄씩 번역해 원문의 모든 줄을 번역문에서도 같은 위치에 유지합니다.

앱 스토어 설명이나 릴리스 노트 같은 일반 텍스트 파일에는 마크업이나 키가 없습니다. txt 파일 처리기는 각 줄을 개별적으로 번역해 원래 위치에 기록하므로, 번역문과 원문의 줄 수가 동일하게 유지됩니다.

줄과 번역 단위 #

예를 들면 다음과 같습니다.

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

텍스트가 있는 각 줄은 줄 번호를 키로 사용하는 하나의 번역 단위가 됩니다. 이 예에서는 1, 3, 4번째 줄이 번역됩니다. 빈 줄이나 공백 또는 탭만 있는 줄은 번역 단위로 처리하지 않고 그대로 복사합니다.

줄 앞뒤의 공백과 탭은 번역 단위에서 제외되므로, 번역 후에도 들여쓰기와 줄 끝 공백이 유지됩니다. 그 사이에 있는 텍스트만 번역합니다.

출력 재구성 #

출력 시 현재 원문의 각 줄에 있는 텍스트만 바꾸고, 나머지는 모두 바이트 단위까지 그대로 유지합니다. 빈 줄, 들여쓰기, 각 줄의 줄바꿈 형식(LF 또는 CRLF, 두 형식이 섞인 경우 포함), 파일 끝의 줄바꿈 유무까지 보존됩니다. 따라서 번역문과 원문의 줄 수는 동일합니다.

번역문 앞뒤의 공백과 줄바꿈은 제거하고, 번역문 안의 줄바꿈은 공백 하나로 바꿉니다. 따라서 번역으로 줄이 추가되는 일은 없습니다. 번역문이 비어 있으면 해당 로캘의 출력을 구성하지 못합니다.

번역 재사용 여부는 서브립 자막 구간과 마찬가지로, 줄의 텍스트가 바뀌지 않았는지와 파일 내 위치를 기준으로 결정합니다. 줄의 들여쓰기만 바꾸는 경우에는 다시 번역할 필요가 없습니다. 줄을 추가하거나 삭제하면 파일에서 같은 텍스트가 한 번만 나오는 줄은 기존 번역을 유지하고, 여러 번 나오는 줄은 다시 번역합니다. 번역문의 줄 수가 이전 원문과 다르면 재사용할 수 있는 텍스트가 없으므로, 이전 원문과 승인된 번역문을 짝으로 보관하세요.

텍스트 설정 및 확인 #

CLI와 GitHub App은 .txt에서 txt을 추론합니다. .txt 파일은 metadata/en/*.txt처럼 패턴이 .txt(으)로 끝나거나 "format": "txt"을 설정한 파일 항목에만 해당하며, "format": "txt"이 설정된 항목은 .txt 파일만 선택합니다. docs/en/**/*처럼 범위가 넓은 패턴은 .txt 파일을 건너뛰므로 LICENSE.txt 또는 requirements.txt 같은 파일은 번역되지 않습니다. 다만 뒤에 오는 항목에서 .txt을 명시하면 해당 파일을 선택할 수 있습니다. 마찬가지로 "format": "txt"이 설정된 범위가 넓은 항목도 이미지와 그 밖의 텍스트가 아닌 파일을 건너뜁니다. 파일 선택 방법은 CLI 설정 또는 GitHub를 참고하세요. 줄 번호는 고정된 키가 아니라 위치를 나타내므로 CLI 키 범위는 사용할 수 없습니다.

각 줄을 별도의 단위로 번역하므로, 여러 줄로 나뉜 문단도 한 줄씩 번역됩니다. 대상 언어에서 문장의 어순을 바꿔야 한다면 각 문단을 한 줄로 작성하세요. 번역문은 텍스트가 실제로 사용되는 곳에서 확인하세요. 스토어 등록 페이지나 길이 제한이 있는 입력란에서는 원문보다 긴 번역문이 거부될 수 있습니다.