diff --git a/docs/api/config/image-upload-url.md b/docs/api/config/image-upload-url.md
index 9fa2087..c9982e8 100644
--- a/docs/api/config/image-upload-url.md
+++ b/docs/api/config/image-upload-url.md
@@ -12,7 +12,7 @@ description: You can learn about the imageUploadUrl config in the documentation
When the property is set, RichText uploads each inserted image to the given endpoint and inserts the URL returned by the server.
-When the property is omitted or set to a falsy value (`""`, `null`, `undefined`), RichText switches to **inline mode**: the image file is read on the client and embedded directly into the content as a base64 data URL — no server is required. Inline images larger than 1024×800 are proportionally downscaled to fit within these limits.
+When the property is omitted or set to a falsy value (`""`, `null`, `undefined`), RichText switches to **inline mode**: the image file is read on the client and embedded directly into the content as a base64 data URL, so no server is required. Inline images larger than 1024×800 are proportionally downscaled to fit within these limits.
:::note
Inline (base64) images are not preserved by the built-in DOCX / PDF [export](api/events/export.md). If you rely on export, supply an `imageUploadUrl` so that images reference an external location.
@@ -40,7 +40,7 @@ new richtext.Richtext("#root", {
});
~~~
-Insert images inline as base64 (no server required) — omit the property or pass an empty string:
+Insert images inline as base64 (no server required) by omitting the property or passing an empty string:
~~~jsx {2}
new richtext.Richtext("#root", {
diff --git a/docs/api/config/trigger-template.md b/docs/api/config/trigger-template.md
index 81c83d9..273c1d1 100644
--- a/docs/api/config/trigger-template.md
+++ b/docs/api/config/trigger-template.md
@@ -10,7 +10,7 @@ description: You can learn about the triggerTemplate config in the documentation
@short: Optional. Customizes how RichText renders items in the suggestion dropdown opened by a [`triggers`](api/config/triggers.md) entry
-By default, the dropdown shows each item's `label` as plain text. Use `triggerTemplate` to render richer rows — for example, an avatar plus a name and an email.
+By default, the dropdown shows each item's `label` as plain text. Use `triggerTemplate` to render richer rows, for example an avatar plus a name and an email.
### Usage
diff --git a/docs/api/events/insert-image.md b/docs/api/events/insert-image.md
index ca21475..c906b96 100644
--- a/docs/api/events/insert-image.md
+++ b/docs/api/events/insert-image.md
@@ -30,7 +30,7 @@ interface IImageContext {
~~~
:::note
-The `value` field holds either an external URL (when [`imageUploadUrl`](api/config/image-upload-url.md) is configured and the upload succeeds) or a base64 data URL (when `imageUploadUrl` is omitted and the image is inlined on the client). Handlers that process the source — for example, to rewrite the URL or validate the host — must account for both formats.
+The `value` field holds either an external URL (when [`imageUploadUrl`](api/config/image-upload-url.md) is configured and the upload succeeds) or a base64 data URL (when `imageUploadUrl` is omitted and the image is inlined on the client). Handlers that process the source, for example to rewrite the URL or validate the host, must account for both formats.
:::
:::info
diff --git a/docs/guides/configuration.md b/docs/guides/configuration.md
index 71d92be..e4f826d 100644
--- a/docs/guides/configuration.md
+++ b/docs/guides/configuration.md
@@ -271,7 +271,7 @@ new richtext.Richtext("#root", {
});
~~~
-Inline images larger than 1024×800 are displayed at a reduced size (the `width`/`height` attributes are capped to fit within these limits), but the embedded bytes are the original, full-resolution file — the client does not downscale or re-encode it.
+Inline images larger than 1024×800 are displayed at a reduced size (the `width`/`height` attributes are capped to fit within these limits), but the embedded bytes are the original, full-resolution file. The client does not downscale or re-encode it.
:::note
Inline (base64) images are not preserved by the built-in DOCX / PDF [export](api/events/export.md). If you rely on export, supply an `imageUploadUrl` so that images reference an external location.
diff --git a/docs/guides/mentions_and_tags.md b/docs/guides/mentions_and_tags.md
index cc3121a..747e536 100644
--- a/docs/guides/mentions_and_tags.md
+++ b/docs/guides/mentions_and_tags.md
@@ -147,7 +147,7 @@ new richtext.Richtext("#root", {
## Custom action on select
-By default, picking an item inserts it into the document as a token. To run your own code instead, add an `action` callback to the trigger. RichText removes the typed trigger text and calls `action(item)` with the picked item — no token is inserted, so you can decide what to add.
+By default, picking an item inserts it into the document as a token. To run your own code instead, add an `action` callback to the trigger. RichText removes the typed trigger text and calls `action(item)` with the picked item. No token is inserted, so you can decide what to add.
:::note
`action` takes priority over `showTrigger`. When `action` is set, `showTrigger` is ignored.
diff --git a/docs/guides/working_with_server.md b/docs/guides/working_with_server.md
index 2b63dbc..a53bdc1 100644
--- a/docs/guides/working_with_server.md
+++ b/docs/guides/working_with_server.md
@@ -17,14 +17,14 @@ This guide explains:
## Default behavior: inline images
-If you do not set the [`imageUploadUrl`](api/config/image-upload-url.md) property, RichText falls back to inline images. When the user inserts an image, RichText reads the file in the browser, encodes the original file as a `data:image/...;base64,...` URL, and writes it directly into the editor content as the `src` of the `
` element. RichText constrains the displayed size to fit within a 1024×800 box through the `width`/`height` attributes, but the embedded bytes are the original, full-resolution file — the client does not downscale or re-encode it.
+If you do not set the [`imageUploadUrl`](api/config/image-upload-url.md) property, RichText falls back to inline images. When the user inserts an image, RichText reads the file in the browser, encodes the original file as a `data:image/...;base64,...` URL, and writes it directly into the editor content as the `src` of the `
` element. RichText constrains the displayed size to fit within a 1024×800 box through the `width`/`height` attributes, but the embedded bytes are the original, full-resolution file. The client does not downscale or re-encode it.
This works without any backend and is handy for quick demos, but it has clear limitations:
- the encoded bytes live inside the document, so the saved HTML grows with every image
-- the same image in two documents is stored twice — there is no shared resource to deduplicate
+- the same image in two documents is stored twice, because there is no shared resource to deduplicate
- because the bytes are not a separate resource, the server cannot serve them from a CDN or post-process them (resize, re-encode, scan)
-- inline images are not preserved by the built-in DOCX / PDF [export](api/events/export.md) — if you rely on export, configure an upload server so images reference an external URL
+- inline images are not preserved by the built-in DOCX / PDF [export](api/events/export.md), so if you rely on export, configure an upload server that lets images reference an external URL
## Write your own server
diff --git a/docs/index.md b/docs/index.md
index 747b01d..fb0d579 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -103,7 +103,7 @@ const md = editor.getValue(richtext.markdown.toMarkdown);
~~~
:::note
-Markdown support covers a limited subset of the syntax — common block and inline elements such as headings, paragraphs, line breaks, emphasis, blockquotes, lists, and links. Formatting that has no Markdown equivalent (font family, font size, colors, alignment, line height) is dropped on serialization.
+Markdown support covers a limited subset of the syntax: common block and inline elements such as headings, paragraphs, line breaks, emphasis, blockquotes, lists, and links. Formatting that has no Markdown equivalent (font family, font size, colors, alignment, line height) is dropped on serialization.
Nested inline structures are not supported, with the only exception of **bold inside italic**. Combinations such as bold inside a link, italic inside a list item, or multi-level (nested) lists will not render correctly.
:::
@@ -120,7 +120,7 @@ When content is copied or cut, RichText writes two representations to the system
Paste behavior depends on the source of the clipboard payload:
- Pasting between two RichText instances (in the same document or on different pages) uses the HTML representation and preserves the original formatting.
-- Pasting from any external source — including browsers, word processors, and other editors — is processed as plain text. The inserted content is added as text without external formatting.
+- Pasting from any external source (browsers, word processors, and other editors) is processed as plain text. The inserted content is added as text without external formatting.
:::note
The toolbar **Paste** button uses the asynchronous Clipboard API, which exposes plain text only. To paste content copied from another RichText with its formatting preserved, use the `Ctrl+V` / `⌘+V` shortcut, which receives the full HTML payload directly from the browser's clipboard event.
diff --git a/docs/news/migration.md b/docs/news/migration.md
index 6797836..6560451 100644
--- a/docs/news/migration.md
+++ b/docs/news/migration.md
@@ -132,7 +132,7 @@ editor.getValue(toTextEncoder);
```
:::note
-You can still call `getValue()` and `setValue()` without an encoder — HTML is used by default
+You can still call `getValue()` and `setValue()` without an encoder. HTML is used by default
:::
### - [`on`](api/internal/on.md) / [`detach`](api/internal/detach.md)
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/.sync b/i18n/de/docusaurus-plugin-content-docs/current/.sync
index 80674c9..d0a4364 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/de/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-c5fee7e0d2c9c6fb0721c92dcafb264655069c38
+05606c5dd334f327d352f06b9d57a0c5c6965b1e
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md
index 4fb999a..c47ca2a 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md
@@ -271,7 +271,7 @@ new richtext.Richtext("#root", {
});
~~~
-Inline-Bilder, die größer als 1024×800 sind, werden in reduzierter Größe angezeigt (die Attribute `width`/`height` werden auf diese Grenzen begrenzt), aber die eingebetteten Bytes sind die ursprüngliche Datei in voller Auflösung — der Client skaliert sie nicht herunter oder kodiert sie neu.
+Inline-Bilder, die größer als 1024×800 sind, werden in reduzierter Größe angezeigt (die Attribute `width`/`height` werden auf diese Grenzen begrenzt), aber die eingebetteten Bytes sind die ursprüngliche Datei in voller Auflösung. Der Client skaliert sie nicht herunter und kodiert sie nicht neu.
:::note[Hinweis]
Inline-Bilder (Base64) bleiben beim integrierten DOCX-/PDF-[Export](api/events/export.md) nicht erhalten. Wenn Sie auf den Export angewiesen sind, geben Sie eine `imageUploadUrl` an, damit Bilder auf einen externen Speicherort verweisen.
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/mcp-server.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/mcp-server.md
index c8a353f..5fa7607 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/guides/mcp-server.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/mcp-server.md
@@ -6,7 +6,7 @@ description: Der MCP-Server versorgt KI-Assistenten mit verifizierter, aktueller
# DHTMLX RichText MCP-Server: Formate, Symbolleiste und Trigger {#dhtmlx-richtext-mcp-server-formats-toolbar-and-triggers}
-DHTMLX RichText ist ein leichtgewichtiger WYSIWYG-Editor mit einer breiten Konfigurationsfläche. Sie können Inhalte zwischen [HTML, Klartext und Markdown](/#supported-formats) konvertieren, die Typografie pro Blocktyp über [Standardstile](guides/configuration.md#configure-default-styles) festlegen und eine vollständig anpassbare [Symbolleiste](guides/configuration.md#toolbar) erstellen, die sich an die Steuerelemente anpasst, die eine Anwendung benötigt. Um daraus den vollen Nutzen zu ziehen, müssen Sie jedes Element mit dem aktuellen Setup abgleichen: aktuelles CSS für Standardstile, den richtigen Encoder für ein bestimmtes Format und gültige Steuerelementtypen für benutzerdefinierte Symbolleisten-Schaltflächen — statt sich auf eine auswendig gelernte Vermutung zu verlassen.
+DHTMLX RichText ist ein leichtgewichtiger WYSIWYG-Editor mit einer breiten Konfigurationsfläche. Sie können Inhalte zwischen [HTML, Klartext und Markdown](/#supported-formats) konvertieren, die Typografie pro Blocktyp über [Standardstile](guides/configuration.md#configure-default-styles) festlegen und eine vollständig anpassbare [Symbolleiste](guides/configuration.md#toolbar) erstellen, die sich an die Steuerelemente anpasst, die eine Anwendung benötigt. Um daraus den vollen Nutzen zu ziehen, müssen Sie jedes Element mit dem aktuellen Setup abgleichen: aktuelles CSS für Standardstile, den richtigen Encoder für ein bestimmtes Format und gültige Steuerelementtypen für benutzerdefinierte Symbolleisten-Schaltflächen, statt sich auf eine auswendig gelernte Vermutung zu verlassen.
Der DHTMLX MCP-Server hält einen KI-Assistenten in all diesen Punkten auf dem aktuellen Stand. Das [Setup für Erwähnungen und Trigger](guides/mentions_and_tags.md), der [Vertrag für den Bild-Upload](guides/working_with_server.md) und der [DOCX-/PDF-Exportablauf](api/events/export.md) stammen alle aus der aktuellen Dokumentation, sodass generierter Code dem tatsächlichen Verhalten des Editors von heute entspricht.
@@ -51,7 +51,7 @@ Dank dieses Ablaufs bleiben die Formatierungs- und Symbolleisten-Vorschläge fü
## KI-Tool mit dem MCP-Server verbinden {#attaching-your-ai-tool-to-the-mcp-server}
-Die Registrierung des MCP-Endpunkts muss pro Tool nur einmal erfolgen — egal ob per CLI-Befehl oder JSON-Konfigurationseintrag — und alle zielen auf dieselbe Adresse:
+Die Registrierung des MCP-Endpunkts muss pro Tool nur einmal erfolgen, egal ob per CLI-Befehl oder JSON-Konfigurationseintrag, und alle zielen auf dieselbe Adresse:
~~~jsx
https://docs.dhtmlx.com/mcp
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
index d56b725..8c3a02d 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
@@ -147,7 +147,7 @@ new richtext.Richtext("#root", {
## Benutzerdefinierte Aktion bei Auswahl {#custom-action-on-select}
-Standardmäßig wird ein ausgewähltes Element als Token in das Dokument eingefügt. Um stattdessen eigenen Code auszuführen, fügen Sie dem Trigger einen `action`-Callback hinzu. RichText entfernt den eingegebenen Trigger-Text und ruft `action(item)` mit dem ausgewählten Element auf — es wird kein Token eingefügt, sodass Sie selbst entscheiden können, was hinzugefügt wird.
+Standardmäßig wird ein ausgewähltes Element als Token in das Dokument eingefügt. Um stattdessen eigenen Code auszuführen, fügen Sie dem Trigger einen `action`-Callback hinzu. RichText entfernt den eingegebenen Trigger-Text und ruft `action(item)` mit dem ausgewählten Element auf. Es wird kein Token eingefügt, sodass Sie selbst entscheiden können, was hinzugefügt wird.
:::note[Hinweis]
`action` hat Vorrang vor `showTrigger`. Wenn `action` gesetzt ist, wird `showTrigger` ignoriert.
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/working_with_server.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/working_with_server.md
index 447e113..d4e992f 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/guides/working_with_server.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/working_with_server.md
@@ -17,14 +17,14 @@ Dieser Guide erklärt:
## Standardverhalten: Inline-Bilder {#default-behavior-inline-images}
-Wenn Sie die Eigenschaft [`imageUploadUrl`](api/config/image-upload-url.md) nicht setzen, fällt RichText auf Inline-Bilder zurück. Wenn der Benutzer ein Bild einfügt, liest RichText die Datei im Browser, kodiert die Originaldatei als `data:image/...;base64,...`-URL und schreibt diese direkt als `src` des `
`-Elements in den Editor-Inhalt. RichText begrenzt die angezeigte Größe über die Attribute `width`/`height` auf einen 1024×800-Bereich, aber die eingebetteten Bytes sind die originale Datei in voller Auflösung — der Client skaliert oder kodiert sie nicht um.
+Wenn Sie die Eigenschaft [`imageUploadUrl`](api/config/image-upload-url.md) nicht setzen, fällt RichText auf Inline-Bilder zurück. Wenn der Benutzer ein Bild einfügt, liest RichText die Datei im Browser, kodiert die Originaldatei als `data:image/...;base64,...`-URL und schreibt diese direkt als `src` des `
`-Elements in den Editor-Inhalt. RichText begrenzt die angezeigte Größe über die Attribute `width`/`height` auf einen 1024×800-Bereich, aber die eingebetteten Bytes sind die originale Datei in voller Auflösung. Der Client skaliert sie nicht herunter und kodiert sie nicht um.
Dies funktioniert ohne jedes Backend und ist praktisch für schnelle Demos, hat aber klare Einschränkungen:
- die kodierten Bytes leben im Dokument, daher wächst das gespeicherte HTML mit jedem Bild
-- dasselbe Bild in zwei Dokumenten wird zweimal gespeichert — es gibt keine gemeinsame Ressource zur Deduplizierung
+- dasselbe Bild in zwei Dokumenten wird zweimal gespeichert, da es keine gemeinsame Ressource zur Deduplizierung gibt
- da die Bytes keine separate Ressource sind, kann der Server sie weder über ein CDN ausliefern noch nachbearbeiten (skalieren, umkodieren, scannen)
-- Inline-Bilder werden durch den integrierten DOCX/PDF-[Export](api/events/export.md) nicht erhalten — wenn Sie auf den Export angewiesen sind, konfigurieren Sie einen Upload-Server, damit Bilder auf eine externe URL verweisen
+- Inline-Bilder werden durch den integrierten DOCX/PDF-[Export](api/events/export.md) nicht erhalten, sodass Sie bei Nutzung des Exports einen Upload-Server konfigurieren sollten, damit Bilder auf eine externe URL verweisen
## Eigenen Server schreiben {#write-your-own-server}
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/news/migration.md b/i18n/de/docusaurus-plugin-content-docs/current/news/migration.md
index 991fa2f..ad3e77a 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/news/migration.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/news/migration.md
@@ -132,7 +132,7 @@ editor.getValue(toTextEncoder);
```
:::note[Hinweis]
-Sie können `getValue()` und `setValue()` weiterhin ohne Encoder aufrufen — HTML wird standardmäßig verwendet
+Sie können `getValue()` und `setValue()` weiterhin ohne Encoder aufrufen. HTML wird standardmäßig verwendet
:::
### - [`on`](api/internal/on.md) / [`detach`](api/internal/detach.md) {#--on--detach}
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/.sync b/i18n/ko/docusaurus-plugin-content-docs/current/.sync
index 80674c9..d0a4364 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-c5fee7e0d2c9c6fb0721c92dcafb264655069c38
+05606c5dd334f327d352f06b9d57a0c5c6965b1e
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md b/i18n/ko/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
index 06fcb05..f10f355 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
@@ -40,7 +40,7 @@ new richtext.Richtext("#root", {
});
~~~
-이미지를 base64로 인라인 삽입 (서버 불필요) — 속성을 생략하거나 빈 문자열을 전달합니다:
+이미지를 base64로 인라인 삽입하려면(서버 불필요) 속성을 생략하거나 빈 문자열을 전달합니다:
~~~jsx {2}
new richtext.Richtext("#root", {
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/index.md b/i18n/ko/docusaurus-plugin-content-docs/current/index.md
index 1b94854..85a625b 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/index.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/index.md
@@ -103,7 +103,7 @@ const md = editor.getValue(richtext.markdown.toMarkdown);
~~~
:::note[노트]
-Markdown 지원은 구문의 제한된 하위 집합만을 포함합니다 — 제목, 단락, 줄바꿈, 강조, 인용구, 목록, 링크와 같은 일반적인 블록 및 인라인 요소가 해당됩니다. Markdown에 해당하는 표현이 없는 서식(글꼴 패밀리, 글꼴 크기, 색상, 정렬, 줄 높이)은 직렬화 시 제거됩니다.
+Markdown 지원은 구문의 제한된 하위 집합만을 포함합니다. 제목, 단락, 줄바꿈, 강조, 인용구, 목록, 링크와 같은 일반적인 블록 및 인라인 요소가 해당됩니다. Markdown에 해당하는 표현이 없는 서식(글꼴 패밀리, 글꼴 크기, 색상, 정렬, 줄 높이)은 직렬화 시 제거됩니다.
중첩 인라인 구조는 지원되지 않으며, **이탤릭체 안의 굵게**만 예외입니다. 링크 안의 굵게, 목록 항목 안의 이탤릭체, 또는 다단계(중첩) 목록과 같은 조합은 올바르게 렌더링되지 않습니다.
:::
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/.sync b/i18n/ru/docusaurus-plugin-content-docs/current/.sync
index 80674c9..d0a4364 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-c5fee7e0d2c9c6fb0721c92dcafb264655069c38
+05606c5dd334f327d352f06b9d57a0c5c6965b1e
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
index 8b19341..67c09dd 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
@@ -12,7 +12,7 @@ description: В документации DHTMLX JavaScript RichText вы мож
Если свойство задано, RichText загружает каждое вставленное изображение на указанный эндпоинт и подставляет URL, возвращённый сервером.
-Если свойство не указано или имеет ложное значение (`""`, `null`, `undefined`), RichText переходит в **режим inline**: файл изображения читается на клиенте и встраивается непосредственно в содержимое в виде data URL в формате base64 — сервер не требуется. Встроенные изображения размером более 1024×800 пропорционально уменьшаются до этих пределов.
+Если свойство не указано или имеет ложное значение (`""`, `null`, `undefined`), RichText переходит в **режим inline**: файл изображения читается на клиенте и встраивается непосредственно в содержимое в виде data URL в формате base64, поэтому сервер не требуется. Встроенные изображения размером более 1024×800 пропорционально уменьшаются до этих пределов.
:::note[Примечание]
Встроенные (base64) изображения не сохраняются при встроенном [экспорте](api/events/export.md) в DOCX / PDF. Если вы используете экспорт, укажите `imageUploadUrl`, чтобы изображения ссылались на внешнее расположение.
@@ -40,7 +40,7 @@ new richtext.Richtext("#root", {
});
~~~
-Вставка изображений inline в виде base64 (сервер не требуется) — не указывайте свойство или передайте пустую строку:
+Чтобы вставлять изображения inline в виде base64 (сервер не требуется), не указывайте свойство или передайте пустую строку:
~~~jsx {2}
new richtext.Richtext("#root", {
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/trigger-template.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/trigger-template.md
index bb48d4e..0672d55 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/trigger-template.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/trigger-template.md
@@ -10,7 +10,7 @@ description: В документации библиотеки DHTMLX JavaScript
@short: Необязательный. Настраивает отображение элементов в выпадающем списке подсказок, открываемом записью [`triggers`](api/config/triggers.md)
-По умолчанию выпадающий список отображает поле `label` каждого элемента в виде обычного текста. Используйте `triggerTemplate`, чтобы отображать более насыщенные строки — например, аватар вместе с именем и электронной почтой.
+По умолчанию выпадающий список отображает поле `label` каждого элемента в виде обычного текста. Используйте `triggerTemplate`, чтобы отображать более насыщенные строки, например аватар вместе с именем и электронной почтой.
### Использование {#usage}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/insert-image.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/insert-image.md
index 78235de..273f349 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/insert-image.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/insert-image.md
@@ -30,7 +30,7 @@ interface IImageContext {
~~~
:::note[Примечание]
-Поле `value` содержит либо внешний URL (если настроен [`imageUploadUrl`](api/config/image-upload-url.md) и загрузка прошла успешно), либо base64 data URL (если `imageUploadUrl` не задан и изображение встраивается на стороне клиента). Обработчики, работающие с источником — например, для перезаписи URL или проверки хоста — должны учитывать оба формата.
+Поле `value` содержит либо внешний URL (если настроен [`imageUploadUrl`](api/config/image-upload-url.md) и загрузка прошла успешно), либо base64 data URL (если `imageUploadUrl` не задан и изображение встраивается на стороне клиента). Обработчики, работающие с источником (например, для перезаписи URL или проверки хоста), должны учитывать оба формата.
:::
:::info[К сведению]
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md
index 4968973..9269600 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md
@@ -271,7 +271,7 @@ new richtext.Richtext("#root", {
});
~~~
-Встроенные изображения размером больше 1024×800 отображаются в уменьшенном виде (атрибуты `width`/`height` ограничены, чтобы вписаться в эти пределы), однако встроенные байты представляют собой исходный файл в полном разрешении — клиент не уменьшает и не перекодирует его.
+Встроенные изображения размером больше 1024×800 отображаются в уменьшенном виде (атрибуты `width`/`height` ограничены, чтобы вписаться в эти пределы), однако встроенные байты представляют собой исходный файл в полном разрешении: клиент не уменьшает и не перекодирует его.
:::note[Примечание]
Встроенные (base64) изображения не сохраняются при встроенном [экспорте](api/events/export.md) в форматы DOCX / PDF. Если вы используете экспорт, укажите `imageUploadUrl`, чтобы изображения ссылались на внешний ресурс.
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md
index f672300..6e1ce7b 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md
@@ -6,7 +6,7 @@ description: MCP-сервер предоставляет ИИ-ассистент
# MCP-сервер DHTMLX RichText: форматы, панель инструментов и триггеры {#dhtmlx-richtext-mcp-server-formats-toolbar-and-triggers}
-DHTMLX RichText — это лёгкий WYSIWYG-редактор с широкими возможностями конфигурации. Вы можете преобразовывать содержимое между [HTML, обычным текстом и Markdown](/#supported-formats), задавать типографику для каждого типа блока через [стили по умолчанию](guides/configuration.md#configure-default-styles) и создавать полностью настраиваемую [панель инструментов](guides/configuration.md#toolbar), которая подстраивается под любые элементы управления, нужные приложению. Чтобы получить от этого максимум пользы, нужно сопоставлять каждую деталь с текущей настройкой: актуальный CSS для стилей по умолчанию, подходящий энкодер для конкретного формата и допустимые типы элементов управления для пользовательских кнопок панели инструментов — а не полагаться на память.
+DHTMLX RichText — это лёгкий WYSIWYG-редактор с широкими возможностями конфигурации. Вы можете преобразовывать содержимое между [HTML, обычным текстом и Markdown](/#supported-formats), задавать типографику для каждого типа блока через [стили по умолчанию](guides/configuration.md#configure-default-styles) и создавать полностью настраиваемую [панель инструментов](guides/configuration.md#toolbar), которая подстраивается под любые элементы управления, нужные приложению. Чтобы получить от этого максимум пользы, нужно сопоставлять каждую деталь с текущей настройкой: актуальный CSS для стилей по умолчанию, подходящий энкодер для конкретного формата и допустимые типы элементов управления для пользовательских кнопок панели инструментов, а не полагаться на память.
MCP-сервер DHTMLX поддерживает ИИ-ассистента в курсе всего этого. [Настройка упоминаний и триггеров](guides/mentions_and_tags.md), [контракт загрузки изображений](guides/working_with_server.md) и [процесс экспорта в DOCX/PDF](api/events/export.md) — всё это возвращается из актуальной документации, поэтому сгенерированный код соответствует тому, как редактор действительно ведёт себя сегодня.
@@ -22,7 +22,7 @@ MCP-сервер DHTMLX охватывает все основные проду
## Возможности RichText в MCP-сервере {#richtext-coverage-in-the-mcp-server}
-От кнопок панели инструментов до калбэков триггеров — индекс MCP-сервера охватывает весь функционал DHTMLX RichText. Типичные запросы:
+Индекс MCP-сервера охватывает весь функционал DHTMLX RichText, от кнопок панели инструментов до калбэков триггеров. Типичные запросы:
- Поиск актуального API для [методов](api/overview/methods_overview.md), [событий](api/overview/events_overview.md) и [свойств](api/overview/properties_overview.md), включая методы [Event Bus](api/overview/event_bus_methods_overview.md) и [состояния](api/overview/state_methods_overview.md).
- Генерация готового к использованию кода [инициализации](guides/initialization.md) с контейнером, [`toolbar`](api/config/toolbar.md) и [`menubar`](api/config/menubar.md), которые нужны конкретному редактору.
@@ -42,7 +42,7 @@ MCP-сервер DHTMLX охватывает все основные проду
1. Ассистент выделяет ту часть запроса, которая требует документации: контракт запроса и ответа, который RichText ожидает от конечной точки загрузки изображений.
2. Сервер связывает её с документацией по работе с сервером.
-3. Запросу нужен рабочий код, поэтому его обрабатывает *Search* (более узкий вопрос — например, заменяет ли `insertValue()` выделение или вставляет содержимое в позицию курсора — вместо этого попал бы в *Inference*).
+3. Запросу нужен рабочий код, поэтому его обрабатывает *Search* (более узкий вопрос, например заменяет ли `insertValue()` выделение или вставляет содержимое в позицию курсора, вместо этого попал бы в *Inference*).
4. *Search* извлекает подходящие страницы из векторного индекса, построенного на основе актуальной документации по RichText.
5. Эти страницы возвращаются ассистенту в качестве контекста.
6. Ассистент настраивает обработчик загрузки в соответствии с этим контрактом, а затем самостоятельно дополняет его фактическим запросом к серверу ресурсов компании, опираясь на собственные знания.
@@ -51,7 +51,7 @@ MCP-сервер DHTMLX охватывает все основные проду
## Подключение ИИ-инструмента к MCP-серверу {#attaching-your-ai-tool-to-the-mcp-server}
-Регистрация конечной точки MCP выполняется один раз для каждого инструмента — будь то команда CLI или запись в JSON-конфигурации, — и все они указывают на один и тот же адрес:
+Регистрация конечной точки MCP выполняется один раз для каждого инструмента, будь то команда CLI или запись в JSON-конфигурации, и все они указывают на один и тот же адрес:
~~~jsx
https://docs.dhtmlx.com/mcp
@@ -199,7 +199,7 @@ MCP-сервер работает исключительно удалённо:
## Идеи промптов для разработки с RichText {#prompt-ideas-for-building-with-richtext}
-Промпты по RichText обычно относятся к одной из четырёх областей: макет, формат содержимого, работа с изображениями или упоминания и триггеры. Группы ниже организованы именно так — выберите нужную и адаптируйте под свою настройку.
+Промпты по RichText обычно относятся к одной из четырёх областей: макет, формат содержимого, работа с изображениями или упоминания и триггеры. Группы ниже организованы именно так. Выберите нужную и адаптируйте под свою настройку.
**Макет и панель инструментов**
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
index 2d0d06c..af8d661 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
@@ -147,7 +147,7 @@ new richtext.Richtext("#root", {
## Пользовательское действие при выборе {#custom-action-on-select}
-По умолчанию выбор элемента вставляет его в документ как токен. Чтобы выполнить собственный код вместо этого, добавьте колбэк `action` к триггеру. RichText удаляет введённый символ триггера и вызывает `action(item)` с выбранным элементом — токен не вставляется, и вы сами решаете, что добавить.
+По умолчанию выбор элемента вставляет его в документ как токен. Чтобы выполнить собственный код вместо этого, добавьте колбэк `action` к триггеру. RichText удаляет введённый символ триггера и вызывает `action(item)` с выбранным элементом. Токен не вставляется, и вы сами решаете, что добавить.
:::note[Примечание]
`action` имеет приоритет над `showTrigger`. Если задан `action`, значение `showTrigger` игнорируется.
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/working_with_server.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/working_with_server.md
index 3fdf90f..bd6ab4a 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/working_with_server.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/working_with_server.md
@@ -22,9 +22,9 @@ RichText работает полностью в браузере и не тре
Это работает без какого-либо бэкенда и удобно для быстрых демонстраций, но имеет очевидные ограничения:
- закодированные байты хранятся внутри документа, поэтому сохранённый HTML растёт с каждым изображением
-- одно и то же изображение в двух документах хранится дважды — общего ресурса для дедупликации нет
+- одно и то же изображение в двух документах хранится дважды, поскольку общего ресурса для дедупликации нет
- поскольку байты не являются отдельным ресурсом, сервер не может раздавать их через CDN или постобрабатывать (изменять размер, перекодировать, сканировать)
-- встроенные изображения не сохраняются при встроенном [экспорте](api/events/export.md) в форматы DOCX/PDF — если вы используете экспорт, настройте сервер загрузки, чтобы изображения ссылались на внешний URL
+- встроенные изображения не сохраняются при встроенном [экспорте](api/events/export.md) в форматы DOCX/PDF, поэтому, если вы используете экспорт, настройте сервер загрузки, чтобы изображения ссылались на внешний URL
## Напишите свой сервер {#write-your-own-server}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/index.md b/i18n/ru/docusaurus-plugin-content-docs/current/index.md
index df2f090..788b5c9 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/index.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/index.md
@@ -7,7 +7,7 @@ description: Документация по DHTMLX JavaScript RichText — обз
# Обзор RichText {#richtext-overview}
-**DHTMLX RichText** — гибкий и лёгкий WYSIWYG-редактор, написанный на JavaScript. Разработанный для удобного редактирования в современных веб-приложениях, RichText предлагает чистый интерфейс, богатые возможности форматирования и полный контроль над отображением контента. Будь то CMS, внутренний административный инструмент или встраиваемый редактор документов — RichText легко интегрируется и настраивается под ваши нужды.
+**DHTMLX RichText** — гибкий и лёгкий WYSIWYG-редактор, написанный на JavaScript. Разработанный для удобного редактирования в современных веб-приложениях, RichText предлагает чистый интерфейс, богатые возможности форматирования и полный контроль над отображением контента. Будь то CMS, внутренний административный инструмент или встраиваемый редактор документов, RichText легко интегрируется и настраивается под ваши нужды.
Компонент **DHTMLX RichText** включает следующие возможности:
@@ -103,7 +103,7 @@ const md = editor.getValue(richtext.markdown.toMarkdown);
~~~
:::note[Примечание]
-Поддержка Markdown охватывает ограниченное подмножество синтаксиса — распространённые блочные и строчные элементы: заголовки, абзацы, переносы строк, выделение, цитаты, списки и ссылки. Форматирование, не имеющее аналога в Markdown (семейство шрифта, размер шрифта, цвета, выравнивание, межстрочный интервал), при сериализации отбрасывается.
+Поддержка Markdown охватывает ограниченное подмножество синтаксиса: распространённые блочные и строчные элементы, такие как заголовки, абзацы, переносы строк, выделение, цитаты, списки и ссылки. Форматирование, не имеющее аналога в Markdown (семейство шрифта, размер шрифта, цвета, выравнивание, межстрочный интервал), при сериализации отбрасывается.
Вложенные строчные структуры не поддерживаются, за исключением **жирного внутри курсива**. Комбинации вида «жирный внутри ссылки», «курсив внутри элемента списка» или многоуровневые (вложенные) списки отображаться корректно не будут.
:::
@@ -120,10 +120,10 @@ const md = editor.getValue(richtext.markdown.toMarkdown);
Поведение при вставке зависит от источника содержимого буфера обмена:
- Вставка между двумя экземплярами RichText (в одном документе или на разных страницах) использует HTML-представление и сохраняет исходное форматирование.
-- Вставка из любого внешнего источника — браузеров, текстовых процессоров и других редакторов — обрабатывается как обычный текст. Вставляемый контент добавляется без внешнего форматирования.
+- Вставка из любого внешнего источника (браузеров, текстовых процессоров и других редакторов) обрабатывается как обычный текст. Вставляемый контент добавляется без внешнего форматирования.
:::note[Примечание]
-Кнопка **Вставить** на панели инструментов использует асинхронный Clipboard API, который предоставляет только обычный текст. Чтобы вставить контент, скопированный из другого RichText, с сохранением форматирования, используйте сочетание `Ctrl+V` / `⌘+V` — оно получает полный HTML-пакет непосредственно из события clipboard браузера.
+Кнопка **Вставить** на панели инструментов использует асинхронный Clipboard API, который предоставляет только обычный текст. Чтобы вставить контент, скопированный из другого RichText, с сохранением форматирования, используйте сочетание `Ctrl+V` / `⌘+V`, которое получает полный HTML-пакет непосредственно из события clipboard браузера.
:::
## Сочетания клавиш {#keyboard-shortcuts}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/news/migration.md b/i18n/ru/docusaurus-plugin-content-docs/current/news/migration.md
index 6a5c147..3d92734 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/news/migration.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/news/migration.md
@@ -132,7 +132,7 @@ editor.getValue(toTextEncoder);
```
:::note[Примечание]
-Вы по-прежнему можете вызывать `getValue()` и `setValue()` без энкодера — по умолчанию используется HTML
+Вы по-прежнему можете вызывать `getValue()` и `setValue()` без энкодера. По умолчанию используется HTML
:::
### - [`on`](api/internal/on.md) / [`detach`](api/internal/detach.md)
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/.sync b/i18n/zh/docusaurus-plugin-content-docs/current/.sync
index 80674c9..d0a4364 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-c5fee7e0d2c9c6fb0721c92dcafb264655069c38
+05606c5dd334f327d352f06b9d57a0c5c6965b1e
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md b/i18n/zh/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
index b8454f3..6d47f45 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/api/config/image-upload-url.md
@@ -12,7 +12,7 @@ description: 您可以在 DHTMLX JavaScript RichText 库的文档中了解 image
当该属性被设置时,RichText 会将每张插入的图片上传到指定端点,并插入服务器返回的 URL。
-当该属性被省略或设置为假值(`""`、`null`、`undefined`)时,RichText 切换到**内联模式**:图片文件在客户端读取,并以 base64 数据 URL 的形式直接嵌入到内容中——无需服务器。大于 1024×800 的内联图片将按比例缩小以适应此限制。
+当该属性被省略或设置为假值(`""`、`null`、`undefined`)时,RichText 切换到**内联模式**:图片文件在客户端读取,并以 base64 数据 URL 的形式直接嵌入到内容中,无需服务器。大于 1024×800 的内联图片将按比例缩小以适应此限制。
:::note[备注]
内联(base64)图片无法通过内置的 DOCX / PDF [导出](api/events/export.md)功能保留。如果您依赖导出功能,请提供 `imageUploadUrl`,使图片引用外部地址。
@@ -40,7 +40,7 @@ new richtext.Richtext("#root", {
});
~~~
-以 base64 方式内联插入图片(无需服务器)——省略该属性或传入空字符串:
+要以 base64 方式内联插入图片(无需服务器),请省略该属性或传入空字符串:
~~~jsx {2}
new richtext.Richtext("#root", {
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md
index 0e2f3b5..69bfd64 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md
@@ -271,7 +271,7 @@ new richtext.Richtext("#root", {
});
~~~
-大于 1024×800 的内联图片将以缩小尺寸显示(`width`/`height` 属性会被限制在此范围内),但嵌入的字节数据仍为原始全分辨率文件——客户端不会对其进行降采样或重新编码。
+大于 1024×800 的内联图片将以缩小尺寸显示(`width`/`height` 属性会被限制在此范围内),但嵌入的字节数据仍为原始全分辨率文件。客户端不会对其进行降采样或重新编码。
:::note[备注]
内联(base64)图片不会被内置的 DOCX / PDF [导出](api/events/export.md) 功能保留。如果您依赖导出功能,请提供 `imageUploadUrl`,以便图片引用外部位置。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md
index 5a6bfce..3db4396 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md
@@ -6,7 +6,7 @@ description: MCP 服务器为 AI 助手提供关于 DHTMLX RichText 样式默认
# DHTMLX RichText MCP 服务器:格式、工具栏与触发器 {#dhtmlx-richtext-mcp-server-formats-toolbar-and-triggers}
-DHTMLX RichText 是一款配置选项丰富的轻量级 WYSIWYG 编辑器。您可以在 [HTML、纯文本和 Markdown](/#supported-formats) 之间转换内容,通过 [样式默认值](guides/configuration.md#configure-default-styles) 为每种块类型设置排版样式,并构建完全可自定义的 [工具栏](guides/configuration.md#toolbar),使其适应应用程序所需的任意控件。要充分发挥这些功能的价值,需要将每个部分与当前配置相匹配:为样式默认值匹配当前的 CSS,为特定格式匹配正确的编码器,为自定义工具栏按钮匹配有效的控件类型——而不是凭记忆猜测。
+DHTMLX RichText 是一款配置选项丰富的轻量级 WYSIWYG 编辑器。您可以在 [HTML、纯文本和 Markdown](/#supported-formats) 之间转换内容,通过 [样式默认值](guides/configuration.md#configure-default-styles) 为每种块类型设置排版样式,并构建完全可自定义的 [工具栏](guides/configuration.md#toolbar),使其适应应用程序所需的任意控件。要充分发挥这些功能的价值,需要将每个部分与当前配置相匹配:为样式默认值匹配当前的 CSS,为特定格式匹配正确的编码器,为自定义工具栏按钮匹配有效的控件类型,而不是凭记忆猜测。
DHTMLX MCP 服务器让 AI 助手始终掌握所有这些内容的最新情况。[Mentions 与触发器设置](guides/mentions_and_tags.md)、[图片上传契约](guides/working_with_server.md) 以及 [DOCX/PDF 导出流程](api/events/export.md) 均来自最新文档,因此生成的代码与编辑器当前的实际行为保持一致。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
index 24e8224..5547968 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mentions_and_tags.md
@@ -147,7 +147,7 @@ new richtext.Richtext("#root", {
## 选择时执行自定义动作 {#custom-action-on-select}
-默认情况下,选择条目会将其作为 token 插入文档。若要改为执行自己的代码,可在触发器中添加 `action` callback。RichText 会删除已输入的触发文本并以所选条目调用 `action(item)`——不插入 token,由你决定添加什么内容。
+默认情况下,选择条目会将其作为 token 插入文档。若要改为执行自己的代码,可在触发器中添加 `action` callback。RichText 会删除已输入的触发文本并以所选条目调用 `action(item)`。不插入 token,由你决定添加什么内容。
:::note[备注]
`action` 优先于 `showTrigger`。设置 `action` 后,`showTrigger` 将被忽略。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/working_with_server.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/working_with_server.md
index 8ee6080..82332b9 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/working_with_server.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/working_with_server.md
@@ -17,14 +17,14 @@ RichText 完全在浏览器中运行,无需后端即可进行内容编辑或
## 默认行为:内联图片 {#default-behavior-inline-images}
-如果未设置 [`imageUploadUrl`](api/config/image-upload-url.md) 属性,RichText 将回退到内联图片模式。当用户插入图片时,RichText 在浏览器中读取文件,将原始文件编码为 `data:image/...;base64,...` URL,并将其直接写入编辑器内容,作为 `
` 元素的 `src`。RichText 通过 `width`/`height` 属性将显示尺寸限制在 1024×800 的范围内,但嵌入的字节仍是原始的全分辨率文件——客户端不会对其进行缩放或重新编码。
+如果未设置 [`imageUploadUrl`](api/config/image-upload-url.md) 属性,RichText 将回退到内联图片模式。当用户插入图片时,RichText 在浏览器中读取文件,将原始文件编码为 `data:image/...;base64,...` URL,并将其直接写入编辑器内容,作为 `
` 元素的 `src`。RichText 通过 `width`/`height` 属性将显示尺寸限制在 1024×800 的范围内,但嵌入的字节仍是原始的全分辨率文件。客户端不会对其进行缩放或重新编码。
此方式无需任何后端,适合快速演示,但存在明显的局限性:
- 编码后的字节存储在文档内部,因此每插入一张图片,保存的 HTML 文件就会增大
- 同一张图片在两份文档中各存储一份,没有共享资源可供去重
- 由于字节不是独立资源,服务器无法通过 CDN 提供服务,也无法对其进行后处理(缩放、重新编码、扫描)
-- 内联图片不会被内置的 DOCX / PDF [导出](api/events/export.md) 功能保留——如果依赖导出功能,请配置上传服务器,使图片引用外部 URL
+- 内联图片不会被内置的 DOCX / PDF [导出](api/events/export.md) 功能保留,因此如果依赖导出功能,请配置上传服务器,使图片引用外部 URL
## 编写自己的服务器 {#write-your-own-server}
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/index.md b/i18n/zh/docusaurus-plugin-content-docs/current/index.md
index 86f65f0..292f507 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/index.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/index.md
@@ -103,7 +103,7 @@ const md = editor.getValue(richtext.markdown.toMarkdown);
~~~
:::note[备注]
-Markdown 支持涵盖有限的语法子集——包括标题、段落、换行、强调、块引用、列表和链接等常见块级和内联元素。在序列化时,没有对应 Markdown 语法的格式(字体系列、字体大小、颜色、对齐方式、行高)将被丢弃。
+Markdown 支持涵盖有限的语法子集,即标题、段落、换行、强调、块引用、列表和链接等常见块级和内联元素。在序列化时,没有对应 Markdown 语法的格式(字体系列、字体大小、颜色、对齐方式、行高)将被丢弃。
不支持嵌套内联结构,唯一的例外是 **斜体中的加粗**。加粗内嵌链接、列表项中的斜体或多级(嵌套)列表等组合将无法正确渲染。
:::
@@ -120,7 +120,7 @@ RichText 编辑器通过标准系统快捷键支持剪贴板操作(Windows/Lin
粘贴行为取决于剪贴板内容的来源:
- 在两个 RichText 实例之间粘贴(在同一文档或不同页面中)将使用 HTML 表示形式并保留原始格式。
-- 从任何外部来源粘贴——包括浏览器、文字处理器和其他编辑器——将作为纯文本处理。插入的内容将以不带外部格式的文本形式添加。
+- 从任何外部来源(包括浏览器、文字处理器和其他编辑器)粘贴的内容将作为纯文本处理。插入的内容将以不带外部格式的文本形式添加。
:::note[备注]
工具栏的 **粘贴** 按钮使用异步 Clipboard API,该 API 仅公开纯文本。若要粘贴从另一个 RichText 复制的内容并保留其格式,请使用 `Ctrl+V` / `⌘+V` 快捷键,该快捷键可直接从浏览器的剪贴板事件中接收完整的 HTML 内容。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/news/migration.md b/i18n/zh/docusaurus-plugin-content-docs/current/news/migration.md
index d55aea1..7922709 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/news/migration.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/news/migration.md
@@ -132,7 +132,7 @@ editor.getValue(toTextEncoder);
```
:::note[备注]
-您仍然可以不带编码器调用 `getValue()` 和 `setValue()`——默认使用 HTML 格式
+您仍然可以不带编码器调用 `getValue()` 和 `setValue()`,此时默认使用 HTML 格式
:::
### - [`on`](api/internal/on.md) / [`detach`](api/internal/detach.md) {#--on--detach}