# 현지화 파일 형식
Weblate는 다양한 번역 형식을 지원합니다. 각 형식은 약간씩 다르며 서로 다른 기능 세트를 제공합니다.
#### HINT
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.
#### SEE ALSO
[Translation Related File Formats](https://docs.translatehouse.org/projects/translate-toolkit/en/latest/formats/index.html)
## 자동 감지
Weblate는 [번역 프로젝트 및 구성요소 추가](https://docs.weblate.org/ko/latest/admin/projects.md#adding-projects) 중에 파일 형식을 감지하려고 시도합니다. 동일한 직렬화 형식 (JSON, YAML, properties)의 다른 변형이나 파일 인코딩의 경우 감지가 잘못될 수 있으므로, 구성요소를 만들기 전에 [파일 형식](https://docs.weblate.org/ko/latest/admin/projects.md#component-file-format) 이 올바른지 확인하세요.
## 번역 유형 기능
각 형식에서 지원되는 기능에 대한 정보는 개별 파일 형식의 문서 페이지를 참조하세요.
### 이중 언어 및 단일 언어 형식
단일 언어 및 이중 언어 형식이 모두 지원됩니다. 이중 언어 형식은 단일 파일에 원문과 번역 두 가지 언어를 저장합니다 (일반적인 예는 [GNU gettext PO (Portable Object)](https://docs.weblate.org/ko/latest/formats/gettext.md#gettext), [XLIFF 1.1 및 1.2](https://docs.weblate.org/ko/latest/formats/xliff.md#xliff) 또는 [Apple iOS 문자열](https://docs.weblate.org/ko/latest/formats/apple.md#apple)). 반면 단일 언어 형식은 문자열을 ID로 식별하며 각 언어 파일에는 주어진 언어에 대한 매핑만 포함됩니다 (일반적으로 [Android 문자열 리소스](https://docs.weblate.org/ko/latest/formats/android.md#aresource)). 일부 파일 형식은 두 변형 모두에서 사용됩니다. 자세한 설명은 아래를 참조하세요.
단일 언어 파일을 올바르게 사용하려면 Weblate가 원문과 함께 번역할 문자열의 완전한 목록이 포함된 파일에 접근해야 합니다. 이 파일은 Weblate에서 [단일언어 기반 언어 파일](https://docs.weblate.org/ko/latest/admin/projects.md#component-template) 라고 하지만 패러다임에 따라 명명이 다를 수 있습니다.
또한 [중간 언어 파일](https://docs.weblate.org/ko/latest/admin/projects.md#component-intermediate) 를 활용하여 개발자가 제공한 문자열을 포함하되 최종 문자열에 그대로 사용하지 않도록 이 워크플로를 확장할 수 있습니다.
### 문자열 상태
많은 파일 형식은 “번역되지 않음”과 “번역됨” 문자열만 구별합니다. 일부 형식에서는 “편집 필요” 또는 “승인됨”과 같은 더 세밀한 상태 정보를 저장할 수 있습니다.
### 원문 문자열 설명
원문 문자열 설명은 번역할 문자열에 대한 추가 정보를 전달하는 데 사용할 수 있습니다.
여러 형식은 번역자에게 추가 정보를 제공하는 네이티브 지원을 가지고 있습니다 (예: [XLIFF 1.1 및 1.2](https://docs.weblate.org/ko/latest/formats/xliff.md#xliff), [GNU gettext PO (Portable Object)](https://docs.weblate.org/ko/latest/formats/gettext.md#gettext), [WebExtension JSON](https://docs.weblate.org/ko/latest/formats/webextension.md#webex), [CSV 파일](https://docs.weblate.org/ko/latest/formats/csv.md#csv), [Excel Open XML](https://docs.weblate.org/ko/latest/formats/excel.md#xlsx), [Qt Linguist .ts](https://docs.weblate.org/ko/latest/formats/qt.md#qtling), [go-i18n JSON 파일](https://docs.weblate.org/ko/latest/formats/go-i18n.md#go-i18n-json), [gotext JSON 파일](https://docs.weblate.org/ko/latest/formats/gotext.md#gotext-json), [ARB 파일](https://docs.weblate.org/ko/latest/formats/arb.md#arb), [.NET 리소스 파일 (RESX, RESW)](https://docs.weblate.org/ko/latest/formats/resx.md#dotnet)). 다른 많은 형식은 가장 가까운 주석을 원문 문자열 설명으로 추출합니다.
### 설명
문자열에 대한 [설명](https://docs.weblate.org/ko/latest/admin/translating.md#additional-explanation) 은 일부 파일 형식에서 저장하고 파싱할 수 있습니다.
현재 [TermBase eXchange 형식](https://docs.weblate.org/ko/latest/formats/tbx.md#tbx) 에서만 지원됩니다.
### 원문 문자열 위치
소스 코드에서 문자열의 위치는 숙련된 번역자가 문자열이 어떻게 사용되는지 파악하는 데 도움이 될 수 있습니다.
이 정보는 도구를 사용하여 소스 코드에서 문자열이 추출되는 이중 언어 형식에서 일반적으로 사용할 수 있습니다. 예: [GNU gettext PO (Portable Object)](https://docs.weblate.org/ko/latest/formats/gettext.md#gettext) 및 [Qt Linguist .ts](https://docs.weblate.org/ko/latest/formats/qt.md#qtling).
### 번역 플래그
번역 플래그를 사용하면 Weblate 동작을 사용자 정의할 수 있습니다. 일부 형식은 번역 파일에서 이를 정의하는 것을 지원합니다 (Weblate 인터페이스에서 항상 정의할 수 있습니다. [플래그를 사용한 동작 사용자 지정](https://docs.weblate.org/ko/latest/admin/checks.md#custom-checks) 참조).
이 기능은 [GNU gettext PO (Portable Object)](https://docs.weblate.org/ko/latest/formats/gettext.md#gettext) 의 플래그를 모델로 합니다.
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](https://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html#maxwidth) as
defined in the XLIFF standard, see [번역 플래그 지정](https://docs.weblate.org/ko/latest/formats/xliff.md#xliff-flags).
#### SEE ALSO
* [플래그를 사용한 동작 사용자 지정](https://docs.weblate.org/ko/latest/admin/checks.md#custom-checks)
* [PO 파일 문서](https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html)
### 컨텍스트
컨텍스트는 다른 범위에서 사용되는 이중 언어 형식의 동일한 문자열을 구별하는 데 사용됩니다 (예: 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.
#### HINT
문자열 복수형 처리는 애플리케이션 프레임워크의 적절한 지원도 필요합니다. [GNU gettext PO (Portable Object)](https://docs.weblate.org/ko/latest/formats/gettext.md#gettext), [Android 문자열 리소스](https://docs.weblate.org/ko/latest/formats/android.md#aresource) 또는 [Stringsdict 형식](https://docs.weblate.org/ko/latest/formats/stringsdict.md#stringsdict) 와 같은 플랫폼의 네이티브 형식을 선택하세요.
### Multivalue formats
Multivalue formats, such as [다중값 CSV 파일](https://docs.weblate.org/ko/latest/formats/csv.md#multivalue-csv) and [TermBase eXchange 형식](https://docs.weblate.org/ko/latest/formats/tbx.md#tbx), store independent
source and target alternatives within one string. These alternatives have no
one-to-one pairing, and their counts do not follow grammatical plural rules.
Source checks inspect every source alternative. Target checks compare each
target alternative with the source alternatives.
A target passes when it matches any source alternative, independently of their
order or the languages’ grammatical plural forms. The Unchanged
translation check instead reports targets identical to any source alternative,
subject to its usual exemptions. Automatic fixes are applied only when all
source alternatives produce the same correction.
[Machine translation suggestions](https://docs.weblate.org/ko/latest/user/translating.md#machine-translation) translate each
source alternative independently. Automatic machine translation supports strings
with one source alternative and at most one target alternative; it skips strings
with multiple alternatives to preserve them. Translation service glossaries can
use all alternatives. Automatic [번역 메모리](https://docs.weblate.org/ko/latest/admin/memory.md#translation-memory) contributions skip strings
with multiple alternatives.
LLM translation services use only strings with one source alternative and one
target alternative as examples of previous translations. They omit existing
translation context for strings with multiple alternatives.
### 읽기 전용 문자열
번역 파일의 읽기 전용 문자열은 포함되지만 Weblate에서 편집할 수 없습니다. 이 기능은 일부 형식 ([XLIFF 1.1 및 1.2](https://docs.weblate.org/ko/latest/formats/xliff.md#xliff) 및 [Android 문자열 리소스](https://docs.weblate.org/ko/latest/formats/android.md#aresource))에서 네이티브로 지원되지만 `read-only` 플래그를 추가하여 다른 형식에서 에뮬레이션할 수 있습니다 ( [플래그를 사용한 동작 사용자 지정](https://docs.weblate.org/ko/latest/admin/checks.md#custom-checks) 참조).
### 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](https://toolkit.translatehouse.org/) 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](https://toolkit.translatehouse.org/) 에서 지원을 구현하는 것이 바람직한 접근 방식입니다.
#### SEE ALSO
[Translation Related File Formats](https://docs.translatehouse.org/projects/translate-toolkit/en/latest/formats/index.html)
## 파일 형식 매개변수
파일 형식 매개변수는 파일 형식과 관련된 설정을 구성하는 방법을 제공합니다. 구성요소 수준에서 구성되며 파일 파싱과 직렬화 처리 방식을 사용자 정의할 수 있습니다.
For supported XML formats, `xml_utf8_bom` controls the UTF-8 byte order mark:
`preserve` keeps the input file’s BOM, `include` always writes it, and
`omit` removes it. The default is `preserve`; new files without a template
omit the BOM. Other encodings are unchanged.
The `xml_encoding_case` parameter selects `uppercase` or `lowercase`
encoding names in the XML declaration, such as `UTF-8` or `utf-8`.
The default, `default`, uses the format’s native casing.
The `xml_final_newline` parameter controls the newline after the complete XML
document, including any trailing comments or processing instructions. Choose
`include` for exactly one final line ending, or `omit` for none.
The default, `default`, leaves the format’s behavior unchanged. Explicit
inclusion uses the serializer’s line-ending style, falling back to LF when the
output contains no line endings. Translation-content whitespace is unchanged.
### 파일 형식 매개변수 목록
| 매개변수 이름 | 파일 형식 | 레이블 | 도움말 텍스트 |
|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| csv_encoding | * `csv`
* `csv-multi` | 파일 인코딩 | CSV 파일 인코딩
사용 가능한 선택:
`auto`
: 자동 감지
`utf-8`
: UTF-8 |
| csv_escape_formulas | * `csv`
* `csv-multi`
* `csv-simple` | Escape spreadsheet formulas | Prefix values that look like spreadsheet formulas with an apostrophe when saving CSV files. |
| csv_simple_encoding | * `csv-simple` | 파일 인코딩 | Simple CSV 파일 인코딩
사용 가능한 선택:
`auto`
: 자동 감지
`utf-8`
: UTF-8
`iso-8859-1`
: ISO-8859-1 |
| dos_eol | 모든 파일 형식 | DOS 줄 끝 | 문자열에서 UNIX 줄 끝(n) 대신 DOS 줄 끝(rn)을 사용합니다. |
| flatxml_key_name | * `flatxml` | FlatXML 키 이름 | |
| flatxml_root_name | * `flatxml` | FlatXML 루트 이름 | |
| flatxml_value_name | * `flatxml` | FlatXML 값 이름 | |
| gwt_encoding | * `gwt` | 파일 인코딩 | GWT 속성 파일에 사용되는 인코딩
사용 가능한 선택:
`utf-8`
: UTF-8
`iso-8859-1`
: ISO-8859-1 |
| json_indent | * `json`
* `json-nested`
* `webextension`
* `i18next`
* `i18nextv4`
* `arb`
* `go-i18n-json`
* `go-i18n-json-v2`
* `formatjs`
* `gotext` | JSON 들여쓰기 | |
| json_indent_style | * `json`
* `json-nested`
* `webextension`
* `i18next`
* `i18nextv4`
* `arb`
* `go-i18n-json`
* `go-i18n-json-v2`
* `formatjs`
* `gotext` | JSON 들여쓰기 스타일 | 사용 가능한 선택:
`spaces`
: 공백
`tabs`
: 탭 |
| json_sort_keys | * `json`
* `json-nested`
* `webextension`
* `i18next`
* `i18nextv4`
* `arb`
* `go-i18n-json`
* `go-i18n-json-v2`
* `formatjs`
* `gotext` | JSON 키 정렬 | 사용 가능한 선택:
`none`
: Do not sort
`case_sensitive`
: Case-sensitive sort
`case_insensitive`
: Case-insensitive sort |
| json_use_compact_separators | * `json`
* `json-nested`
* `webextension`
* `i18next`
* `i18nextv4`
* `arb`
* `go-i18n-json`
* `go-i18n-json-v2`
* `formatjs`
* `gotext` | 구분자 뒤 공백 방지 | |
| line_max_length | * `markdown`
* `mdx` | 최대 줄 길이 | 출력 파일의 각 줄에 사용할 최대 문자 수입니다. |
| md_extract_code_blocks | * `markdown`
* `mdx` | 코드 블록 추출 | Markdown 및 MDX 파일의 코드 블록에서 번역 가능한 콘텐츠를 추출할지 여부입니다. |
| md_extract_frontmatter | * `markdown`
* `mdx` | 프런트매터 추출 | Markdown 및 MDX 파일의 YAML 프런트매터 블록을 추출하고 번역할지 여부입니다. |
| md_frontmatter_translate_values | * `markdown`
* `mdx` | 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` | 자리표시자 비활성화 | Markdown 및 MDX 파일에서 자리표시자 감지와 프로세싱을 비활성화합니다. |
| merge_duplicates | * `markdown`
* `mdx`
* `html`
* `txt`
* `dokuwiki`
* `mediawiki`
* `asciidoc` | 동일 문자열 중복 제거 | 동일한 원문 문자열을 하나의 번역 단위로 통합합니다. 위치 종속 맥락을 제거하여 파일 재구성 또는 테이블 재정렬 시 번역 손실을 방지합니다. |
| po_contributor_comments | * `po`
* `po-mono` | Contributor comments | Add contributor names and years to header comments. SPDX also converts existing recognized contributor comments to SPDX-FileCopyrightText entries.
사용 가능한 선택:
`none`
: Disabled
`gettext`
: Gettext
`spdx`
: SPDX |
| po_fuzzy_matching | * `po` | 퍼지 매칭 사용 | |
| po_keep_previous | * `po` | 번역된 문자열의 이전 msgid 보존 | Controls previous msgid comments for fuzzy strings. |
| po_line_wrap | * `po`
* `po-mono` | 긴 줄 줄바꿈 | 기본적으로 gettext는 77자 및 줄바꿈에서 줄을 바꿉니다. `--no-wrap` 매개변수를 사용하면 줄바꿈에서만 줄을 바꿉니다.
사용 가능한 선택:
`77`
: 77자 및 줄바꿈에서 줄 바꿈(xgettext 기본값)
`65535`
: 줄바꿈에서만 줄 바꿈(`xgettext --no-wrap` 와 동일)
`-1`
: 줄 바꿈 없음 |
| po_no_location | * `po` | 파일에 위치 정보를 포함하지 않습니다 | |
| po_remove_obsolete | * `po`
* `po-mono` | Remove obsolete strings | Remove obsolete entries from PO files when saving translation changes or updating from a POT file. |
| po_report_msgid_bugs_to | * `po`
* `po-mono` | msgid 버그 보고 대상 | 원문 문자열 버그 보고 주소가 지정되어 있으면 Weblate가 “Report-Msgid-Bugs-To” 파일 머리글을 업데이트하도록 합니다. |
| po_set_language_team | * `po`
* `po-mono` | 언어 팀 머리글 업데이트 | Weblate가 “Language-Team” 파일 머리글을 업데이트하도록 합니다. |
| po_set_last_translator | * `po`
* `po-mono` | 마지막 번역자 머리글 업데이트 | Weblate가 “Last-Translator” 파일 헤더를 업데이트하도록 합시다. |
| po_set_x_generator | * `po`
* `po-mono` | X-Generator 머리글 업데이트 | Weblate가 “X-Generator” 파일 헤더를 업데이트하도록 합시다. |
| properties_encoding | * `properties` | 파일 인코딩 | Java 속성 파일 인코딩
사용 가능한 선택:
`iso-8859-1`
: ISO-8859-1
`utf-8`
: UTF-8
`utf-16`
: UTF-16 |
| strings_encoding | * `strings` | 파일 인코딩 | iOS 문자열 파일 인코딩
사용 가능한 선택:
`utf-8`
: UTF-8
`utf-16`
: UTF-16 |
| xliff_placeables | * `xliff`
* `xliff2` | Placeables support | Controls whether inline XML elements inside XLIFF strings are preserved as editable placeables. Plain text only escapes XML markup and treats the content as text. With placeables supported, tags such as or stay in the string and appear as placeholders in the editor
사용 가능한 선택:
`plain`
: Plain text only
`placeables`
: Support placeables |
| xml_closing_tags | * `ts`
* `xliff`
* `xliff2`
* `poxliff`
* `apple-xliff`
* `resx`
* `aresource`
* `moko-resource`
* `cmp-resource`
* `tbx` | 빈 XML 태그에 닫는 태그 포함 | |
| xml_encoding_case | * `ts`
* `xliff`
* `xliff2`
* `poxliff`
* `apple-xliff`
* `resx`
* `aresource`
* `moko-resource`
* `cmp-resource`
* `tbx` | XML declaration encoding case | Controls encoding names in the XML declaration, for example “UTF-8” or “utf-8”.
사용 가능한 선택:
`default`
: Format default
`uppercase`
: Uppercase
`lowercase`
: Lowercase |
| xml_final_newline | * `ts`
* `xliff`
* `xliff2`
* `poxliff`
* `apple-xliff`
* `resx`
* `aresource`
* `moko-resource`
* `cmp-resource`
* `tbx` | XML final newline | Controls the newline at the end of the file, using the format’s line endings.
사용 가능한 선택:
`default`
: Format default
`include`
: Always include
`omit`
: Always omit |
| xml_utf8_bom | * `ts`
* `xliff`
* `xliff2`
* `poxliff`
* `apple-xliff`
* `resx`
* `aresource`
* `moko-resource`
* `cmp-resource`
* `tbx` | UTF-8 byte order mark | Controls the UTF-8 byte order mark. Other encodings are unchanged. New files without a template omit the mark when preserving input.
사용 가능한 선택:
`preserve`
: Preserve input
`include`
: Always include
`omit`
: Always omit |
| xml_whitespace_handling | * `xliff`
* `poxliff`
* `apple-xliff`
* `xliff2` | Whitespace handling | Controls how XLIFF whitespace is handled. Follow xml:space honors attributes in the file. Always preserve keeps all whitespace. Always normalize collapses whitespace even when xml:space=”preserve” is set.
사용 가능한 선택:
`standard`
: Follow xml:space
`preserve`
: Always preserve
`normalize`
: Always normalize |
| yaml_indent | * `yaml`
* `ruby-yaml` | YAML 들여쓰기 | |
| yaml_line_break | * `yaml`
* `ruby-yaml` | 줄바꿈 | 사용 가능한 선택:
`dos`
: DOS (\\r\\n)
`unix`
: UNIX (\\n)
`mac`
: MAC (\\r) |
| yaml_line_wrap | * `yaml`
* `ruby-yaml` | 긴 줄 줄바꿈 | 사용 가능한 선택:
`80`
: 80자에서 줄바꿈
`100`
: 100자에서 줄바꿈
`120`
: 120자에서 줄바꿈
`180`
: 180자에서 줄바꿈
`65535`
: 줄 바꿈 없음 |