[add] i18n glossary and normalize translations

- add i18n/GLOSSARY.md with canonical template phrases for ru/de/ko/zh
  (section labels, headings, changelog/nav headings, admonition titles,
  do-not-translate terms), adapted to RichText conventions

- unify theme.admonition.* in code.json across locales: capitalize
  ru/de, sync with the explicit markdown titles, drop caution/warning
  duplicates (ru caution→Осторожно, danger→Опасно; de nouns capitalized;
  ko note→참고; zh note→注意, caution→谨慎)

- normalize headings: ru Конфиг по умолчанию→Конфигурация по умолчанию,
  Применение→Использование; ko 매개변수→파라미터, 예시→예제,
  기본 구성→기본 설정, 관련 예제→관련 샘플; de fix "Wie geht es weiter?"
  and double-space "Neue API" (anchors untouched)

- enforce do-not-translate terms: ru АПИ→API (99), шину событий→Event Bus;
  zh 事件总线方法→Event Bus 方法

Author: serhiipylypchuk1991

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은 다음 매개변수를 포함하는 객체를 받을 수 있습니다: