Skip to content
Merged

Next #58

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
107 changes: 107 additions & 0 deletions i18n/GLOSSARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
# Translation Glossary — All documentation template phrases

Purpose: a single reference for translations of recurring template phrases in the documentation
([../docs/](../docs/)). Consult it when translating new articles and when reviewing localizations —
the wording and markdown markup (`**...**`, `### ...`, full-width `:` for zh/ko) must match verbatim.

The **canonical** (most frequent) variant is given.

---

## 1. Section labels (bold lead before a list)

| EN | ru | de | ko | zh |
|---|---|---|---|---|
| `**Related articles:**` | `**Полезные статьи:**` | `**Verwandte Artikel:**` | `**관련 문서:**` | `**相关文章:**` |
| `**Related article:**` | `**Полезная статья:**` | `**Verwandter Artikel:**` | `**관련 문서:**` | `**相关文章:**` |
| `**Related sample:**` | `**Связанный пример:**` | `**Verwandtes Beispiel:**` | `**관련 샘플:**` | `**相关示例:**` |
| `**Related samples:**` | `**Связанные примеры:**` | `**Verwandte Beispiele:**` | `**관련 예제:**` | `**相关示例:**` |
| `**Related API:**` | `**Похожее API:**` | `**Verwandte API:**` | `**관련 API:**` | `**相关 API:**` |
| `**Change log:**` | `**Журнал изменений:**` | `**Changelog:**` | `**변경 로그:**` | `**更新日志:**` |
| `**Example:**` | `**Пример:**` | `**Beispiel:**` | `**예제:**` | `**示例:**` |
| `**Example on GitHub**` | `**Пример на GitHub**` | `**Beispiel auf GitHub**` | `**GitHub 예제**` | `**GitHub 示例**` |

## 2. Section headings (API-page template)

| EN | ru | de | ko | zh |
|---|---|---|---|---|
| `### Description` | `### Описание` | `### Beschreibung` | `### 설명` | `### 描述` |
| `### Usage` | `### Использование` | `### Verwendung` | `### 사용법` | `### 用法` |
| `### Example` | `### Пример` | `### Beispiel` | `### 예제` | `### 示例` |
| `### Parameters` | `### Параметры` | `### Parameter` | `### 매개변수` | `### 参数` |
| `### Returns` | `### Возвращаемое значение` | `### Rückgabewert` | `### 반환값` | `### 返回值` |
| `### Fixes` | `### Исправления` | `### Fehlerbehebungen` | `### 수정 사항` | `### 修复` |
| `### New functionality` | `### Новый функционал` | `### Neue Funktionalität` | `### 새로운 기능` | `### 新功能` |
| `### Updates` | `### Обновления` | `### Aktualisierungen` | `### 업데이트` | `### 更新` |
| `### Default config` | `### Конфигурация по умолчанию` | `### Standardkonfiguration` | `### 기본 설정` | `### 默认配置` |
| `### Breaking changes` | `### Критические изменения` | `### Breaking Changes` | `### 주요 변경 사항` | `### 重大变更` |
| `## Related API and guides` | `## Связанные API и гайды` | `## Verwandte API und Anleitungen` | `## 관련 API 및 가이드` | `## 相关 API 和指南` |
| `## What's next` | `## Что дальше` | `## Wie geht es weiter` | `## 다음 단계` | `## 下一步` |
| `## API reference` | `## Справочник API` | `## API-Referenz` | `## API 참조` | `## API 参考` |

## 3. Version notes (inside `**Change log:**`)

Format `<Action> in vX.X` — the "action" word is translated, the version number stays as is.

The forms below are verified against actual occurrences in the locales (e.g. `Добавлено в v5.2`,
`v5.2에서 추가`, `v5.2 中新增`). The version number is not translated.

| EN | ru | de | ko | zh |
|---|---|---|---|---|
| `Added in vX.X` | `Добавлено в vX.X` | `Hinzugefügt in vX.X` | `vX.X에서 추가` | `vX.X 中新增` |
| `Updated in vX.X` | `Обновлено в vX.X` | `Aktualisiert in vX.X` | `vX.X에서 업데이트` | `vX.X 中更新` |
| `Deprecated in vX.X` | `Устарело в vX.X` | `Veraltet in vX.X` | `vX.X에서 지원 중단` | `vX.X 中弃用` |
| `Removed in vX.X` | `Удалено в vX.X` | `Entfernt in vX.X` | `vX.X에서 제거` | `vX.X 中移除` |
| `Starting from vX.X, …` | `Начиная с vX.X, …` | `Ab vX.X …` | `vX.X부터 …` | `从 vX.X 起,…` |

## 4. Admonition block titles (`:::note`, `:::tip` …)

The titles of these blocks come **not from markdown**, but from the `theme.admonition.*` keys in
`i18n/<locale>/code.json` (in EN — Docusaurus built-in defaults). In `.md` the block type (`:::note`,
`:::tip`, …) is not translated — only the `message` in `code.json` changes.

The Docusaurus theme renders the title with `text-transform: uppercase`, so for ru/de the visible
title is always UPPERCASE, while ko/zh have no letter case. Canon: **capitalized first letter**, with
words distinct between types (no `caution`/`warning` duplicates).

| Type | ru | de | ko | zh |
|---|---|---|---|---|
| `:::note` | `Примечание` | `Hinweis` | `노트` | `备注` |
| `:::tip` | `Подсказка` | `Tipp` | `팁` | `提示` |
| `:::info` | `К сведению` | `Info` | `정보` | `信息` |
| `:::warning` | `Предупреждение` | `Warnung` | `경고` | `警告` |
| `:::caution` | `Осторожно` | `Vorsicht` | `주의` | `注意` |
| `:::danger` | `Опасно` | `Gefahr` | `위험` | `危险` |

## 5. Do not translate

Keep these terms in English across all locales (verified: identical counts in ru/de/ko/zh).

**Product & modules:**
- `Spreadsheet` — the widget/product name. *The generic concept* "spreadsheet" may be localized
(e.g. zh `电子表格`), but the product name stays `Spreadsheet`.
- `DHTMLX`, `dhx` (the `dhx.*` code namespace)
- `Sheet Manager`, `Event Bus`

**Frameworks & libraries:**
- `React`, `Vue`, `Svelte`, `Angular`
- `Node.js`, `Vite`
- `Redux`, `Redux Toolkit`

**Languages & tooling:**
- `JavaScript`, `TypeScript`
- `npm`, `yarn`, `CLI`

**Data formats:**
- `Excel`, `XLSX`, `CSV`, `JSON`

**Services:**
- `GitHub`, `CDN`

**Other:**
- `API`
- Code identifiers (method / config / event names, `dhx.*`) inside backticks are never translated.

> Not in this list — these UI concepts **are** localized (keep English only for a literal UI label):
> `Toolbar` (→ ru "панель инструментов"), `Menu` (→ "меню"), `Fill Handle` (→ "маркер заполнения"),
> `context menu`.
2 changes: 1 addition & 1 deletion i18n/de/docusaurus-plugin-content-docs/current/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ Die Daten in der Tabelle werden so angezeigt, wie sie im Konfigurationsbereich e

![Sortieren von Daten nach Spaltenüberschrift in der DHTMLX Pivot-Tabelle](/img/table.png)

## Nächste Schritte {#whats-next}
## Wie geht es weiter {#whats-next}

Jetzt können Sie mit der Integration von Pivot in Ihre Anwendung beginnen. Folgen Sie den Anweisungen im Tutorial [Erste Schritte](how-to-start.md).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Neue Eigenschaften sind keine vollständige Duplikate der vorherigen, sondern bi
- [layout](https://docs.dhtmlx.com/pivot/1-5/api__pivot_layout_config.html) -> [columnShape](api/config/columnshape-property.md), [headerShape](api/config/headershape-property.md), [readonly](api/config/readonly-property.md)
- [customFormat](https://docs.dhtmlx.com/pivot/1-5/api__pivot_customformat_config.html) -> [predicates](api/config/predicates-property.md) - benutzerdefinierte Vorverarbeitungsfunktionen für Daten

#### Events {#events}
#### Ereignisse {#events}

- [filterApply](https://docs.dhtmlx.com/pivot/1-5/api__pivot_filterapply_event.html) -> [apply-filter](api/events/apply-filter-event.md)
- [fieldClick](https://docs.dhtmlx.com/pivot/1-5/api__pivot_fieldclick_event.html) -> es gibt kein identisches Event, aber Sie können [update-field](api/events/update-field-event.md) verwenden
Expand Down
2 changes: 1 addition & 1 deletion i18n/ko/docusaurus-plugin-content-docs/current.json
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
"description": "The generated-index page title for category 'Pivot internal API' in sidebar 'docs'"
},
"sidebar.docs.category.Event Bus methods": {
"message": "이벤트 버스 메서드",
"message": "Event Bus 메서드",
"description": "The label for category 'Event Bus methods' in sidebar 'docs'"
},
"sidebar.docs.category.State methods": {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,6 @@ const table = new pivot.Pivot("#root", {
});
~~~

**관련 샘플**:
**관련 예제**:
- [Pivot 2. 자동 너비 - 콘텐츠에 맞게 열 크기 조정](https://snippet.dhtmlx.com/tn1yw14m)
- [Pivot 2. 열 너비 설정](https://snippet.dhtmlx.com/ceu34kkn)
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ new pivot.Pivot("#pivot", {
});
~~~

**관련 샘플**:
**관련 예제**:
- [Pivot 2. 그리드 헤더의 세로 텍스트 방향](https://snippet.dhtmlx.com/4qroi8ka)
- [Pivot 2. 접을 수 있는 열](https://snippet.dhtmlx.com/pt2ljmcm)
- [Pivot 2. 테이블 및 헤더 셀에 사용자 정의 CSS 추가](https://snippet.dhtmlx.com/nfdcs4i2)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,9 @@ limits?: {
};
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

파라미터는 데이터 렌더링을 중단할 시점을 정의합니다:
매개변수는 데이터 렌더링을 중단할 시점을 정의합니다:

- `rows` - (선택 사항) 최종 데이터셋의 최대 행 수를 설정합니다. 기본값은 10000입니다.
- `columns` - (선택 사항) 최종 데이터셋의 최대 열 수를 설정합니다. 기본값은 5000입니다.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ methods?: {
};
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

각 메서드는 키-값 쌍으로 표현되며, `method`는 메서드의 이름이고 값은 해당 메서드의 동작을 설명하는 객체입니다. 각 객체에는 다음과 같은 파라미터가 있습니다:
각 메서드는 키-값 쌍으로 표현되며, `method`는 메서드의 이름이고 값은 해당 메서드의 동작을 설명하는 객체입니다. 각 객체에는 다음과 같은 매개변수가 있습니다:

- `handler` - (사용자 정의 메서드에 필수) 숫자 배열에서 집계 값을 계산하는 함수로, 값 배열을 입력으로 받아 단일 값을 반환합니다
- `type` - (선택 사항) 이 메서드가 적용되는 데이터 타입으로, "number", "date", "text" 또는 이들의 배열로 지정할 수 있습니다
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ description: DHTMLX JavaScript Pivot 라이브러리 문서에서 readonly 설
readonly?: boolean;
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

이 속성은 **true** 또는 **false**로 설정할 수 있습니다:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ const table = new pivot.Pivot("#root", {
});
~~~

**관련 샘플**:
**관련 예제**:

- [Pivot 2. 트리 모드](https://snippet.dhtmlx.com/6ylkoukn)
- [Pivot 2. 고정 열](https://snippet.dhtmlx.com/lahf729o)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ description: DHTMLX JavaScript Pivot 라이브러리 문서에서 delete-field
}) => boolean | void;
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

액션의 콜백은 다음 파라미터를 포함하는 객체를 받습니다:
액션의 콜백은 다음 매개변수를 포함하는 객체를 받습니다:

- `area` - (필수) 필드가 제거되는 영역의 이름으로, "rows", "columns" 또는 "values" 영역이 될 수 있습니다
- `id` - (필수) 제거되는 필드의 id
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,6 @@ function closeAll() {

`render-table` 이벤트를 사용하여 열 고정 기능을 구성하는 방법도 참조하세요: [열 고정](guides/configuration.md#freezing-columns).

**관련 **: [pivot.template 헬퍼](api/helpers/template.md)
**관련 문서**: [pivot.template 헬퍼](api/helpers/template.md)

**관련 샘플**: [Pivot 2. 커스텀 고정(고정) 열 (사용자 지정 수)](https://snippet.dhtmlx.com/53erlmgp)
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,9 @@ pivot.template({value, method, row, column}) => string;
pivot.template({value, field, method, cell, column}) => string;
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

본문 셀의 경우 함수는 다음 파라미터를 받습니다:
본문 셀의 경우 함수는 다음 매개변수를 받습니다:

- `value` (any) - (필수) 셀의 원시 값
- `method` (string) - (필수) 열에 사용되는 메서드 또는 predicate
Expand Down Expand Up @@ -54,7 +54,7 @@ pivot.template({value, field, method, cell, column}) => string;
- `method` (string) - (필수) 셀이 "columns" 영역에 속하고 predicate가 정의된 경우의 필드 predicate
- `format` (string or object) - 날짜 형식 또는 숫자 형식 ([필드에 형식 적용](guides/working-with-data.md#applying-formats-to-fields) 참조)

헤더 셀의 경우 함수 파라미터는 다음과 같습니다:
헤더 셀의 경우 함수 매개변수는 다음과 같습니다:

- `value` (any) - (필수) 셀의 원시 값
- `method` (string) - (선택) 열에 사용되는 predicate
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ api.getState(): object;

### 반환값 {#returns}

이 메서드는 다음 파라미터를 포함하는 객체를 반환합니다:
이 메서드는 다음 매개변수를 포함하는 객체를 반환합니다:

~~~jsx
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,4 +65,4 @@ table.api.intercept("render-table", (ev) => {
}, {tag: "render-table-tag"});
~~~

**관련 아티클**: [`render-table`](api/events/render-table-event.md)
**관련 문서**: [`render-table`](api/events/render-table-event.md)
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@ api.on(
): void;
~~~

### 파라미터 {#parameters}
### 매개변수 {#parameters}

- `event` - (필수) 발생시킬 이벤트
- `handler` - (필수) 연결할 핸들러 (핸들러 인수는 발생하는 이벤트에 따라 달라집니다)
- `config` - (선택) 다음 파라미터를 저장하는 객체:
- `config` - (선택) 다음 매개변수를 저장하는 객체:
- `intercept` - (선택) 이벤트 리스너 생성 시 `intercept: true`를 설정하면, 해당 이벤트 리스너가 다른 모든 리스너보다 먼저 실행됩니다
- `tag` - (선택) 액션 태그. 태그 이름을 사용하여 [`detach`](api/internal/detach-method.md) 메서드로 액션 핸들러를 제거할 수 있습니다

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,14 @@ description: DHTMLX JavaScript Pivot 라이브러리 문서에서 JavaScript Piv

~~~jsx
new pivot.Pivot("#root", {
// 구성 파라미터
// 구성 매개변수
});
~~~

**파라미터**:
**매개변수**:

- HTML 컨테이너 (HTML 컨테이너의 ID)
- 구성 파라미터 객체 ([여기서 확인](#pivot-properties))
- 구성 매개변수 객체 ([여기서 확인](#pivot-properties))

## Pivot 메서드 {#pivot-methods}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Table 이벤트를 트리거하려면 [`getTable`](api/methods/gettable-method.m
}) => boolean|void;
```

Table 위젯의 `export` 액션에는 필요에 따라 구성할 수 있는 다음과 같은 파라미터가 있습니다:
Table 위젯의 `export` 액션에는 필요에 따라 구성할 수 있는 다음과 같은 매개변수가 있습니다:

- `options` - 내보내기 옵션이 담긴 객체입니다. 옵션은 형식 유형에 따라 다릅니다
- `result` - 내보낸 Excel 또는 CSV 데이터의 결과값입니다 (일반적으로 `download` 옵션에 따라 Blob 또는 파일 형태입니다)
Expand Down Expand Up @@ -84,9 +84,9 @@ Table 위젯의 `export` 액션에는 필요에 따라 구성할 수 있는 다
- `cell` - 본문 셀에 대한 스타일 속성입니다. *header*와 동일한 속성을 사용합니다
- `firstFooterCell` - 푸터 셀의 첫 번째 행에 대한 스타일 속성입니다. *header*와 동일한 속성을 사용합니다
- `footer` - 푸터 셀에 대한 스타일 속성입니다. *header*와 동일한 속성을 사용합니다
- `cellTemplate` - 각 셀의 내보내기 값을 커스터마이즈하는 함수입니다. value, row, column 객체를 파라미터로 받아 내보낼 커스텀 값을 반환합니다
- `cellTemplate` - 각 셀의 내보내기 값을 커스터마이즈하는 함수입니다. value, row, column 객체를 매개변수로 받아 내보낼 커스텀 값을 반환합니다
- `headerCellTemplate` - 내보내기 시 헤더 또는 푸터 셀의 값을 커스터마이즈하는 함수입니다. text, 헤더 셀 객체, column 객체, 셀 유형("header" 또는 "footer")을 인수로 받아 내보낼 헤더/푸터 값을 수정할 수 있습니다
- `cellStyle` - 내보내기 시 개별 셀의 스타일과 형식을 커스터마이즈할 수 있는 함수입니다. value, row, column 객체를 파라미터로 받아 스타일 속성(예: 정렬 또는 형식)이 담긴 객체를 반환해야 합니다
- `cellStyle` - 내보내기 시 개별 셀의 스타일과 형식을 커스터마이즈할 수 있는 함수입니다. value, row, column 객체를 매개변수로 받아 스타일 속성(예: 정렬 또는 형식)이 담긴 객체를 반환해야 합니다
- `headerCellStyle` - `cellStyle`과 유사하지만 헤더 및 푸터 셀에 특화된 함수입니다. text, 헤더 셀 객체, column 객체, 유형("header" 또는 "footer")을 받아 스타일 속성을 반환합니다
:::note
기본적으로 "xlsx" 형식의 경우 날짜 및 숫자 필드는 기본 형식 또는 [`fields`](api/config/fields-property.md) 속성을 통해 정의된 형식의 원시 값으로 내보내집니다. 단, 필드에 템플릿이 정의된 경우([`tableShape`](api/config/tableshape-property.md) 속성 참고) 해당 템플릿에서 정의된 렌더링 값으로 내보냅니다. 템플릿과 `format`이 모두 설정된 경우, 템플릿 설정이 형식 설정보다 우선 적용됩니다.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ Table 이벤트를 발생시키려면 [`getTable`](api/methods/gettable-method.m

<iframe src="https://snippet.dhtmlx.com/s7tc9g4z?mode=result" frameborder="0" class="snippet_iframe" width="100%" height="600"></iframe>

**관련 **: [`getTable`](api/methods/gettable-method.md)
**관련 문서**: [`getTable`](api/methods/gettable-method.md)
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,6 @@ Table 이벤트를 트리거하려면 [`getTable`](api/methods/gettable-method.m

<iframe src="https://snippet.dhtmlx.com/i4mi6ejn?mode=result" frameborder="0" class="snippet_iframe" width="100%" height="600"></iframe>

**관련 아티클**:
**관련 문서**:
- [`getTable`](api/methods/gettable-method.md)
- [모든 행 펼치기/접기](guides/configuration.md#expandingcollapsing-all-rows)
Loading
Loading