|
파일 확장명 |
.csv |
|
API Extension |
csv |
|
가져오기 |
예 |
|
내보내기 |
예 |
|
복수형 지원 |
예 |
|
설명 지원 |
예 |
|
형식 옵션 파일이 업로드되거나 다운로드될 때 지정할 수 있는 옵션입니다. 업로드/다운로드 방법(API, CLI, Repo 동기화 등)에 따라, |
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 파일이 소스 콘텐츠, 번역 및 주석(선택 사항)을 나타내는 단일 행에 대해 세 개의 필드를 가지고 있는지 확인하십시오.
로캘_매핑 매개변수(해시맵 유형)는 문서의 각 로캘에 해당하는 열을 지정하는 데 필요합니다. 예제는 구성 파일 예제와 업로드에 대한 API 문서를 참조하십시오.
형식 옵션
|
식별자 |
max_characters_allowed_column |
|
유형 |
정수 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
[비어 있음] |
|
설명 |
키에 대한 최대 문자 수가 포함된 열의 인덱스입니다. 열 인덱스는 1부터 시작합니다. |
|
식별자 |
enable_pluralization |
|
유형 |
부울 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
true |
|
설명 |
복수형 키 감지를 활성화합니다. 일치하는 모든 키는 복수형 키로 유지됩니다. |
|
식별자 |
custom_metadata_columns |
|
유형 |
해시 |
|
업로드 |
예 |
|
다운로드 |
예 |
|
기본값 |
[비어 있음] |
|
설명 |
가져오거나 내보내야 하는 사용자 지정 메타데이터 값의 HashMap:
|
|
식별자 |
export_key_id |
|
유형 |
부울 |
|
업로드 |
아니요 |
|
다운로드 |
예 |
|
기본값 |
false |
|
설명 |
키와 번역과 함께 키 문자 제한을 내보냅니다. |
|
식별자 |
key_id_column |
|
유형 |
정수 |
|
업로드 |
아니요 |
|
다운로드 |
예 |
|
기본값 |
[비어 있음] |
|
설명 |
키의 ID가 포함된 열의 인덱스입니다. 열 인덱스는 1부터 시작합니다. |
코드 샘플
boolean_key,"--- true " empty_string_translation,"" key_with_description,확인해 보세요! 이 키에는 설명이 있습니다! (일부 형식에서는) 이 키에 대한 놀라운 설명입니다! key_with_line-break,"이 번역에는 줄 바꿈이 포함되어 있습니다." nested.deeply.key,"와우, 이 키는 훨씬 더 깊게 중첩되어 있습니다." nested.key,이 키는 네임스페이스 안에 중첩되어 있습니다. null_translation, pluralized_key.one, "고양이가 하나만 발견되었습니다." pluralized_key.other,"와우, 당신은 %s 마리의 고양이를 가지고 있습니다!" pluralized_key.zero,"당신은 고양이가 없습니다." sample_collection,"--- - 첫 번째 항목 - 두 번째 항목 - 세 번째 항목 " simple_key,단순한 메시지가 있는 단순한 키입니다. unverified_key,이 번역은 아직 확인되지 않았으며 기다리고 있습니다. (일부 형식에서는 이 상태도 내보냅니다)
파일 구조
전형적인 .CSV 파일 구조:
1 (키 열), 2 (번역 열), 3 (주석 열) app_title, My Software Project, 이것은 주요 제목입니다. apples.zero, 하나의 사과, 내 주석 ...
구성 예제
.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 (키 열), 2 (번역 열), 3 (주석 열) messages.zero, 수신된 메시지가 없습니다, messages.one, 수신된 메시지 1개, messages.other, %s개의 메시지가 수신되었습니다,