Smart Paste Support

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), or other document types within Oxygen XML Editor plugin, and then paste it into DITA, TEI, DocBook, JATS, and XHTML documents. Oxygen XML Editor 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 plugin will attempt to place it in a valid location, and may prompt you with one or more choices for where to place it.

Smart Paste Options

By default, the Smart Paste features are enabled in Oxygen XML Editor plugin. There are several options in the Schema Aware preferences page that control the Smart Paste feature:

  • Smart paste and drag and drop - This option determines whether or not Oxygen XML Editor plugin will try to find an appropriate insert position when the current location is not valid for the pasted content. This option is enabled by default.
  • Reject action when its result is invalid - If you enable this option, Oxygen XML Editor plugin will not let you paste content into a position where it would be invalid. This option is disabled by default.
  • Convert external content on paste - This option determines whether or not Oxygen XML Editor 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 enabled by default.
  • Convert even when pasting inside space-preserve elements - If you enable 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 disabled by default.

Smart Paste Supported Document Types

The Smart Paste feature is supported for the following document types (frameworks):

  • DITA
  • DocBook 4
  • DocBook 5
  • TEI P4
  • TEI P5
  • XHTML
  • JATS

To watch our video demonstration about the Smart Paste support, go to https://www.oxygenxml.com/demo/Smart_Paste_Copy_Paste_from_Web_Office_Documents_to_DITA_DocBook_TEI_XHTML_Documents.html.

Was this helpful?