.XLSX - 스프레드시트 엑셀 (Strings)

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

파일 확장명	.xlsx
API 확장	xlsx
가져오기	예
내보내기	예
복수형 지원	예
설명 지원	예
형식 옵션 파일을 업로드 및/또는 다운로드할 때 지정할 수 있는 옵션입니다. 업로드/다운로드 방식(API, CLI, Repo sync 등)에 따라 `업로드`, `다운로드` 문의 매개변수나 `phrase.yml` 구성 파일에서 지정할 수 있습니다.	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를 번역하려면 최소한 키 이름 열과 번역 열 하나를 제공하십시오. 기본적으로 콘텐츠는 첫 번째 행에서 시작하는 것으로 간주됩니다. 키 및 번역과 함께 주석, 태그, 번역에 허용되는 최대 글자 수와 같은 메타 정보를 가져올 수 있습니다.

파일이 여러 시트나 탭으로 업로드되는 경우 첫 번째 시트만 감지됩니다. 콘텐츠가 로캘 설정에 필요한 경우 시트나 탭을 개별 파일로 저장하십시오.

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

형식 옵션

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

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

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

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

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

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

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

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

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

구조 예시

key_name	en_US	de-DE*	주석*	태그*	max_characters*
app_title	내 프로젝트	내 프로젝트	이것은 메인 제목입니다	app, title	30
greeting	안녕하세요 '사용자'님!	안녕하세요 '사용자'님!	정중하게 하세요

*선택 사항 열

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

주석: 키에 설명을 추가하려면
태그: 파일의 개별 키에 태그를 추가하려면
max_characters: 업로드를 통해 키에 대한 글자 제한을 설정하려면

구성 예시

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

push:
    sources:
        - file: "./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