Test for AI translation (ru)

.github/workflows/main.yml

@@ -6,7 +6,7 @@ name: Deploy To Site
 on:
   # Triggers the workflow on push or pull request events but only for the master branch
   push:
-    branches: [master]
+    branches: [master,next]
 
 # A workflow run is made up of one or more jobs that can run sequentially or in parallel
 jobs:

.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

docusaurus.config.js

@@ -141,6 +141,20 @@ const config = {
     organizationName: 'DHTMLX',
     projectName: 'docs-richtext',
     trailingSlash: true,
+    i18n: {
+        defaultLocale: 'en',
+        locales: ['en', 'ru'],
+        localeConfigs: {
+            en: {
+                label: 'English',
+                direction: 'ltr',
+            },
+            ru: {
+                label: 'Русский',
+                direction: 'ltr',
+            },
+        },
+    },
     markdown: {
 		hooks: {
 			onBrokenMarkdownLinks: 'warn',
@@ -246,6 +260,10 @@ const config = {
                     label: 'Download',
                     href: 'https://dhtmlx.com/docs/products/dhtmlxRichText/download.shtml',
                     position: 'right'
+                },
+                {
+                    type: 'localeDropdown',
+                    position: 'right',
                 }
             ]
         },

i18n/ru/docusaurus-plugin-content-blog/options.json

@@ -0,0 +1,14 @@
+{
+  "title": {
+    "message": "Blog",
+    "description": "The title for the blog used in SEO"
+  },
+  "description": {
+    "message": "Blog",
+    "description": "The description for the blog used in SEO"
+  },
+  "sidebar.title": {
+    "message": "Recent posts",
+    "description": "The label for the left sidebar"
+  }
+}

i18n/ru/docusaurus-plugin-content-docs/current.json

@@ -0,0 +1,62 @@
+{
+  "version.label": {
+    "message": "Next",
+    "description": "The label for version current"
+  },
+  "sidebar.docs.category.What's new and migration": {
+    "message": "What's new and migration",
+    "description": "The label for category 'What's new and migration' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.What's new and migration.link.generated-index.title": {
+    "message": "What's new and migration",
+    "description": "The generated-index page title for category 'What's new and migration' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.API": {
+    "message": "API",
+    "description": "The label for category 'API' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.RichText methods": {
+    "message": "RichText methods",
+    "description": "The label for category 'RichText methods' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.RichText internal API": {
+    "message": "RichText internal API",
+    "description": "The label for category 'RichText internal API' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.RichText internal API.link.generated-index.title": {
+    "message": "Internal API overview",
+    "description": "The generated-index page title for category 'RichText internal API' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Event Bus methods": {
+    "message": "Event Bus methods",
+    "description": "The label for category 'Event Bus methods' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.State methods": {
+    "message": "State methods",
+    "description": "The label for category 'State methods' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.RichText events": {
+    "message": "RichText events",
+    "description": "The label for category 'RichText events' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.RichText properties": {
+    "message": "RichText properties",
+    "description": "The label for category 'RichText properties' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Integration with frameworks": {
+    "message": "Integration with frameworks",
+    "description": "The label for category 'Integration with frameworks' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Integration with frameworks.link.generated-index.title": {
+    "message": "Integration with frameworks",
+    "description": "The generated-index page title for category 'Integration with frameworks' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Guides": {
+    "message": "Guides",
+    "description": "The label for category 'Guides' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Guides.link.generated-index.title": {
+    "message": "Guides",
+    "description": "The generated-index page title for category 'Guides' in sidebar 'docs'"
+  }
+}

i18n/ru/docusaurus-plugin-content-docs/current/api/config/default-styles.md

@@ -0,0 +1,144 @@
+---
+sidebar_label: defaultStyles
+title: Конфигурация defaultStyles
+description: Документация по свойству defaultStyles библиотеки DHTMLX RichText. Руководства, справочник API, примеры кода и демо, а также бесплатная 30-дневная пробная версия.
+---
+
+# defaultStyles
+
+### Описание {#description}
+
+@short: Необязательный. Задаёт значения стилей по умолчанию для определённых типов блоков
+
+### Использование {#usage}
+
+~~~jsx {}
+defaultStyles?: {
+    "*"?: { // применяется ко всем блокам, позволяя задать общие свойства для них
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    p?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    blockquote?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h1?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h2?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h3?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h4?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h5?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    },
+    h6?: {
+        "font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
+        "font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
+        color?: string;
+        background?: string;
+    }
+};
+~~~
+
+:::important[Важно]
+Свойство `defaultStyles` НЕ применяет CSS напрямую к блокам. CSS-стили нужно задавать отдельно:
+
+```jsx title="index.js"
+new richtext.Richtext("#root", {
+    defaultStyles: {
+        h2: {
+            "font-family": "Roboto",
+            "font-size": "28px",
+            color: "purple",
+            background: "#FFC0CB"
+        }
+    }
+});
+```
+
+```css title="index.css"
+<style>
+    #root h2 {
+        font-family: Roboto;
+        font-size: 28px;
+        color: purple;
+        background: #FFC0CB;
+    }
+</style>
+```
+
+В этом примере всем блокам `h2` задаётся шрифт `"Roboto"` размером 28px, а также изменяются цвет текста и фона. CSS-стили также применяются к блокам `h2`.
+:::
+
+### Конфигурация по умолчанию {#default-config}
+
+~~~jsx
+const defaultStyles = {
+    "*": { "font-family": "Arial" },
+    p: { "font-size": "14px" },
+    blockquote: { "font-size": "14px" },
+    h1: { "font-size": "32px" },
+    h2: { "font-size": "24px" },
+    h3: { "font-size": "18px" },
+    h4: { "font-size": "16px" },
+    h5: { "font-size": "14px" },
+    h6: { "font-size": "12px" }
+};
+~~~
+
+### Пример {#example}
+
+~~~jsx {3-13}
+// инициализация RichText
+new richtext.Richtext("#root", {
+    defaultStyles: {
+        h4: {
+            "font-family": "Roboto"
+        },
+        h5: {
+            "font-family": "Roboto"
+        },
+        h6: {
+            "font-family": "Roboto"
+        }
+    },
+    // другие свойства конфигурации
+});
+~~~
+
+**История изменений:** Свойство обновлено в v2.0
+
+**Связанные статьи:** [Конфигурация](guides/configuration.md)
+
+**Связанный пример:** [RichText. Изменение значений типографики по умолчанию (шрифт, размер шрифта и т.д.)](https://snippet.dhtmlx.com/6u3ti01s?tag=richtext)

i18n/ru/docusaurus-plugin-content-docs/current/api/config/fullscreen-mode.md

@@ -0,0 +1,39 @@
+---
+sidebar_label: fullscreenMode
+title: Конфигурация fullscreenMode
+description: Документация по свойству fullscreenMode библиотеки DHTMLX RichText. Руководства, справочник API, примеры кода и демо, а также бесплатная 30-дневная пробная версия.
+---
+
+# fullscreenMode
+
+### Описание {#description}
+
+@short: Необязательный. Включает полноэкранный режим RichText
+
+### Использование {#usage}
+
+~~~jsx {}
+fullscreenMode?: boolean;
+~~~
+
+### Конфигурация по умолчанию {#default-config}
+
+~~~jsx
+fullscreenMode: false;
+~~~
+
+### Пример {#example}
+
+~~~jsx {3}
+// инициализация RichText
+new richtext.Richtext("#root", {
+    fullscreenMode: true
+    // другие свойства конфигурации
+});
+~~~
+
+**История изменений:** Свойство добавлено в v2.0
+
+**Связанные статьи:** [Конфигурация](guides/configuration.md)
+
+**Связанный пример:** [RichText. Полная панель инструментов](https://snippet.dhtmlx.com/ziynafp7?tag=richtext)

i18n/ru/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md

@@ -0,0 +1,33 @@
+---
+sidebar_label: imageUploadUrl
+title: Конфигурация imageUploadUrl
+description: Документация по свойству imageUploadUrl библиотеки DHTMLX RichText. Руководства, справочник API, примеры кода и демо, а также бесплатная 30-дневная пробная версия.
+---
+
+# imageUploadUrl
+
+### Описание {#description}
+
+@short: Необязательный. Задаёт URL для загрузки изображений
+
+### Использование {#usage}
+
+~~~jsx {}
+imageUploadUrl?: string;
+~~~
+
+### Пример {#example}
+
+~~~jsx {3}
+// инициализация RichText
+new richtext.Richtext("#root", {
+    imageUploadUrl: "some URL"
+    // другие свойства конфигурации
+});
+~~~
+
+**История изменений:** Свойство добавлено в v2.0
+
+**Связанные статьи:** [Конфигурация](guides/configuration.md)
+
+**Связанный пример:** [RichText. Инициализация](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)

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

@@ -0,0 +1,41 @@
+---
+sidebar_label: layoutMode
+title: Конфигурация layoutMode
+description: Документация по свойству layoutMode библиотеки DHTMLX RichText. Руководства, справочник API, примеры кода и демо, а также бесплатная 30-дневная пробная версия.
+---
+
+# layoutMode
+
+### Описание {#description}
+
+@short: Необязательный. Задаёт режим отображения основной области редактора
+
+### Использование {#usage}
+
+~~~jsx {}
+layoutMode: "classic" | "document";
+~~~
+
+Режим `"classic"` — область редактирования занимает всю страницу. Режим `"document"` имитирует реальные размеры документа (форматы A4, A5, A6, A7).
+
+### Конфигурация по умолчанию {#default-config}
+
+~~~jsx
+layoutMode: "classic";
+~~~
+
+### Пример {#example}
+
+~~~jsx {3}
+// инициализация RichText
+new richtext.Richtext("#root", {
+    layoutMode: "document"  // инициализирует RichText в режиме "document" по умолчанию
+    // другие свойства конфигурации
+});
+~~~
+
+**История изменений:** Свойство добавлено в v2.0 на замену удалённому свойству `mode`
+
+**Связанные статьи:** [Конфигурация](guides/configuration.md)
+
+**Связанный пример:** [RichText. Инициализация](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)