Smart Paste in Author Mode
The Author editing mode includes a Smart Paste feature that preserves certain style and structure information when copying content and pasting it into document types that support the feature. You can copy content from various sources, including web pages, external applications (such as Office-type applications), Markdown documents, or other types of documents and then paste it into DITA, TEI, DocBook, JATS, and XHTML documents. Oxygen XML Editor Eclipse plugin preserves the original text styling (such as bold, italics, underline) and formatting (such as lists, tables, paragraphs) and considers various pasting solutions to keep the resulting document valid.
The styles and general layout of the pasted content are converted to the equivalent XML markup for the target document type while preserving certain style and structure information. For example, if you copy content that includes multiple paragraphs and then paste it in Author mode, the multiple paragraph structure is preserved. If you paste the content in a location where the resulting XML would not be valid, Oxygen XML Editor Eclipse plugin will attempt to place it in a valid location, and may prompt you with one or more choices for where to place it.
- When pasting text fragments formatted with the Courier New
font, the Smart Paste mechanism will wrap it in an inline code element (for
example, in DITA it would be wrapped in a
<codeph>
element). - Review comments that exist in the copied Word content are intentionally ignored when pasting the content in Author mode.
Smart Paste Options
- Smart paste and drag and drop - This option determines whether or not Oxygen XML Editor Eclipse plugin will try to find an appropriate insert position when the current location is not valid for the pasted content. This option is selected by default.
- Reject action when its result is invalid - If you select this option, Oxygen XML Editor Eclipse plugin will not let you paste content into a position where it would be invalid. This option is deselected by default.
- Convert external content on paste - This option determines whether or not Oxygen XML Editor Eclipse plugin will convert the styling and formatting of copied content from external sources when pasting it into a document type that supports the feature. This option is selected by default.
- Convert even when pasting inside space-preserve
elements - If you select this option, the Smart Paste
feature will also work when pasting external content into a space-preserve
element (such as a
<codeblock>
). This option is deselected by default.
Smart Paste Supported Document Types
- DITA
- DocBook 4
- DocBook 5
- TEI
- XHTML
- JATS
Resources
For more information about the Smart Paste support, watch our video demonstration: