[add] i18n glossary and unify admonition titles

docs/api/config/booking-data.md

@@ -130,4 +130,4 @@ new booking.Booking("#root", {
 });
 ~~~
 
-**Related articles**: [Defining slot rules](guides/configuration.md#define-slot-rules)
+**Related article**: [Defining slot rules](guides/configuration.md#define-slot-rules)

docs/api/events/booking-confirmslot-event.md

@@ -57,4 +57,4 @@ widget.api.on("confirm-slot", (obj) => {
 });
 ~~~
 
-**Related articles**: [`setConfirmHandler`](api/methods/booking-setconfirmhandler-method.md) method
+**Related article**: [`setConfirmHandler`](api/methods/booking-setconfirmhandler-method.md) method

docs/api/internal/booking-setnext.md

@@ -38,4 +38,4 @@ fetch(server + "/data").then((res) => res.json()).then((data) => {
 widget.api.setNext(someServerService);
 ~~~
 
-**Related articles**: [Loading data](guides/loading-data.md)
+**Related article**: [Loading data](guides/loading-data.md)

docs/api/methods/booking-setconfirmhandler-method.md

@@ -35,4 +35,4 @@ widget.setConfirmHandler((ev) => {
 
 <iframe src="https://snippet.dhtmlx.com/dpbmyr8j?mode=result" frameborder="0" class="snippet_iframe" width="100%" height="600"></iframe>
 
-**Related articles**: [Saving reservations to the server](guides/saving-reservations.md)
+**Related article**: [Saving reservations to the server](guides/saving-reservations.md)

i18n/GLOSSARY.md

@@ -0,0 +1,104 @@
+# 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 list)
+
+The colon stays **outside** the bold markers (`**...**:`); zh uses a full-width colon `：`.
+
+Use the **singular** form when a single article is listed, 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
+number of links in the block.
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `**Related articles**:` | `**Связанные статьи**:` | `**Verwandte Artikel**:` | `**관련 문서**:` | `**相关文章**：` |
+| `**Related article**:` | `**Связанная статья**:` | `**Verwandter Artikel**:` | `**관련 문서**:` | `**相关文章**：` |
+
+## 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.
+
+**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` also occur and
+should be normalized to `파라미터`.
+
+**Changelog headings (`news/whats_new.md`):**
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `### New functionality` | `### Новая функциональность` | `### Neue Funktionalität` | `### 새로운 기능` | `### 新功能` |
+| `### Initial functionality` | `### Начальная функциональность` | `### Initiale Funktionalität` | `### 초기 기능` | `### 初始功能` |
+| `### Fixes` | `### Исправления` | `### Fehlerbehebungen` | `### 수정 사항` | `### 修复` |
+
+**Navigation heading:**
+
+| EN | ru | de | ko | zh |
+|---|---|---|---|---|
+| `## What's next` | `## Что дальше` | `## Wie geht es weiter?` | `## 다음 단계` | `## 下一步` |
+
+## 3. 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.
+
+**Product & modules:**
+- `Booking` — the widget/product name (e.g. "DHTMLX Booking"). *The generic concept* — the act of
+  booking/reserving — may be localized (ru `бронирование`, ko `예약`, zh `预约`); only the product name
+  stays `Booking`.
+- `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`).
+
+**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,27 +139,27 @@
     "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": {
-    "message": "warnung",
+    "message": "Warnung",
     "description": "The default label used for the Warning admonition (:::warning)"
   },
   "theme.AnnouncementBar.closeButtonAriaLabel": {

i18n/de/docusaurus-plugin-content-docs/current/api/config/booking-data.md

@@ -130,4 +130,4 @@ new booking.Booking("#root", {
 });
 ~~~
 
-**Verwandte Artikel**: [Slot-Regeln definieren](guides/configuration.md#define-slot-rules)
+**Verwandter Artikel**: [Slot-Regeln definieren](guides/configuration.md#define-slot-rules)

i18n/de/docusaurus-plugin-content-docs/current/api/events/booking-confirmslot-event.md

@@ -57,4 +57,4 @@ widget.api.on("confirm-slot", (obj) => {
 });
 ~~~
 
-**Verwandte Artikel**: [`setConfirmHandler`](api/methods/booking-setconfirmhandler-method.md)-Methode
+**Verwandter Artikel**: [`setConfirmHandler`](api/methods/booking-setconfirmhandler-method.md)-Methode

i18n/de/docusaurus-plugin-content-docs/current/api/internal/booking-setnext.md

@@ -38,4 +38,4 @@ fetch(server + "/data").then((res) => res.json()).then((data) => {
 widget.api.setNext(someServerService);
 ~~~
 
-**Verwandte Artikel**: [Daten laden](guides/loading-data.md)
+**Verwandter Artikel**: [Daten laden](guides/loading-data.md)

i18n/de/docusaurus-plugin-content-docs/current/api/methods/booking-setconfirmhandler-method.md

@@ -35,4 +35,4 @@ widget.setConfirmHandler((ev) => {
 
 <iframe src="https://snippet.dhtmlx.com/dpbmyr8j?mode=result" frameborder="0" class="snippet_iframe" width="100%" height="600"></iframe>
 
-**Verwandte Artikel**: [Reservierungen auf dem Server speichern](guides/saving-reservations.md)
+**Verwandter Artikel**: [Reservierungen auf dem Server speichern](guides/saving-reservations.md)

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

@@ -24,7 +24,7 @@ cardShape?: {
 };
 ~~~
 
-### Parameters {#parameters}
+### 파라미터 {#parameters}
 
 `cardShape` 객체에서 다음 parameters(필드)를 지정할 수 있습니다:
 

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

@@ -29,7 +29,7 @@ filterShape: {
 };
 ~~~
 
-### Parameters {#parameters}
+### 파라미터 {#parameters}
 
 - `text` - (선택 사항) `true`이면 텍스트 입력 필드가 표시됩니다(기본값). `false`이면 텍스트 필드가 숨겨집니다.
   - `id` - (필수) 필터링할 카드 필드의 이름 (`data` 속성으로, 예: `category` 또는 `title`)

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

@@ -34,7 +34,7 @@ formShape: [{
 - `validation` - (선택 사항) 필드 값을 인수로 받아 boolean을 반환하는 함수입니다. 함수가 `true`를 반환하면 해당 필드는 유효한 것으로 간주됩니다.
 - `errorMessage` - (선택 사항) 값이 유효성 검사를 통과하지 못했을 때 표시되는 메시지
 
-### 기본 구성 {#default-config}
+### 기본 설정 {#default-config}
 
 ~~~jsx {}
 const defaultFormShape = [

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

@@ -22,7 +22,7 @@ infoShape?: {
 };
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 객체에는 다음 매개변수가 있습니다:
 

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

@@ -18,7 +18,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 renderType
 renderType?: "default" | "lazy";
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 - `default` - 위젯에 로드된 모든 카드를 렌더링합니다 (기본값으로 설정됨)
 - `lazy` - 화면에 보이는 카드만 렌더링합니다

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

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 시작 날
 start?: Date;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 - `Date` - (선택 사항) 사용 가능한 슬롯을 표시하기 시작할 날짜입니다. 기본값은 현재 날짜입니다.
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/booking-confirmslot-event.md

@@ -29,7 +29,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 confirm-slot
 }) => void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 `confirm-slot` 이벤트의 callback은 다음 매개변수를 가진 객체를 받을 수 있습니다:
 

i18n/ko/docusaurus-plugin-content-docs/current/api/events/booking-filterdata-event.md

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

i18n/ko/docusaurus-plugin-content-docs/current/api/events/booking-selectitemdate-event.md

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

i18n/ko/docusaurus-plugin-content-docs/current/api/internal/booking-detach.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 detach 메
 api.detach(tag: number | string ): void;
 ~~~
 
-### Parameters {#parameters}
+### 파라미터 {#parameters}
 
 - `tag` - (필수) 액션 태그의 이름
 

i18n/ko/docusaurus-plugin-content-docs/current/api/internal/booking-exec.md

@@ -21,7 +21,7 @@ api.exec(
 ): Promise<any>;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 - `event` - (필수) 실행할 이벤트
 - `config` - (필수) 매개변수가 포함된 config 객체 (실행할 이벤트를 참조하세요)

i18n/ko/docusaurus-plugin-content-docs/current/api/internal/booking-setnext.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 setNext 메
 api.setNext(next: any): void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 - `next` - (필수) **Event Bus** 순서에 포함될 동작
 

i18n/ko/docusaurus-plugin-content-docs/current/api/methods/booking-setconfirmhandler-method.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 setConfirmHa
 setConfirmHandler(confirmHandler: (ev) => any): void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 이 메서드는 슬롯 예약을 확정할 때 호출될 `confirmHandler` 함수를 인수로 받습니다. 해당 함수는 [`confirm-slot`](api/events/booking-confirmslot-event.md) 이벤트와 동일한 객체를 매개변수로 받습니다.
 

i18n/ko/docusaurus-plugin-content-docs/current/api/methods/booking-setlocale-method.md

@@ -16,7 +16,7 @@ description: DHTMLX JavaScript Booking 라이브러리 문서에서 setLocale()
 setLocale(locale?: object | null): void;
 ~~~
 
-### 매개변수 {#parameters}
+### 파라미터 {#parameters}
 
 - `null` - (선택 사항) 기본 로케일(영어)로 초기화합니다
 - `locale` - (선택 사항) 적용할 새 로케일 데이터 객체

i18n/ru/code.json

@@ -139,27 +139,27 @@
     "description": "The label alongside a tag list"
   },
   "theme.admonition.caution": {
-    "message": "предупреждение",
+    "message": "Осторожно",
     "description": "The default label used for the Caution admonition (:::caution)"
   },
   "theme.admonition.danger": {
-    "message": "осторожно",
+    "message": "Опасно",
     "description": "The default label used for the Danger admonition (:::danger)"
   },
   "theme.admonition.info": {
-    "message": "к сведению",
+    "message": "К сведению",
     "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": {
-    "message": "подсказка",
+    "message": "Подсказка",
     "description": "The default label used for the Tip admonition (:::tip)"
   },
   "theme.admonition.warning": {
-    "message": "предупреждение",
+    "message": "Предупреждение",
     "description": "The default label used for the Warning admonition (:::warning)"
   },
   "theme.AnnouncementBar.closeButtonAriaLabel": {

i18n/ru/docusaurus-plugin-content-docs/current/api/config/booking-cardshape.md

@@ -1,7 +1,7 @@
 ---
 sidebar_label: cardShape
 title: cardShape
-description: Вы можете узнать о конфиге cardShape в документации библиотеки DHTMLX JavaScript Booking. Изучайте руководства разработчика и справочник АПИ, пробуйте примеры кода и живые демо, и загружайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
+description: Вы можете узнать о конфиге cardShape в документации библиотеки DHTMLX JavaScript Booking. Изучайте руководства разработчика и справочник API, пробуйте примеры кода и живые демо, и загружайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
 ---
 
 # cardShape
@@ -36,7 +36,7 @@ cardShape?: {
 - `subtitle` - (необязательный) показывает/скрывает подзаголовок карточки
 - `title` - (необязательный) показывает/скрывает заголовок карточки
 
-### Конфиг по умолчанию {#default-config}
+### Конфигурация по умолчанию {#default-config}
 
 ~~~jsx {}
 const defaultCardShape = {

i18n/ru/docusaurus-plugin-content-docs/current/api/config/booking-cardtemplate.md

@@ -1,7 +1,7 @@
 ---
 sidebar_label: cardTemplate
 title: cardTemplate
-description: Вы можете узнать о конфигурации cardTemplate в документации библиотеки DHTMLX JavaScript Booking. Просматривайте руководства разработчика и справочник АПИ, пробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
+description: Вы можете узнать о конфигурации cardTemplate в документации библиотеки DHTMLX JavaScript Booking. Просматривайте руководства разработчика и справочник API, пробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
 ---
 
 # cardTemplate

i18n/ru/docusaurus-plugin-content-docs/current/api/config/booking-data.md

@@ -1,7 +1,7 @@
 ---
 sidebar_label: data
 title: data
-description: В документации по библиотеке DHTMLX JavaScript Booking вы можете узнать о конфигурации карточек. Изучайте руководства разработчика и справочник АПИ, пробуйте примеры кода и живые демо, загружайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
+description: В документации по библиотеке DHTMLX JavaScript Booking вы можете узнать о конфигурации карточек. Изучайте руководства разработчика и справочник API, пробуйте примеры кода и живые демо, загружайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
 ---
 
 # data
@@ -130,4 +130,4 @@ new booking.Booking("#root", {
 });
 ~~~
 
-**Связанные статьи**: [Определение правил слотов](guides/configuration.md#define-slot-rules)
+**Связанная статья**: [Определение правил слотов](guides/configuration.md#define-slot-rules)

i18n/ru/docusaurus-plugin-content-docs/current/api/config/booking-end.md

@@ -1,7 +1,7 @@
 ---
 sidebar_label: end
 title: end
-description: В документации библиотеки DHTMLX JavaScript Booking вы можете узнать о конечной дате. Просматривайте руководства разработчика и справочник АПИ, изучайте примеры кода и живые демо, а также скачайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
+description: В документации библиотеки DHTMLX JavaScript Booking вы можете узнать о конечной дате. Просматривайте руководства разработчика и справочник API, изучайте примеры кода и живые демо, а также скачайте бесплатную 30-дневную ознакомительную версию DHTMLX Booking.
 ---
 
 # end