Skip to content

Latest commit

 

History

History
85 lines (60 loc) · 4.58 KB

README.md

File metadata and controls

85 lines (60 loc) · 4.58 KB
Raw
category order url menu-title meta-title-short
inserting-content
60
features/pastefromlibreoffice
Paste from LibreOffice
Paste from LibreOffice

Pasting Content from LibreOffice

This feature is provided through the Paste from LibreOffice plugin that is included in the Standard and Full presets available from the official CKEditor 4 Download site. You can also {@link guide/dev/plugins/README add it to your custom build} with online builder.

The Paste from LibreOffice plugin allows you to paste content from LibreOffice Writer and maintain original content structure and formatting.

When enabled, it automatically detects LibreOffice Writer content and transforms its structure and formatting to clean HTML.

Supported Features

Paste from LibreOffice retains the following formatting:

  • Text formatting
    • Text and background colors
    • Font family, style and size
    • Basic formatting (bold, italic, underline)
    • Font effects (strikethrough, superscript, subscript)
    • Heading levels
    • Text alignment
  • Lists
    • Numbered and bulleted lists
    • Multilevel lists
    • Different numbering formats (Roman, decimal, alphanumeric)
    • Custom start number (e.g. you can start the list from number 4)
  • Tables
    • Borders and shading
    • Cell size (width and height)
    • Cell alignment
  • Images

The Paste from LibreOffice plugin maintains most of LibreOffice Writer text formatting features with some exceptions related to advanced styling, customizations, or styles that are not supported by HTML.

The plugin is supported only in Google Chrome, Mozilla Firefox and Microsoft Edge browsers. In Safari and Internet Explorer it is not possible to detect if the content is copied from LibreOffice Writer. However, even without the official support for the plugin, most of the formatting should be preserved correctly upon pasting in these browsers.

Sample

The following sample content from a LibreOffice Writer document:

{@img assets/img/pastefromlibreoffice_01.png 599 A sample LibreOffice Writer document.}

will look like below after pasting to CKEditor 4 with the Paste from LibreOffice plugin enabled:

{@img assets/img/pastefromlibreoffice_02.png 956 LibreOffice Writer content pasted into CKEditor 4 WYSIWYG editor.}

Here is another sample with some more complicated formatting and styling as well as an image:

{@img assets/img/pastefromlibreoffice_03.png 599 A sample LibreOffice Writer document with complex formatting and image.}

It will look like this after pasting into CKEditor 4:

{@img assets/img/pastefromlibreoffice_04.png 954 Complex LibreOffice Writer content pasted into CKEditor 4 WYSIWYG editor.}

Filters

HTML exposed by LibreOffice Writer does not fully comply to rules of valid and semantic HTML. Therefore, a separate filter had to be created to normalize this content. It is implemented in the Paste from LibreOffice plugin.

Paste from LibreOffice Demo

See the {@linkexample pastefromlibreoffice working "Pasting content from LibreOffice" sample} that showcases the Paste from LibreOffice plugin.

Related Features

Refer to the following resources for more information about pasting content:

  • The {@link features/pastefromword/README Pasting content from Microsoft Word} article contains more information about the Paste from Word feature.
  • The {@link features/pastefromexcel/README Pasting content from Microsoft Excel} article contains more information about the Paste from Excel feature.
  • The {@link features/pastefromgoogledocs/README Pasting content from Google Docs} article contains more information about the Paste from Google Docs feature.
  • The {@link guide/dev/deep_dive/clipboard/README Clipboard Integration} article explains how Clipboard API is implemented in CKEditor 4.
  • The {@link guide/dev/integration/file_browse_upload/file_upload/README Uploading Dropped or Pasted Files} article describes drag&drop in CKEditor 4.
  • The {@link guide/dev/acf/README Content Filtering (ACF)} is an introduction to CKEditor's unique content filtering system.
  • The {@link features/styles/README Applying Styles to Editor Content} article discusses creating more semantically correct text styles.