[add] i18n glossary and normalize translations

i18n/GLOSSARY.md

@@ -0,0 +1,119 @@
+# 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) must match verbatim.
+
+The **canonical** (most frequent) variant is given.
+
+---
+
+## 1. Section labels (bold lead before a link)
+
+RichText puts the colon **inside** the bold markers (`**...:**`); zh uses a full-width colon `：`.
+
+Use the **singular** form when a single item is referenced, the **plural** form for a list of two or
+more. ko/zh have no number inflection — the same label serves both. The number must agree with the
+English source (e.g. `**Related sample:**` → singular, `**Related samples:**` → plural).
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `**Related articles:**` | `**Связанные статьи:**` | `**Verwandte Artikel:**` | `**관련 문서:**` | `**相关文章：**` |
+| `**Related sample:**` | `**Связанный пример:**` | `**Verwandtes Beispiel:**` | `**관련 샘플:**` | `**相关示例：**` |
+| `**Related samples:**` | `**Связанные примеры:**` | `**Verwandte Beispiele:**` | `**관련 샘플:**` | `**相关示例：**` |
+
+ko: `관련 샘플` is canonical for *sample(s)*; the variant `관련 예제` also occurs and should be
+normalized to `관련 샘플`.
+
+## 2. Section headings
+
+Headings keep the original English slug as a `{#...}` anchor (e.g. `### Описание {#description}`) so
+cross-page `#anchor` links stay valid — only the visible title is translated. The explicit `{#id}`
+must match the English auto-slug **exactly**, including any leading dashes for headings that begin
+with a list marker or inline code (e.g. `### - \`fire()\` → ...` keeps `{#--fire--...}`).
+
+**API-page template:**
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `### Description` | `### Описание` | `### Beschreibung` | `### 설명` | `### 描述` |
+| `### Usage` | `### Использование` | `### Verwendung` | `### 사용법` | `### 用法` |
+| `### Example` | `### Пример` | `### Beispiel` | `### 예제` | `### 示例` |
+| `### Parameters` | `### Параметры` | `### Parameter` | `### 파라미터` | `### 参数` |
+| `### Returns` | `### Возвращает` | `### Rückgabewert` | `### 반환값` | `### 返回值` |
+| `### Default config` | `### Конфигурация по умолчанию` | `### Standardkonfiguration` | `### 기본 설정` | `### 默认配置` |
+
+- ko: `파라미터` is canonical; the variants `매개변수` and untranslated `Parameters` in **headings**
+  should be normalized to `파라미터` (running prose that uses `매개변수` grammatically is left as is).
+- ko: `예제` is canonical for *Example*; the variant `예시` should be normalized to `예제`.
+- ko: `기본 설정` is canonical for *Default config*; the variant `기본 구성` should be normalized.
+- ru: `Конфигурация по умолчанию` is canonical; the shorter `Конфиг по умолчанию` should be
+  normalized.
+
+**Changelog headings (`news/whats_new.md`, `news/migration.md`):**
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `### New functionality` | `### Новые возможности` | `### Neue Funktionalität` | `### 새로운 기능` | `### 新功能` |
+| `### New API` | `### Новый API` | `### Neue API` | `### 새로운 API` | `### 新增 API` |
+| `### Updated API` | `### Обновлённый API` | `### Aktualisierte API` | `### 업데이트된 API` | `### 更新的 API` |
+| `### Fixes` | `### Исправления` | `### Fehlerbehebungen` | `### 수정 사항` | `### 修复` |
+| `### Methods migration` | `### Миграция методов` | `### Migration der Methoden` | `### 메서드 마이그레이션` | `### 方法迁移` |
+| `### Properties migration` | `### Миграция свойств` | `### Migration der Eigenschaften` | `### 프로퍼티 마이그레이션` | `### 属性迁移` |
+
+`API` stays the Latin `API` in every changelog heading (never the Cyrillic `АПИ`).
+
+**Navigation heading:**
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `## What's next` | `## Что дальше` | `## Wie geht es weiter?` | `## 다음 단계` | `## 下一步` |
+
+## 3. Admonition block titles (`:::note`, `:::tip` …)
+
+RichText sets these titles **explicitly in markdown** via the `:::type[Title]` syntax (e.g.
+`:::note[Примечание]`), so the visible title comes from the `.md` file, not the theme defaults. The
+block **type** (`:::note`, `:::tip`, …) is never translated — only the bracketed `[Title]` is.
+
+The same wording is mirrored in the `theme.admonition.*` keys of `i18n/<locale>/code.json` (the
+fallback for any block without an explicit title); the two must stay in sync. Canon: **capitalized
+first letter**, with each type distinct (no `caution`/`warning` duplicates).
+
+| Type | ru | de | ko | zh |
+|---|---|---|---|---|
+| `:::note` | `Примечание` | `Hinweis` | `참고` | `注意` |
+| `:::tip` | `Совет` | `Tipp` | `팁` | `提示` |
+| `:::info` | `Информация` | `Info` | `정보` | `信息` |
+| `:::warning` | `Предупреждение` | `Warnung` | `경고` | `警告` |
+| `:::caution` | `Осторожно` | `Vorsicht` | `주의` | `谨慎` |
+| `:::important` | `Важно` | `Wichtig` | `중요` | `重要` |
+| `:::danger` | `Опасно` | `Gefahr` | `위험` | `危险` |
+
+## 4. Do not translate
+
+Keep these terms in English (Latin script) across all locales.
+
+**Product & modules:**
+- `RichText` — the widget/product name (e.g. "DHTMLX RichText"). *The generic concept* — rich text —
+  may be localized; only the product/widget name stays `RichText`.
+- `DHTMLX`, `dhx` (the `dhx.*` code namespace)
+- `Event Bus` — the module name. Keep the English spelling; German may hyphenate it inside a compound
+  (`Event-Bus-Methoden`). Do not localize it (ru `шина событий`, zh `事件总线` → `Event Bus`).
+
+**Frameworks & libraries:**
+- `React`, `Vue`, `Svelte`, `Angular`
+
+**Runtime, languages & tooling:**
+- `Node.js`, `Vite`
+- `JavaScript`, `TypeScript`
+- `npm`, `yarn`, `CLI`
+
+**Data formats:**
+- `JSON`
+
+**Services:**
+- `GitHub`, `CDN`
+
+**Other:**
+- `API` — always the Latin `API`, never the Cyrillic transliteration `АПИ`.
+- Code identifiers (method / config / event names, `dhx.*`) inside backticks are never translated.

i18n/de/code.json

@@ -139,23 +139,23 @@
     "description": "The label alongside a tag list"
   },
   "theme.admonition.caution": {
-    "message": "vorsicht",
+    "message": "Vorsicht",
     "description": "The default label used for the Caution admonition (:::caution)"
   },
   "theme.admonition.danger": {
-    "message": "gefahr",
+    "message": "Gefahr",
     "description": "The default label used for the Danger admonition (:::danger)"
   },
   "theme.admonition.info": {
     "message": "Info",
     "description": "The default label used for the Info admonition (:::info)"
   },
   "theme.admonition.note": {
-    "message": "hinweis",
+    "message": "Hinweis",
     "description": "The default label used for the Note admonition (:::note)"
   },
   "theme.admonition.tip": {
-    "message": "tipp",
+    "message": "Tipp",
     "description": "The default label used for the Tip admonition (:::tip)"
   },
   "theme.admonition.warning": {

i18n/de/docusaurus-plugin-content-docs/current/how_to_start.md

@@ -104,6 +104,6 @@ const editor = new richtext.Richtext("#root", {
 });
 ~~~
 
-## Wie geht es weiter {#whats-next}
+## Wie geht es weiter? {#whats-next}
 
 Das war es schon. Nur drei einfache Schritte, und Sie verfügen über ein praktisches Werkzeug zur Bearbeitung von Inhalten. Jetzt können Sie mit Ihren Inhalten arbeiten oder die Welt von JavaScript RichText weiter erkunden.

i18n/de/docusaurus-plugin-content-docs/current/news/whats_new.md

@@ -20,7 +20,7 @@ Veröffentlicht am 22. Juni 2026
 - Tastenkürzel zum Löschen auf Wort- und Zeilenebene: vorheriges/nächstes Wort löschen mit `Ctrl+Backspace` / `Ctrl+Delete` (Windows/Linux) oder `Opt+Backspace` / `Opt+Delete` (macOS); vorherige/nächste visuelle Zeile löschen mit `Cmd+Backspace` / `Cmd+Delete` (nur macOS)
 - Neue Tastenkürzel zum Ändern der Blockeinrückung: die Einrückung eines Blocks mit `Tab` vergrößern und mit `Shift+Tab` verringern; in Listen verschachteln dieselben Tasten Elemente oder heben sie an
 
-###  Neue API {#new-api}
+### Neue API {#new-api}
 
 #### Neue Eigenschaften {#new-properties}
 
@@ -53,7 +53,7 @@ Veröffentlicht am 28. Mai 2026
 - Beenden einer Liste oder Verringern der Verschachtelung durch Drücken von Enter in einem leeren Listenelement
 - Eigene Farbe für besuchte Links
 
-###  Neue API {#new-api-206}
+### Neue API {#new-api-206}
 
 #### Neue Events {#new-events-206}
 
@@ -180,7 +180,7 @@ Die API von v1.2 ist nicht kompatibel mit v2.0. Weitere Informationen finden Sie
 - **Tastaturkürzel**  
   Erweiterte Unterstützung für gängige Formatierungs- und Bearbeitungskürzel
 
-###  Neue API {#new-api-20}
+### Neue API {#new-api-20}
 
 #### Neue Eigenschaften {#new-properties-20}
 

i18n/ko/code.json

@@ -151,7 +151,7 @@
     "description": "The default label used for the Info admonition (:::info)"
   },
   "theme.admonition.note": {
-    "message": "노트",
+    "message": "참고",
     "description": "The default label used for the Note admonition (:::note)"
   },
   "theme.admonition.tip": {

i18n/ko/docusaurus-plugin-content-docs/current/api/config/layout-mode.md

@@ -18,7 +18,7 @@ layoutMode: "classic" | "document";
 
 `"classic"` 모드는 전체 편집 영역을 채웁니다. `"document"` 모드는 편집 영역을 문서 페이지 형태로 표시합니다.
 
-### 기본 구성 {#default-config}
+### 기본 설정 {#default-config}
 
 ~~~jsx
 layoutMode: "classic";
@@ -38,4 +38,4 @@ new richtext.Richtext("#root", {
 
 **관련 문서:** [구성](guides/configuration.md)
 
-**관련 예제:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
+**관련 샘플:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)

i18n/ko/docusaurus-plugin-content-docs/current/api/config/trigger-template.md

@@ -20,7 +20,7 @@ function triggerTemplate({ data, trigger }) {
 };
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 callback 함수는 다음 매개변수를 가진 객체를 받습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/config/value.md

@@ -33,4 +33,4 @@ new richtext.Richtext("#root", {
 
 **관련 문서:** [구성](guides/configuration.md)
 
-**관련 예제:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
+**관련 샘플:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)

i18n/ko/docusaurus-plugin-content-docs/current/api/events/align.md

@@ -18,7 +18,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 align 이
 }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `align` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/export.md

@@ -23,7 +23,7 @@ interface IExportOptions {
 }
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `export` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/import.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 import 이
 "import": ({ html?: string }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `import` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/indent.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 indent 이
 "indent": ({ step: number }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `indent` 이벤트의 callback은 다음 매개변수를 포함한 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/insert-link.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 insert-link 이벤트
 "insert-link": ({ url: string }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `insert-link` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/insert-list.md

@@ -18,7 +18,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 insert-list
 type TListType = "bulleted" | "numbered";
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `insert-list` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/insert-token.md

@@ -28,7 +28,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 insert-toke
 }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `insert-token` 이벤트의 callback은 다음 필드를 포함하는 객체를 받습니다.
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/outdent.md

@@ -26,7 +26,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 outdent 이벤트에
 내부 이벤트를 처리하려면 [**Event Bus 메서드**](api/overview/event_bus_methods_overview.md)를 사용하십시오.
 :::
 
-### 예시 {#example}
+### 예제 {#example}
 
 ~~~jsx {5-9}
 // RichText 초기화

i18n/ko/docusaurus-plugin-content-docs/current/api/events/resize-image.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 resize-image 이벤
 "resize-image": ({ id: number, width: number, height: number }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `resize-image` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/set-font-family.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 set-font-family 이
 "set-font-family": ({ fontFamily: string }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `set-font-family` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/set-line-height.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 set-line-height 이
 "set-line-height": ({ lineHeight: string }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `set-line-height` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/set-text-color.md

@@ -21,7 +21,7 @@ interface ITextColor {
 }
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `set-text-color` 이벤트의 callback은 다음 매개변수를 포함한 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/set-text-style.md

@@ -18,7 +18,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 set-text-st
 type TBlockType = "p" | "blockquote" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `set-text-style` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/show-popup.md

@@ -21,7 +21,7 @@ interface IPopupConfig {
 }
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `show-popup` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/show-suggest.md

@@ -28,7 +28,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 show-sugges
 }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `show-suggest` 이벤트의 callback은 다음 필드를 포함하는 객체를 수신합니다.
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/toggle-fullscreen-mode.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 toggle-full
 "toggle-fullscreen-mode": ({ mode?: boolean }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `toggle-fullscreen-mode` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 
@@ -26,7 +26,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 toggle-full
 내부 이벤트를 처리하려면 [**Event Bus 메서드**](api/overview/event_bus_methods_overview.md)를 사용할 수 있습니다
 :::
 
-### 예시 {#example}
+### 예제 {#example}
 
 ~~~jsx {5-9}
 // RichText 초기화

i18n/ko/docusaurus-plugin-content-docs/current/api/events/toggle-layout-mode.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리 문서에서 toggle-layo
 "toggle-layout-mode": ({ mode?: "classic" | "document" }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `toggle-layout-mode` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/toggle-shortcut-info.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript RichText 라이브러리의 toggle-shortcut-info
 "toggle-shortcut-info": ({ mode?: boolean }) => boolean | void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `toggle-shortcut-info` 이벤트의 callback은 다음 매개변수를 포함하는 객체를 받을 수 있습니다: