<a id="tbx"></a>

# TermBase eXchange 형식

#### Versionadded
Added in version 4.5.

#### Versionchanged
버전 5.12에서 변경.

TBX는 전문용어 데이터 교환을 위한 XML 형식입니다.

#### SEE ALSO
* [위키피디아의 TBX](https://en.wikipedia.org/wiki/TermBase_eXchange)
* [TBX](https://docs.translatehouse.org/projects/translate-toolkit/en/latest/formats/tbx.html)
* [용어집](https://docs.weblate.org/ko/latest/user/glossary.md#glossary)

<!-- AUTOGENERATED START: format-features tbx -->
<!-- This section is automatically generated by `./manage.py list_format_features`. Do not edit manually. -->

#### 지원 기능

| 파일 확장자                                                                                               | `.tbx`   |
|------------------------------------------------------------------------------------------------------|----------|
| 언어성 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#bimono)                                          | 이중 언어    |
| 복수형 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-plurals)                               | `No`     |
| 설명 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-description)                            | `Yes`    |
| 설명 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-explanation)                            | `Yes`    |
| 문맥 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-context)                                | `Yes`    |
| 위치 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-location)                               | `No`     |
| 플래그 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#format-flags)                                 | `Yes`    |
| API 식별자                                                                                              | `tbx`    |
| 읽기 전용 문자열 지원 [ⓘ](https://docs.weblate.org/ko/latest/formats.md#read-only-strings)                      | `No`     |
| Supports removing obsolete strings [ⓘ](https://docs.weblate.org/ko/latest/formats.md#obsolete-strings) | `No`     |
<!-- AUTOGENERATED END: format-features tbx -->

## Term alternatives

Each TBX concept is one string with independent lists of source and target
alternatives. Weblate reads every direct `<tig>` in the selected languages;
IDs are optional and do not pair alternatives across languages. All source
alternatives can match in the glossary, and each permitted target can be copied
separately. Term statuses and notes are displayed with their alternatives.

See [Multivalue formats](https://docs.weblate.org/ko/latest/formats.md#format-multivalue) for how alternatives are handled by quality checks,
automatic fixes, and machine translation.

When editing alternatives, unchanged text is matched first, including duplicate
occurrences. Remaining alternatives reuse unmatched terms in their original
order, retaining IDs and metadata. Renaming and deleting alternatives together
can therefore associate a renamed term with the first unmatched term’s metadata.
New alternatives are created without IDs. Term metadata is read-only in Weblate.

A missing target language does not remove a concept whose source exists. DNT
terms can use the matching source alternative without creating a translation.
Language codes still need to match the component configuration.

## 설명

Weblate는 [용어집](https://docs.weblate.org/ko/latest/user/glossary.md#glossary) 에 표시하기 위해 TBX 파일에서 설명을 로드하고 저장합니다.

* 번역 설명은 `<note from="translator"></note>` 태그로 저장됩니다.
* 원문 문자열 설명은 `<descrip></descrip>` 태그로 저장됩니다.
* Source string description is stored as `<descrip type="Usage note"></descrip>` tag.

Concept notes are shared. Language notes are read only for the selected language,
and term notes belong to their own alternative. Editing a target explanation does
not overwrite notes in other languages.

TBX components offer native and generated TBX downloads. Conversion to formats
that use grammatical plurals is unavailable because those formats cannot preserve
independent source and target alternatives.

Generated TBX downloads preserve represented flags, explanations, alternative IDs,
statuses, and note scopes. Weblate flags use the same `weblate-flags` attribute
as native TBX storage. Native file editing also preserves unrecognized XML and
unselected languages; generated exports contain the selected language pair.

## Glossary flags and read-only metadata

Weblate imports terms with `forbidden` or `obsolete` administrative status
in `<termNote type="administrativeStatus">` as
[금지된 번역](https://docs.weblate.org/ko/latest/user/glossary.md#glossary-forbidden).

Terms with `<descrip type="Translation needed">No</descrip>` are imported as
read-only strings, see [번역 불가 용어](https://docs.weblate.org/ko/latest/user/glossary.md#glossary-untranslatable).

## Importing glossary files

TBX can store multiple languages in one XML file, but Weblate still maps each
component file to a translation language using the component file mask. For a
TBX glossary component, the component source language is used for source terms
and the language parsed from the file name is used as the target glossary
language.

Avoid naming a TBX translation file with the same language code as the
component source language, because the source language already exists in
Weblate and the file can be detected as a duplicate language.

The Add upload method preserves alternative IDs, statuses, and scoped notes
when importing TBX into a TBX glossary.

#### SEE ALSO
* [용어집](https://docs.weblate.org/ko/latest/user/glossary.md#glossary)
* [언어 별칭](https://docs.weblate.org/ko/latest/admin/projects.md#project-language-aliases)
* [언어 필터](https://docs.weblate.org/ko/latest/admin/projects.md#component-language-regex)

## 파일 예시

파일 예시:

```xml
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE martif PUBLIC "ISO 12200:1999A//DTD MARTIF core (DXFcdV04)//EN" "TBXcdv04.dtd">
<martif type="TBX" xml:lang="en">
    <martifHeader>
        <fileDesc>
            <sourceDesc>
                <p>Translate Toolkit</p>
            </sourceDesc>
        </fileDesc>
    </martifHeader>
    <text>
        <body>
            <termEntry>
                <langSet xml:lang="en">
                  <tig>
                    <term>address bar</term>
                  </tig>
                </langSet>
                <langSet xml:lang="cs">
                  <tig>
                    <term>adresní řádek</term>
                  </tig>
                </langSet>
            </termEntry>
            <termEntry weblate-flags="terminology">
                <langSet xml:lang="en">
                  <tig>
                    <term>administrator</term>
                  </tig>
                </langSet>
                <langSet xml:lang="cs">
                  <tig>
                    <term>správce</term>
                  </tig>
                </langSet>
            </termEntry>
            <termEntry>
                <descrip>Example source string explanation text</descrip>
                <descrip type="Usage note">Example source string description text</descrip>
                <langSet xml:lang="en">
                  <tig>
                    <term>administrate</term>
                  </tig>
                </langSet>
                <langSet xml:lang="cs">
                  <tig>
                    <term>spravovat</term>
                    <note from="translator">Example translation string explanation text</note>
                  </tig>
                </langSet>
            </termEntry>
            <termEntry>
                <descrip type="Translation needed">No</descrip> <!-- mark as untranslateable -->
                <langSet xml:lang="en">
                  <tig>
                    <term>Weblate</term>
                  </tig>
                </langSet>
            </termEntry>
            <termEntry>
                <langSet xml:lang="en">
                  <tig>
                    <term>example forbidden term</term>
                    <termNote type="administrativeStatus">forbidden</termNote>
                  </tig>
                </langSet>
                <langSet xml:lang="cs">
                  <tig>
                    <term>příklad zakázaného výrazu</term>
                  </tig>
                </langSet>
            </termEntry>
        </body>
    </text>
</martif>
```

## Weblate 구성

|               | 일반적인 Weblate [구성요소 설정](https://docs.weblate.org/ko/latest/admin/projects.md#component)   |
|---------------|---------------------------------------------------------------------------------|
| 파일 마스크        | `tbx/*.tbx`                                                                     |
| 단일언어 기반 언어 파일 | 빈                                                                               |
| 신규 번역의 템플릿    | 빈                                                                               |
| 파일 형식         | TermBase eXchange 파일                                                            |
