Next#52
Merged
Merged
Conversation
- index.md: list Markdown alongside HTML and plain text in features and Supported formats; add example with richtext.markdown encoders and a note on the supported subset - get-value.md / set-value.md: include markdown in the encoder list and show richtext.markdown.toMarkdown / fromMarkdown usage
- new article docs/api/methods/insert-value.md covering description, parameters (value, optional encoder), encoder snippet (text/html/markdown), example and v2.1 change log - register the method in sidebars.js and in main_overview.md / methods_overview.md tables
- new "Copy and paste" section in index.md describing system shortcuts, toolbar/menubar entries, plain-text + HTML clipboard payload, paste fallback to plain text, and behavior across RichText instances and external sources - note that the toolbar Paste button uses the async Clipboard API (plain text only), while Ctrl+V / ⌘V receives full HTML
- image-upload-url.md: describe optional behavior — when imageUploadUrl is omitted, images are inserted as base64 data URLs with 1024x800 downscaling; add upload vs inline examples and note caveats around DOCX/PDF export and payload size - guides/configuration.md: rename "Configure the image upload URL" to "Configure image insertion" and split into server-upload vs inline base64 modes - insert-image.md: clarify that IImageContext.value holds either an external URL or a base64 data URL - index.md: mention server upload and inline base64 in the features list
- macOS shortcuts now follow Ctrl+C style: ⌘+C / ⌘+X / ⌘+V (incl. the note about ⌘+V) - clarify that pasting from any external source is processed as plain text; previous wording about HTML-aware external paste was incorrect - drop the separate plain-text-source bullet; external-source behavior is now one line
- drop "fully" from "fully optional" in the v2.1 change-log note
- @short now describes the inserted content as "text, Markdown, or HTML" instead of the abstract "a value" - drop "from a custom format" from the encoder description; the supported formats are listed on the next line
- extend Markdown support note in docs/index.md - document that nested inline structures are unsupported - call out bold-inside-italic as the only exception - list bold-in-link, italic-in-list, multi-level lists as cases that won't render correctly
- new API reference page for the hide-suggest event - documents when the dropdown closes (selection, Escape, cursor leaves trigger, empty result)
- new API reference page for the insert-token event - documents callback fields (id, label, url, trigger, showTrigger)
- new API reference page for the show-suggest event - documents callback fields (trigger, query, items, pos) and intercept example
- new API reference page for the triggers property - covers static array, sync function, async function data sources - documents suggestion item fields and rendered token CSS targeting
- new API reference page for the triggerTemplate property - documents callback parameters (data, trigger) and template usage - includes tip on overriding the dropdown anchor width
- new guide covering trigger characters, data source forms, token rendering, and event handling - examples for static array, sync function, async function, and custom dropdown templates
- list hide-suggest, insert-token, and show-suggest in the events table
- list triggers and triggerTemplate in the properties table
- list triggers in the property overview with a link to the Mentions and tags guide
- update anchor in whats_new from #custom-toolbar-controls to #add-custom-toolbar-controls to match the heading in configuration.md
- add hide-suggest, insert-token, show-suggest under events - add triggers and trigger-template under properties - add mentions_and_tags under guides
- add `action` field to triggers config with Custom action section (emoji insertion and slash-style command menu examples) - update insert-token event payload: id/label/url replaced by `data` object carrying the picked item plus custom fields; add `action` - note that `action` takes priority over `showTrigger` - show-suggest items now documented as optional fields + custom keys - extend mentions guide with custom action examples - fix typos, a broken anchor, and align wording across pages
- destructure ({ data, trigger, showTrigger }) to match the
insert-token event docs and the PR review suggestion
- mark suggestion `label` as optional (custom triggerTemplate case) - note Ctrl+Click opens token url, explain mailto behavior - break down rendered token attributes (trigger/id/url/label) - clarify custom action can run code without inserting content - add "Group emoji by category" example with custom filtering, category headers and api.intercept guard - triggerTemplate: add second trigger so trigger check is meaningful, replace !important width tip with more specific selector
[update] note paste and drag-and-drop as image upload sources
…AR-2920 # Conflicts: # docs/guides/configuration.md
[add] document inline base64 image insertion
[add] document copy and paste behavior
[add] document insertValue() method
- merge the Copy and paste section from the base branch with the new Markdown format section - pull in the expanded image uploading feature line from base - fix misleading example: Markdown cannot be passed via the value config (always parsed as HTML), use setValue with the markdown encoder instead
… into sp-next-v-SVAR-2919 # Conflicts: # docs/index.md
[add] document Markdown encoder support
Describe new API related to triggers
- trigger-template: "the template use" -> "uses" - triggers: "instead of selected one" -> "instead of the selected one" - mentions_and_tags: align dash in trigger list, drop stray space in note - set-value: encoder describes decoding the value from a format (consistent with insertValue)
- new functionality: optional imageUploadUrl, Markdown support, triggers, triggerTemplate, custom trigger action - new API: triggers/triggerTemplate properties, insertValue() method, show-suggest/insert-token/hide-suggest events - fixes: clipboard copy/cut/paste with formatting between instances
- whats_new: add drag-and-drop image insertion and word/line deletion shortcuts - whats_new: move clipboard support to New functionality, fix wording - whats_new: replace Fixes with inline-paste and image-drop bug fixes - index: add Delete word/line shortcuts and Indentation table to keyboard shortcuts - triggers: align id type with source TID (string | number)
- new guides/working_with_server.md covering the image upload contract: default inline-base64 behavior, POST request shape (multipart, field name "upload"), expected JSON response (status/value/width/height), how the returned URL is reused as the <img src>, and a demo backend URL to try the flow against - sidebar entry under Guides, after Configuration - cross-links from imageUploadUrl API page and the "Configure the image upload URL" section in configuration.md
- convert gerund headings to imperative (Write/Serve) - replace passive voice with active and Future with Present Simple - add intro sentences before JSON response code blocks - unify list punctuation and fix wording inconsistencies
- inline images embed original full-resolution bytes, not a downscaled copy; size is constrained only via width/height attrs - clarify that "server" is the required success marker for status and other values signal a failed upload
- rewrite inline-image limitations list to drop overlapping points - switch passive "is constrained" to active voice - simplify status field note and restore "image is not inserted" - replace vague "everything that happens later" phrasing - fix "etc" punctuation
- soften status-field wording: success/failure is detected by the uploader layer; RichText builds the image from value/width/height - add limitation note that inline images are dropped by DOCX/PDF export
[add] working-with-server guide
Changes before relese v2.1
- add i18n config block (5 locales + localeConfigs) and locale dropdown - generate translation scaffolding and empty content dirs per locale - translate navbar, footer, sidebar categories and custom UI strings - fill German DocSearch/SearchModal strings missing from bundled set - all five locales (en, ru, de, zh, ko) build successfully
- translate all 80 docs articles to German into i18n/de current - preserve @getshort macros, code, links, slugs and heading anchors - add explicit German admonition titles (Hinweis/Tipp/Info/Warnung/...) - copy docs assets into the locale folder; write .sync marker - fix md-data-transformer plugin to also process i18n/ content (without it @getshort and doc-relative links break in localized builds) - de build is clean: 0 broken links, macros expand, lang=de
- translate all 80 docs articles to Chinese into i18n/zh current - preserve @getshort macros, code, links, slugs and heading anchors - add explicit Chinese admonition titles (信息/注意/提示/警告/...) - apply CJK/Latin spacing convention; copy assets; write .sync marker - zh build is clean: 0 broken links, macros expand, lang=zh-CN
- translate all 80 docs articles to Korean into i18n/ko current - preserve @getshort macros, code, links, slugs and heading anchors - add explicit Korean admonition titles (참고/팁/정보/경고/주의/중요) - use formal 합니다체 register; copy assets; write .sync marker - ko build is clean: 0 broken links, macros expand, lang=ko
- 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
- move all images from docs/assets to static/img (single shared copy) - repoint markdown image refs to root-absolute /img/... paths - update refs across en + ru/de/zh/ko (35 .md files) - remove duplicate per-locale i18n assets folders (36 files) - builds clean for all locales (0 broken links/anchors)
- comment out editUrl so the "Edit this page" link is not generated
- converted bold-formatted API names to inline code (backticks) in English source and all i18n locales (ru/de/zh/ko) - event names in callback descriptions, locale/setLocale(), layoutMode "classic"/"document" values - prose feature links toolbar/menubar/locale normalized to backticked API identifiers in every locale (replacing translated labels); descriptive layout/fullscreen/default styles links kept as prose - fixed insert-link.md callback referencing update-link event
- translated English comments left inside code blocks across ru/de/zh/ko locales (mostly inline `// ...` comments missed during article translation) - covers encoder labels, init/destroy/import snippets, toolbar button option comments, locale notes, CSS comments, etc. - preserved code, API names, string literals, identifiers and comment markers; value-enumeration comments (font/size lists, emoji code example) intentionally kept in English - English source docs/ untouched
- replace filename-only/generic alt (Menubar, Toolbar, Classic mode, RichText initialization, etc.) with meaningful descriptions on docs screenshots - localize alt text per locale (en, ru, de, ko, zh) to match each translation - guide screenshots get framework-specific alt (React/Angular/Vue/Svelte)
Translations for ru, de, zh, ko
- link v2.1 samples in What's new (triggers, formats, insertValue) - add Related sample links to new v2.1 API: triggers, triggerTemplate, insertValue, show-suggest, insert-token, hide-suggest, and markdown-aware setValue - add sample links to guides: mentions and tags, configuration, initialization
- update ru, de, zh, ko translations to match English HEAD - add "Related samples/articles" snippet links across API and guides - update image paths to /img and translate descriptive alt text - wrap API names in inline code, translate added "see the ... sample" notes - advance .sync markers for all four locales to 8c89a96
- new What's new 2.1 entry on Tab / Shift+Tab block-indentation shortcuts - generalize the Indentation shortcuts table in index.md beyond lists - set Version 2.1 release date to June 22, 2026 - synced across all locales (en, ru, de, ko, zh)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.