Răsfoiți Sursa

Docs: Updated the guide text and renamed the snippets.

Anna Tomanek 5 ani în urmă
părinte
comite
711e943d5f

+ 1 - 1
packages/ckeditor5-clipboard/docs/_snippets/features/paste-plaintext.html → packages/ckeditor5-clipboard/docs/_snippets/features/paste-plain-text.html

@@ -1,4 +1,4 @@
-<div id="snippet-paste-plaintext">
+<div id="snippet-paste-plain-text">
 	<h2>On emphasis</h2>
 	<p>In typography, emphasis is the strengthening of words in a text with a font in a different style from the rest of the text, to highlight them. This may include text in <em>italics</em>, <strong>bold</strong>, <u>underlined</u> or <s>strikethrough</s> words or whole paragraphs.</p>
 	<h3>Italic type</h3>

+ 1 - 1
packages/ckeditor5-clipboard/docs/_snippets/features/paste-plaintext.js → packages/ckeditor5-clipboard/docs/_snippets/features/paste-plain-text.js

@@ -8,7 +8,7 @@
 import { CS_CONFIG } from '@ckeditor/ckeditor5-cloud-services/tests/_utils/cloud-services-config';
 
 ClassicEditor
-	.create( document.querySelector( '#snippet-paste-plaintext' ), {
+	.create( document.querySelector( '#snippet-paste-plain-text' ), {
 		toolbar: {
 			items: [
 				'heading',

+ 10 - 10
packages/ckeditor5-clipboard/docs/features/paste-plaintext.md

@@ -8,32 +8,32 @@ order: 30
 
 # Pasting plain text
 
-The plain text pasting feature is provided through the {@link module:clipboard/clipboard~Clipboard} plugin, which is responsible for the integration with the native clipboard and intercepts all native events like `copy`, `cut` or `drop` and handles them on its side. The goal is to not allow the browser to touch the content in the rich text editor which would lead to unexpected results in handling the content.
+The plain text pasting feature is implemented by the {@link module:clipboard/clipboard~PastePlainText} plugin which is a part of the {@link module:clipboard/clipboard~Clipboard} plugin.
 
-Pasting plain text with a double line break will turn the break into a paragraph. A single line break will instead be turned into a soft break upon pasting.
-
-## Keyboard shortcut
+It detects the <kbd>Ctrl</kbd>/<kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> keystroke during the paste and causes the pasted text to inherit the styles of the content it was pasted into. In this sense, the feature can also be described as "pasting without formatting" &mdash; the source formatting of the pasted text gets replaced with the target formatting of the text it was pasted into.
 
-The plain text pasting itself is further aided by the {@link module:clipboard/clipboard~PastePlainText} plugin. It detects the <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd> keystroke during the paste and causes the pasted plain text to inherit the styles of the content it was pasted into.
+Pasting plain text with a double line break will turn the break into a paragraph. A single line break will instead be turned into a soft break upon pasting.
 
 ## Demo
 
-Paste plain text between the styled paragraphs below using the <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd> to test the style inheritance. Paste without modifier to retain unstyled text. You can copy this very paragraph or one from the demo for convenience.
+Paste plain text between the styled paragraphs below using the <kbd>Ctrl</kbd>/<kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> to test the style inheritance. Paste without the <kbd>Shift</kbd> modifier to retain unstyled text. You can copy this very paragraph or one from the demo for convenience.
 
-{@snippet features/paste-plaintext}
+{@snippet features/paste-plain-text}
 
 ## Related features
 
 CKEditor 5 supports a wider range of paste features, including:
-* {@link features/paste-from-word Paste from Word} &ndash; Allows you to paste content from Microsoft Word and maintain the original structure and formatting.
-* {@link features/paste-from-google-docs Paste from Google Docs} &ndash; Allows you to paste content from Google Docs maintaining the original formatting and structure.
+* {@link features/paste-from-word Paste from Word} &ndash; Paste content from Microsoft Word and maintain the original structure and formatting.
+* {@link features/paste-from-google-docs Paste from Google Docs} &ndash; Paste content from Google Docs, maintaining the original formatting and structure.
 
 ## Installation
 
 <info-box info>
-	This feature is enabled by default in all official builds. <!-- The installation instructions are for developers interested in building their own custom rich-text editor. -->
+	This feature is enabled by default in all official builds. The installation instructions are for developers interested in building their own custom rich-text editor.
 </info-box>
 
+<!-- TODO Installation instructions -->
+
 ## Support for other applications
 
 You can find more information regarding compatibility with other applications in [this ticket](https://github.com/ckeditor/ckeditor5/issues/1184#issuecomment-409828069).