.CSV (Strings)

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

파일 확장명	.csv
API 확장	csv
가져오기	예
내보내기	예
복수형 지원	예
설명 지원	예
형식 옵션 파일을 업로드 및/또는 다운로드할 때 지정할 수 있는 옵션입니다. 업로드/다운로드 방식(API, CLI, Repo 동기화 등)에 따라 `업로드`, `다운로드` 쿼리 매개변수나 `phrase.yml` 구성 파일에서 지정할 수 있습니다.	key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV(쉼표로 구분된 값)는 다양한 애플리케이션과 프로그램에서 데이터 전송을 위해 주로 사용되는 널리 쓰이는 파일 형식입니다. CSV 파일에서 각 줄은 하나의 데이터 레코드입니다. 각 레코드는 쉼표로 구분된 몇 개의 필드로 구성됩니다. 가져오기 전에 CSV 파일에 소스 콘텐츠, 번역, 주석(선택 사항)을 나타내는 한 줄에 대한 세 개의 필드가 있는지 확인하십시오.

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

형식 옵션

식별자	key_index
유형	integer
업로드	예
다운로드	아니요
기본값	[empty]
설명	키 이름이 포함된 열의 인덱스입니다. 열 인덱스는 1부터 시작합니다.

식별자	comment_index
유형	integer
업로드	예
다운로드	아니요
기본값	[empty]
설명	키에 대한 설명이 포함된 열의 인덱스입니다. 열 인덱스는 1부터 시작합니다.

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

식별자	max_characters_allowed_column
유형	integer
업로드	예
다운로드	아니요
기본값	[empty]
설명	키에 대한 최대 문자 수가 포함된 열의 인덱스입니다. 열 인덱스는 1부터 시작합니다.

식별자	column_separator
유형	문자열
업로드	예
다운로드	아니요
기본값	,
설명	열을 구분하는 데 사용되는 문자입니다.

식별자	quote_char
유형	문자열
업로드	예
다운로드	아니요
기본값	"
설명	줄 바꿈 및 열 구분 기호를 견적하는 데 사용되는 문자입니다.

식별자	header_content_row
유형	부울
업로드	예
다운로드	아니요
기본값	false
설명	첫 번째 행에 헤더 정보만 포함되어 있어 건너뛰어야 하는지 여부를 나타냅니다.

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

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

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

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

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

식별자	key_id_column
유형	integer
업로드	아니요
다운로드	예
기본값	[empty]
설명	키에 대한 ID를 포함하는 열의 인덱스. 열 인덱스는 1부터 시작합니다.

코드 샘플

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! 이 키에는 설명이 있습니다! (일부 형식의 경우),이것은 이 키에 대한 놀라운 설명입니다!
key_with_line-break,"This translations contains
a line-break."
nested.deeply.key,"Wow, this key is nested even deeper."
nested.key,This key is nested inside a namespace.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (일부 형식에서는 이 상태도 내보냅니다.)

파일 구조

일반적인 .CSV 파일 구조:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

구성 예시

.CSV 파일에 대한 .phrase.yml의 push 섹션 예시:

push:
    sources:
        - file: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

복수 형태

이 형식 기명된 범주를 사용하여 키 다양한 복수형을 식별합니다. 복수형에 대한 다음 범주는 예약되어 있습니다.

.zero | .one | .two | .few | .many | .other

올바르게 식별되고, 지속되고, 표시된 복수형 키의 예시명:

inbox.messages.notification.one
inbox.messages.notification.other

파일은 이 구조를 따라야 합니다:

1 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,