.XLSX - Spreadsheet Excel (Strings)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

파일 확장명	.xlsx
API 확장	xlsx
가져오기	예
내보내기	예
복수형 지원	예
설명 지원	예
형식 옵션	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX는 현지화에 널리 사용되는 파일 형식입니다. .XLSX 파일의 레이아웃은 특정 설정에 따라 다를 수 있지만, 일반적으로 언어당 한 열의 규칙을 따릅니다. .XLSX를 번역하려면 키 이름 열과 하나의 번역 열을 제공해야 합니다. .XLSX의 경우 기본적으로 콘텐츠는 첫 번째 행에서 시작하는 것으로 가정됩니다. 키와 번역 외에도 주석, 태그 및 번역에 허용되는 최대 문자 수와 같은 메타 정보도 가져올 수 있습니다.

여러 시트나 탭이 있는 파일이 업로드되면 첫 번째 시트만 감지됩니다. 현지화에 필요한 경우 시트나 탭을 개별 파일로 저장하십시오.

locale_mapping 매개변수(해시맵 유형)는 문서에서 각 로캘에 해당하는 열을 지정하는 데 필요합니다. 예제는 구성 파일 예제와 업로드를 위한 API 문서를 참조하십시오.

형식 옵션

식별자	key_name_column
유형	문자열
업로드	예
다운로드	아니요
기본값	[empty]
설명	키 이름/식별자를 포함하는 열입니다.

식별자	comment_column
유형	문자열
업로드	예
다운로드	아니요
기본값	[empty]
설명	키에 대한 주석/설명을 포함하는 열입니다.

식별자	tag_column
유형	문자열
업로드	예
다운로드	아니요
기본값	[empty]
설명	키에 대한 태그를 포함하는 열의 인덱스입니다.

식별자	first_content_row
유형	정수
업로드	예
다운로드	아니요
기본값	1
설명	번역 콘텐츠를 포함하는 첫 번째 행의 인덱스입니다.

식별자	enable_pluralization
유형	부울
업로드	예
다운로드	아니요
기본값	true
설명	복수형 키 감지를 활성화합니다. 일치하는 모든 키는 복수형 키로 유지됩니다.

식별자	export_tags
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	키와 번역과 함께 태그를 내보냅니다.

식별자	export_max_characters_allowed
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	키와 번역과 함께 키 문자 제한을 내보냅니다.

식별자	custom_metadata_columns
유형	해시
업로드	예
다운로드	예
기본값	[empty]
설명	가져오거나 내보내야 하는 사용자 지정 메타데이터 값의 해시맵입니다: 키 = Phrase Strings에서 정의된 사용자 지정 메타데이터 속성의 이름입니다. 값 = 속성이 가져온 파일에 있는 위치/내보낸 파일에 있어야 하는 위치를 나타내는 열 식별자 (A, B, C 등)입니다.

식별자	translation_columns
유형	해시
업로드	예
다운로드	예
기본값	[empty]
설명	언어 ID/이름 = 사용자 지정 메타데이터 속성의 열, Phrase Strings에서 정의된 대로. 값 = 속성이 가져온 파일에 있는 위치/내보낸 파일에 있어야 하는 위치를 나타내는 열 식별자 (A, B, C 등)입니다.

구조 예시

key_name	en_US	de-DE*	주석*	tags*	max_characters*
app_title	내 프로젝트	내 프로젝트	이것은 주요 제목입니다	앱, 제목	30
인사말	안녕하세요 '사용자'!	안녕하세요 '사용자'!	공손하게 행동하세요

*선택적 열

스프레드시트 파일은 키 열과 하나의 언어가 있어야 업로드할 수 있습니다. 추가 언어 외에도 다음 열을 추가하여 메타 정보를 추가할 수 있습니다:

주석: 키에 대한 설명을 추가하기 위해
tags: 파일의 개별 키에 태그를 추가하기 위해
최대_문자수: 업로드를 통해 키에 대한 문자 제한을 설정하기 위해

구성 예시

XLSX 파일을 위한 .phraseapp.yml의 push 섹션에 대한 예시입니다.

push:
    sources:
        - 파일: "./en.xlsx"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: B