|
파일 확장명 |
.txt, .tsv |
|
API 확장 |
.txt, .tsv |
|
가져오기 |
예 |
|
내보내기 |
예 |
|
복수형 지원 |
예 |
|
설명 지원 |
예 |
|
형식 옵션 파일을 업로드 및/또는 다운로드할 때 지정할 수 있는 옵션입니다. 업로드/다운로드 방식(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 |
TXT는 굵게, 기울임꼴 또는 이미지와 같은 서식 옵션이 포함되지 않은 일반 텍스트 정보를 저장합니다.
문서의 어떤 열이 각 로캘에 해당하는지 지정하려면 locale_mapping 매개변수(hashmap 유형)가 필요합니다. 예를 보려면 configuration file example 및 업로드용 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 |
|
유형 |
문자열 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
\t |
|
설명 |
열을 구분하는 데 사용되는 글자입니다. |
|
식별자 |
quote_char |
|
유형 |
문자열 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
" |
|
설명 |
줄 바꿈 및 열 구분 기호를 감싸는 데 사용되는 문자입니다. |
|
식별자 |
header_content_row |
|
유형 |
부울 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
false |
|
설명 |
첫 번째 행에 헤더 정보만 포함되어 있어 건너뛰어야 하는지 여부를 나타냅니다. |
|
식별자 |
enable_pluralization |
|
유형 |
부울 |
|
업로드 |
예 |
|
다운로드 |
아니요 |
|
기본값 |
true |
|
설명 |
복수형 키 감지를 활성화합니다. 일치하는 모든 키는 복수형 키로 저장됩니다. |
|
식별자 |
export_tags |
|
유형 |
부울 |
|
업로드 |
아니요 |
|
다운로드 |
예 |
|
기본값 |
false |
|
설명 |
키 및 번역과 함께 태그를 내보냅니다. |
|
식별자 |
export_max_characters_allowed |
|
유형 |
부울 |
|
업로드 |
아니요 |
|
다운로드 |
예 |
|
기본값 |
false |
|
설명 |
키 및 번역과 함께 키 글자 제한을 내보냅니다. |
|
식별자 |
custom_metadata_columns |
|
유형 |
해시 |
|
업로드 |
예 |
|
다운로드 |
예 |
|
기본값 |
[empty] |
|
설명 |
가져오거나 내보내야 하는 사용자 지정 메타데이터 값의 HashMap:
|
코드 샘플
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 "와, 이 키는 훨씬 더 깊게 중첩되어 있습니다." nested.key 이 키는 네임스페이스 안에 중첩되어 있습니다. null_translation pluralized_key.one "새끼 고양이가 한 마리만 발견되었습니다." pluralized_key.other "와, 새끼 고양이가 %s 마리 있네요!" pluralized_key.zero "새끼 고양이가 없습니다." sample_collection "--- - first item - second item - third item " simple_key 간단한 메시지가 있는 간단한 키입니다. unverified_key 이 번역은 아직 확인되지 않았으며 기다리고 있습니다. (일부 형식에서는 이 상태도 내보냅니다)
파일 구조
일반적인 .TXT 파일 구조:
1 (키 열) 2 (번역 열) 3 (주석 열) app_title 내 소프트웨어 프로젝트 이것은 메인 제목입니다 apples.zero 사과 한 개 내 주석 ...
구성 예시
.CSV 파일에 대한 .phrase.yml의 push 섹션 예시:
push:
sources:
- file: "./multi.txt"
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개 수신됨,