Skip to content

Commit 94008ed

Browse files
[add] Russian (ru) documentation translation
- translate all 80 docs articles to Russian into i18n/ru current - preserve @getshort macros, code, links, slugs and heading anchors - add explicit Russian admonition titles (Совет/Важно/Информация/...) - fix one broken anchor: keep leading-dash auto-slug (#--fire--use-exec-and-intercept) instead of a normalized one - copy assets; write .sync marker - ru build is clean: 0 broken links, 0 broken anchors, macros expand
1 parent e645c5c commit 94008ed

90 files changed

Lines changed: 6604 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
e645c5c1dbc612a81372279c12a779d1411e0960
Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
---
2+
sidebar_label: defaultStyles
3+
title: Конфиг defaultStyles
4+
description: В документации библиотеки DHTMLX JavaScript RichText вы можете узнать о конфиге defaultStyles. Изучайте руководства разработчика и справочник АПИ, пробуйте примеры кода и живые демо, скачивайте бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# defaultStyles
8+
9+
### Описание {#description}
10+
11+
@short: Необязательный. Задаёт значения стилей по умолчанию для конкретных типов блоков
12+
13+
### Использование {#usage}
14+
15+
~~~jsx {}
16+
defaultStyles?: {
17+
"*"?: { // влияет на все блоки, позволяя задать общие свойства для всех этих блоков
18+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
19+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
20+
color?: string;
21+
background?: string;
22+
},
23+
p?: {
24+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
25+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
26+
color?: string;
27+
background?: string;
28+
},
29+
blockquote?: {
30+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
31+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
32+
color?: string;
33+
background?: string;
34+
},
35+
h1?: {
36+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
37+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
38+
color?: string;
39+
background?: string;
40+
},
41+
h2?: {
42+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
43+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
44+
color?: string;
45+
background?: string;
46+
},
47+
h3?: {
48+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
49+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
50+
color?: string;
51+
background?: string;
52+
},
53+
h4?: {
54+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
55+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
56+
color?: string;
57+
background?: string;
58+
},
59+
h5?: {
60+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
61+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
62+
color?: string;
63+
background?: string;
64+
},
65+
h6?: {
66+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
67+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
68+
color?: string;
69+
background?: string;
70+
}
71+
};
72+
~~~
73+
74+
:::important[Важно]
75+
Свойство `defaultStyles` НЕ применяет фактические CSS-стили к затронутым блокам. CSS-стили необходимо задавать отдельно:
76+
77+
```jsx title="index.js"
78+
new richtext.Richtext("#root", {
79+
defaultStyles: {
80+
h2: {
81+
"font-family": "Roboto",
82+
"font-size": "28px",
83+
color: "purple",
84+
background: "#FFC0CB"
85+
}
86+
}
87+
});
88+
```
89+
90+
```css title="index.css"
91+
<style>
92+
#root h2 {
93+
font-family: Roboto;
94+
font-size: 28px;
95+
color: purple;
96+
background: #FFC0CB;
97+
}
98+
</style>
99+
```
100+
101+
В этом примере всем блокам `h2` назначается шрифт `"Roboto"` с размером 28px, а также изменяются цвет текста и цвет фона. CSS-стили также применяются к блокам `h2`.
102+
:::
103+
104+
### Конфиг по умолчанию {#default-config}
105+
106+
~~~jsx
107+
const defaultStyles = {
108+
"*": { "font-family": "Arial" },
109+
p: { "font-size": "14px" },
110+
blockquote: { "font-size": "14px" },
111+
h1: { "font-size": "32px" },
112+
h2: { "font-size": "24px" },
113+
h3: { "font-size": "18px" },
114+
h4: { "font-size": "16px" },
115+
h5: { "font-size": "14px" },
116+
h6: { "font-size": "12px" }
117+
};
118+
~~~
119+
120+
### Пример {#example}
121+
122+
~~~jsx {3-13}
123+
// инициализация RichText
124+
new richtext.Richtext("#root", {
125+
defaultStyles: {
126+
h4: {
127+
"font-family": "Roboto"
128+
},
129+
h5: {
130+
"font-family": "Roboto"
131+
},
132+
h6: {
133+
"font-family": "Roboto"
134+
}
135+
},
136+
// другие параметры конфигурации
137+
});
138+
~~~
139+
140+
**История изменений:** Свойство обновлено в v2.0
141+
142+
**Связанные статьи:** [Конфигурация](guides/configuration.md)
143+
144+
**Связанный пример:** [RichText. Изменение значений типографики по умолчанию (шрифт, размер шрифта и др.)](https://snippet.dhtmlx.com/6u3ti01s?tag=richtext)
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
sidebar_label: fullscreenMode
3+
title: Конфиг fullscreenMode
4+
description: В документации библиотеки DHTMLX JavaScript RichText вы можете узнать о конфиге fullscreenMode. Просматривайте руководства разработчика и справочник АПИ, изучайте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# fullscreenMode
8+
9+
### Описание {#description}
10+
11+
@short: Необязательный. Включает полноэкранный режим RichText
12+
13+
### Использование {#usage}
14+
15+
~~~jsx {}
16+
fullscreenMode?: boolean;
17+
~~~
18+
19+
### Конфиг по умолчанию {#default-config}
20+
21+
~~~jsx
22+
fullscreenMode: false;
23+
~~~
24+
25+
### Пример {#example}
26+
27+
~~~jsx {3}
28+
// инициализация RichText
29+
new richtext.Richtext("#root", {
30+
fullscreenMode: true
31+
// другие свойства конфигурации
32+
});
33+
~~~
34+
35+
**История изменений:** Свойство добавлено в v2.0
36+
37+
**Связанные статьи:** [Конфигурация](guides/configuration.md)
38+
39+
**Связанный пример:** [RichText. Полная панель инструментов](https://snippet.dhtmlx.com/ziynafp7?tag=richtext)
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
sidebar_label: imageUploadUrl
3+
title: Конфигурация imageUploadUrl
4+
description: В документации DHTMLX JavaScript RichText вы можете узнать о конфигурационном свойстве imageUploadUrl. Ознакомьтесь с руководствами разработчика и справочником АПИ, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# imageUploadUrl
8+
9+
### Описание {#description}
10+
11+
@short: Необязательное. Задаёт URL, который будет использоваться для загрузки изображений (из панели инструментов, строки меню, вставки из буфера обмена или перетаскивания)
12+
13+
Если свойство задано, RichText загружает каждое вставленное изображение на указанный эндпоинт и подставляет URL, возвращённый сервером.
14+
15+
Если свойство не указано или имеет ложное значение (`""`, `null`, `undefined`), RichText переходит в **режим inline**: файл изображения читается на клиенте и встраивается непосредственно в содержимое в виде data URL в формате base64 — сервер не требуется. Встроенные изображения размером более 1024×800 пропорционально уменьшаются до этих пределов.
16+
17+
:::note[Примечание]
18+
Встроенные (base64) изображения не сохраняются при встроенном [экспорте](api/events/export.md) в DOCX / PDF. Если вы используете экспорт, укажите `imageUploadUrl`, чтобы изображения ссылались на внешнее расположение.
19+
:::
20+
21+
:::caution[Осторожно]
22+
Кодирование в base64 увеличивает размер данных примерно на одну треть по сравнению с исходным файлом. Документ с несколькими крупными встроенными изображениями вырастает соответственно, что влияет на размер значения, возвращаемого [`getValue()`](api/methods/get-value.md), на потребление памяти редактором и на стоимость сохранения или передачи содержимого. Для документов с большим количеством крупных изображений рекомендуется использовать серверный `imageUploadUrl`.
23+
:::
24+
25+
### Использование {#usage}
26+
27+
~~~jsx {}
28+
imageUploadUrl?: string;
29+
~~~
30+
31+
### Пример {#example}
32+
33+
Загрузка изображений на серверный эндпоинт:
34+
35+
~~~jsx {3}
36+
// инициализация RichText
37+
new richtext.Richtext("#root", {
38+
imageUploadUrl: "https://example.com/upload"
39+
// другие свойства конфигурации
40+
});
41+
~~~
42+
43+
Вставка изображений inline в виде base64 (сервер не требуется) — не указывайте свойство или передайте пустую строку:
44+
45+
~~~jsx {2}
46+
new richtext.Richtext("#root", {
47+
// imageUploadUrl не задан, изображения вставляются как data URL в формате base64
48+
// другие свойства конфигурации
49+
});
50+
~~~
51+
52+
**История изменений:** Свойство добавлено в v2.0. Начиная с v2.1 свойство является необязательным: если оно не указано, изображения вставляются inline в виде base64 data URL.
53+
54+
**Связанные статьи:** [Конфигурация](guides/configuration.md), [Работа с сервером](guides/working_with_server.md)
55+
56+
**Связанный пример:** [RichText. Инициализация](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
sidebar_label: layoutMode
3+
title: Конфиг layoutMode
4+
description: В документации DHTMLX JavaScript RichText вы можете узнать о конфиге layoutMode. Изучайте руководства разработчика и справочник АПИ, просматривайте примеры кода и живые демо, скачивайте бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# layoutMode
8+
9+
### Описание {#description}
10+
11+
@short: Необязательный. Задаёт режим отображения основной области редактора
12+
13+
### Использование {#usage}
14+
15+
~~~jsx {}
16+
layoutMode: "classic" | "document";
17+
~~~
18+
19+
Режим `"classic"` заполняет всю область редактирования. Режим `"document"` отображает область редактирования в виде страницы документа.
20+
21+
### Конфиг по умолчанию {#default-config}
22+
23+
~~~jsx
24+
layoutMode: "classic";
25+
~~~
26+
27+
### Пример {#example}
28+
29+
~~~jsx {3}
30+
// инициализация RichText
31+
new richtext.Richtext("#root", {
32+
layoutMode: "document" // инициализирует RichText в режиме "document" по умолчанию
33+
// другие свойства конфигурации
34+
});
35+
~~~
36+
37+
**Журнал изменений:** Свойство добавлено в v2.0 вместо удалённого свойства `mode`
38+
39+
**Связанные статьи:** [Конфигурация](guides/configuration.md)
40+
41+
**Связанный пример:** [RichText. Инициализация](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
sidebar_label: locale
3+
title: Конфиг locale
4+
description: В документации библиотеки DHTMLX JavaScript RichText вы можете узнать о конфиге locale. Изучайте руководства разработчика и справочник АПИ, пробуйте примеры кода и живые демо, а также скачайте бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# locale
8+
9+
### Описание {#description}
10+
11+
@short: Необязательный. Объект, содержащий метки локализации RichText
12+
13+
:::info[Информация]
14+
Объект **locale** должен включать все метки RichText с соответствующими переводами.
15+
:::
16+
17+
### Использование {#usage}
18+
19+
~~~jsx {}
20+
locale?: object;
21+
~~~
22+
23+
### Конфиг по умолчанию {#default-config}
24+
25+
По умолчанию RichText использует **английскую** локаль. Вы также можете задать собственную локаль.
26+
27+
:::tip[Совет]
28+
Чтобы динамически изменить текущую локаль, воспользуйтесь методом [**setLocale()**](api/methods/set-locale.md) объекта RichText
29+
:::
30+
31+
### Пример {#example}
32+
33+
~~~jsx {3}
34+
// инициализация RichText
35+
const editor = new richtext.RichText("#root", {
36+
locale: richtext.locales.cn // изначально будет установлена китайская локаль
37+
// locale: richtext.locales.en // изначально будет установлена английская локаль
38+
// locale: richtext.locales.de // изначально будет установлена немецкая локаль
39+
// другие свойства конфигурации
40+
});
41+
~~~
42+
43+
**История изменений:** Свойство добавлено в v2.0
44+
45+
**Связанные статьи:** [Локализация](guides/localization.md)
46+
47+
**Связанный пример:** [RichText. Локализация](https://snippet.dhtmlx.com/zxjrin3i?tag=richtext)
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
sidebar_label: menubar
3+
title: Конфиг menubar
4+
description: В документации DHTMLX JavaScript RichText вы можете узнать о конфиге menubar. Изучайте руководства разработчика и справочник АПИ, просматривайте примеры кода и живые демо, а также скачивайте бесплатную 30-дневную ознакомительную версию DHTMLX RichText.
5+
---
6+
7+
# menubar
8+
9+
### Описание {#description}
10+
11+
@short: Необязательный. Включает верхний меню-бар RichText
12+
13+
### Использование {#usage}
14+
15+
~~~jsx {}
16+
menubar?: boolean;
17+
~~~
18+
19+
### Пример {#example}
20+
21+
~~~jsx {3}
22+
// инициализация RichText
23+
new richtext.Richtext("#root", {
24+
menubar: true
25+
// другие свойства конфигурации
26+
});
27+
~~~
28+
29+
**Журнал изменений:** Свойство добавлено в v2.0
30+
31+
**Связанные статьи:** [Конфигурация](guides/configuration.md)
32+
33+
**Связанный пример:** [RichText. Инициализация с меню-баром](https://snippet.dhtmlx.com/tjryzka7?tag=richtext)

0 commit comments

Comments
 (0)