현지화 파일 형식¶
Weblate는 다양한 번역 형식을 지원합니다. 각 형식은 약간씩 다르며 서로 다른 기능 세트를 제공합니다.
힌트
When choosing a file format for your application, it’s better to stick to some well-established format in the toolkit/platform you use. This way your translators can additionally use whatever tools they are used to, and will more likely contribute to your project.
자동 감지¶
Weblate는 번역 프로젝트 및 구성요소 추가 중에 파일 형식을 감지하려고 시도합니다. 동일한 직렬화 형식 (JSON, YAML, properties)의 다른 변형이나 파일 인코딩의 경우 감지가 잘못될 수 있으므로, 구성요소를 만들기 전에 파일 형식 이 올바른지 확인하세요.
번역 유형 기능¶
각 형식에서 지원되는 기능에 대한 정보는 개별 파일 형식의 문서 페이지를 참조하세요.
이중 언어 및 단일 언어 형식¶
단일 언어 및 이중 언어 형식이 모두 지원됩니다. 이중 언어 형식은 단일 파일에 원문과 번역 두 가지 언어를 저장합니다 (일반적인 예는 GNU gettext PO (Portable Object), XLIFF 1.1 및 1.2 또는 Apple iOS 문자열). 반면 단일 언어 형식은 문자열을 ID로 식별하며 각 언어 파일에는 주어진 언어에 대한 매핑만 포함됩니다 (일반적으로 Android 문자열 리소스). 일부 파일 형식은 두 변형 모두에서 사용됩니다. 자세한 설명은 아래를 참조하세요.
단일 언어 파일을 올바르게 사용하려면 Weblate가 원문과 함께 번역할 문자열의 완전한 목록이 포함된 파일에 접근해야 합니다. 이 파일은 Weblate에서 단일언어 기반 언어 파일 라고 하지만 패러다임에 따라 명명이 다를 수 있습니다.
또한 중간 언어 파일 를 활용하여 개발자가 제공한 문자열을 포함하되 최종 문자열에 그대로 사용하지 않도록 이 워크플로를 확장할 수 있습니다.
문자열 상태¶
많은 파일 형식은 “번역되지 않음”과 “번역됨” 문자열만 구별합니다. 일부 형식에서는 “편집 필요” 또는 “승인됨”과 같은 더 세밀한 상태 정보를 저장할 수 있습니다.
원문 문자열 설명¶
원문 문자열 설명은 번역할 문자열에 대한 추가 정보를 전달하는 데 사용할 수 있습니다.
여러 형식은 번역자에게 추가 정보를 제공하는 네이티브 지원을 가지고 있습니다 (예: XLIFF 1.1 및 1.2, GNU gettext PO (Portable Object), WebExtension JSON, CSV 파일, Excel Open XML, Qt Linguist .ts, go-i18n JSON 파일, gotext JSON 파일, ARB 파일, .NET 리소스 파일 (RESX, RESW)). 다른 많은 형식은 가장 가까운 주석을 원문 문자열 설명으로 추출합니다.
설명¶
문자열에 대한 설명 은 일부 파일 형식에서 저장하고 파싱할 수 있습니다.
현재 TermBase eXchange 형식 에서만 지원됩니다.
원문 문자열 위치¶
소스 코드에서 문자열의 위치는 숙련된 번역자가 문자열이 어떻게 사용되는지 파악하는 데 도움이 될 수 있습니다.
이 정보는 도구를 사용하여 소스 코드에서 문자열이 추출되는 이중 언어 형식에서 일반적으로 사용할 수 있습니다. 예: GNU gettext PO (Portable Object) 및 Qt Linguist .ts.
번역 플래그¶
번역 플래그를 사용하면 Weblate 동작을 사용자 정의할 수 있습니다. 일부 형식은 번역 파일에서 이를 정의하는 것을 지원합니다 (Weblate 인터페이스에서 항상 정의할 수 있습니다. 플래그를 사용한 동작 사용자 지정 참조).
이 기능은 GNU gettext PO (Portable Object) 의 플래그를 모델로 합니다.
Additionally, XML-based formats that support flags extract them from the
non-standard attribute weblate-flags. The max-length:N flag is also
supported through the maxwidth attribute as
defined in the XLIFF standard, see 번역 플래그 지정.
컨텍스트¶
컨텍스트는 다른 범위에서 사용되는 이중 언어 형식의 동일한 문자열을 구별하는 데 사용됩니다 (예: Sun 은 “Sunday”의 약어 또는 가장 가까운 별의 이름으로 사용될 수 있습니다).
단일 언어 형식의 경우 문자열 식별자 (일반적으로 키라고 함)가 동일한 목적을 서비스할 수 있으므로 추가 컨텍스트가 필요하지 않습니다.
복수형 문자열¶
복수형은 가변적인 수를 가진 문자열을 적절하게 현지화하는 데 필요합니다. 규칙은 대상 언어에 따라 다르며 많은 형식이 CLDR 표준을 따릅니다.
Plural support in the supported features table means Weblate can represent plural strings for the format. Some formats need existing plural metadata or a specific variant, and cannot create new plural strings unless that is natively supported by the format.
힌트
문자열 복수형 처리는 애플리케이션 프레임워크의 적절한 지원도 필요합니다. GNU gettext PO (Portable Object), Android 문자열 리소스 또는 Stringsdict 형식 와 같은 플랫폼의 네이티브 형식을 선택하세요.
읽기 전용 문자열¶
번역 파일의 읽기 전용 문자열은 포함되지만 Weblate에서 편집할 수 없습니다. 이 기능은 일부 형식 (XLIFF 1.1 및 1.2 및 Android 문자열 리소스)에서 네이티브로 지원되지만 read-only 플래그를 추가하여 다른 형식에서 에뮬레이션할 수 있습니다 ( 플래그를 사용한 동작 사용자 지정 참조).
Removing obsolete strings¶
Some file formats can store obsolete strings. Weblate can remove these obsolete strings from formats that support this operation.
다른 형식 지원¶
Most formats supported by translate-toolkit which support serializing can be easily supported, but they did not (yet) receive any testing. In most cases, an additional thin layer is needed in Weblate to hide differences in behavior of different storages.
새 형식에 대한 지원을 추가하려면 먼저 translate-toolkit 에서 지원을 구현하는 것이 바람직한 접근 방식입니다.
파일 형식 매개변수¶
파일 형식 매개변수는 파일 형식과 관련된 설정을 구성하는 방법을 제공합니다. 구성요소 수준에서 구성되며 파일 파싱과 직렬화 처리 방식을 사용자 정의할 수 있습니다.
파일 형식 매개변수 목록¶
매개변수 이름 |
파일 형식 |
레이블 |
도움말 텍스트 |
|---|---|---|---|
csv_encoding |
|
파일 인코딩 |
CSV 파일 인코딩 사용 가능한 선택:
|
csv_escape_formulas |
|
Escape spreadsheet formulas |
Prefix values that look like spreadsheet formulas with an apostrophe when saving CSV files. |
csv_simple_encoding |
|
파일 인코딩 |
Simple CSV 파일 인코딩 사용 가능한 선택:
|
dos_eol |
모든 파일 형식 |
DOS 줄 끝 |
문자열에서 UNIX 줄 끝(n) 대신 DOS 줄 끝(rn)을 사용합니다. |
flatxml_key_name |
|
FlatXML 키 이름 |
|
flatxml_root_name |
|
FlatXML 루트 이름 |
|
flatxml_value_name |
|
FlatXML 값 이름 |
|
gwt_encoding |
|
파일 인코딩 |
GWT 속성 파일에 사용되는 인코딩 사용 가능한 선택:
|
json_indent |
|
JSON 들여쓰기 |
|
json_indent_style |
|
JSON 들여쓰기 스타일 |
사용 가능한 선택:
|
json_sort_keys |
|
JSON 키 정렬 |
사용 가능한 선택:
|
json_use_compact_separators |
|
구분자 뒤 공백 방지 |
|
line_max_length |
|
최대 줄 길이 |
출력 파일의 각 줄에 사용할 최대 문자 수입니다. |
md_extract_code_blocks |
|
코드 블록 추출 |
Markdown 및 MDX 파일의 코드 블록에서 번역 가능한 콘텐츠를 추출할지 여부입니다. |
md_extract_frontmatter |
|
프런트매터 추출 |
Markdown 및 MDX 파일의 YAML 프런트매터 블록을 추출하고 번역할지 여부입니다. |
md_frontmatter_translate_values |
|
Translate front matter values |
Parse YAML front matter and translate only scalar string values. Keys, structure, comments, and formatting are preserved when possible. |
md_no_placeholders |
|
자리표시자 비활성화 |
Markdown 및 MDX 파일에서 자리표시자 감지와 프로세싱을 비활성화합니다. |
merge_duplicates |
|
동일 문자열 중복 제거 |
동일한 원문 문자열을 하나의 번역 단위로 통합합니다. 위치 종속 맥락을 제거하여 파일 재구성 또는 테이블 재정렬 시 번역 손실을 방지합니다. |
po_fuzzy_matching |
|
퍼지 매칭 사용 |
|
po_keep_previous |
|
번역된 문자열의 이전 msgid 보존 |
Controls previous msgid comments for fuzzy strings. |
po_line_wrap |
|
긴 줄 줄바꿈 |
기본적으로 gettext는 77자 및 줄바꿈에서 줄을 바꿉니다. 사용 가능한 선택:
|
po_no_location |
|
파일에 위치 정보를 포함하지 않습니다 |
|
po_remove_obsolete |
|
Remove obsolete strings |
Remove obsolete entries from PO files when saving translation changes or updating from a POT file. |
po_report_msgid_bugs_to |
|
msgid 버그 보고 대상 |
원문 문자열 버그 보고 주소가 지정되어 있으면 Weblate가 “Report-Msgid-Bugs-To” 파일 머리글을 업데이트하도록 합니다. |
po_set_language_team |
|
언어 팀 머리글 업데이트 |
Weblate가 “Language-Team” 파일 머리글을 업데이트하도록 합니다. |
po_set_last_translator |
|
마지막 번역자 머리글 업데이트 |
Weblate가 “Last-Translator” 파일 헤더를 업데이트하도록 합시다. |
po_set_x_generator |
|
X-Generator 머리글 업데이트 |
Weblate가 “X-Generator” 파일 헤더를 업데이트하도록 합시다. |
properties_encoding |
|
파일 인코딩 |
Java 속성 파일 인코딩 사용 가능한 선택:
|
strings_encoding |
|
파일 인코딩 |
iOS 문자열 파일 인코딩 사용 가능한 선택:
|
xml_closing_tags |
|
빈 XML 태그에 닫는 태그 포함 |
|
yaml_indent |
|
YAML 들여쓰기 |
|
yaml_line_break |
|
줄바꿈 |
사용 가능한 선택:
|
yaml_line_wrap |
|
긴 줄 줄바꿈 |
사용 가능한 선택:
|