No Description

Piotrek Koszuliński 80200dc33b Docs: Refactored wide content styles - used special guide's class. [skip ci] 7 years ago
.github 0f317a9cd4 Docs: Optimized PNG screenshots (see #869). 7 years ago
docs 80200dc33b Docs: Refactored wide content styles - used special guide's class. [skip ci] 7 years ago
scripts fd2a806f88 Other: Unify `getPostCssConfig()` from @ckeditor/ckeditor5-dev-utils package. 7 years ago
.editorconfig dd7edf242e Initialized .editorconfig. 11 years ago
.eslintrc.js 2600b6948a Internal: Bumped the year. 8 years ago
.gitattributes bab0e300aa Initialized .gitattributes 11 years ago
.gitignore 2d4705c7dd Internal: Remove gulp dependency for pre-commit linting. 8 years ago
.travis.yml 7c5236a89b Sped up the installation (lerna bootstrap covers all anyway) and fixed a typo. 8 years ago
CHANGELOG.md e16e382254 Docs: Corrected the changelog. [skip ci] 7 years ago
CONTRIBUTING.md fc9a6198fd Docs: Fixed link to CLA page. Closes #405. 8 years ago
LICENSE.md 2600b6948a Internal: Bumped the year. 8 years ago
README.md 16d5da500a Docs: Mentioned all new pkgs in the readme. 7 years ago
lerna.json daa93c3bc2 Make husky installed in all subpackages. 8 years ago
mgit.json 752f68e325 Internal: use stable branches. [skip ci] 7 years ago
package.json e630fb3499 1.0.0-beta.1 7 years ago

README.md

CKEditor 5 Tweet

Build Status BrowserStack Status Dependency Status devDependency Status

Join newsletter Follow twitter

A set of ready to use rich text editors created with a powerful framework. Made with real-time collaborative editing in mind.

CKEditor 5 Classic editor build screenshot

Table of contents

Quick start

CKEditor 5 Builds

CKEditor 5 Builds are a set of ready to use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration.

The following CKEditor 5 Builds are currently available:

Example

Creating an editor using a CKEditor 5 build is very simple and can be described in two steps:

  1. Load the desired editor via the <script> tag.
  2. Call the static create() method to create the editor.

In your HTML page add an element that CKEditor should replace:

<textarea name="content" id="editor"></textarea>

Load the classic editor build (here CDN location is used):

<script src="https://cdn.ckeditor.com/ckeditor5/<version>/classic/ckeditor.js"></script>

Call the ClassicEditor.create() method:

<script>
    ClassicEditor
        .create( document.querySelector( '#editor' ) )
        .catch( error => {
            console.error( error );
        } );
</script>

You’re ready to go!

To find out how to start with other builds please go to the quick start section of CKEditor 5 documentation.

CKEditor 5 Framework

CKEditor 5 Builds allow you to quickly and easily initialize one of the many types of editors in your application. At the same time, CKEditor 5 is also a framework for creating custom-made rich text editing solutions.

To find out how to start building your own editor from scratch go to CKEditor 5 Framework overview section of CKEditor 5 documentation.

Documentation and FAQ

To find out more see the following CKEditor 5 documentation sections:

The documentation is far from being complete and will be constantly evolving (as will the editor) until it is ready for v1.0.0.

For FAQ please go to the CKEditor Ecosystem help center. For a high-level overview of the project see the CKEditor Ecosystem website.

Contributing and project organization

Ideas and discussions

The main development repository of CKEditor 5 is located at https://github.com/ckeditor/ckeditor5. This is the best place for bringing opinions and contributions. Letting the core team know if they are going in the right or wrong direction is great feedback and will be much appreciated!

Development

CKEditor 5 is a modular, multi-package, multi-repository project. It consists of a several packages which create the editing framework, based on which the feature packages are implemented.

The ckeditor5 repository is the place that centralizes the development of CKEditor 5. It bundles different packages into a single place, adding the necessary helper tools for the development workflow, like the builder and the test runner. Basic information on how to set up the development environment can be found in the documentation.

Reporting issues and feature requests

Each repository independently handles its issues. However, it's recommended to report issues in this repository unless you know to which specific repository the issue belongs.

Read more in the Support page.

Releases

The latest five releases:

For more CKEditor 5 release blog posts browse the CKEditor blog.

Packages

Core libraries

Name Version Description
@ckeditor/ckeditor5-engine The editing engine.
@ckeditor/ckeditor5-core The core editor architecture.
@ckeditor/ckeditor5-ui The editor UI library.
@ckeditor/ckeditor5-utils The editor utilities library.
@ckeditor/ckeditor5-upload Introduces the file upload utilities.
@ckeditor/ckeditor5-widget Introduces the widget API.
@ckeditor/ckeditor5-cloudservices CKEditor 5's Cloud Services integration layer.

Editors

Name Version Description
@ckeditor/ckeditor5-editor-classic The classic editor implementation.
@ckeditor/ckeditor5-editor-inline The inline editor implementation.
@ckeditor/ckeditor5-editor-balloon The balloon editor (Medium-like) implementation.
@ckeditor/ckeditor5-editor-decoupled The editor implementation with a decoupled UI.

Features

Name Version Description
@ckeditor/ckeditor5-adapter-ckfinder Introduces the CKFinder adapter for features which require upload capabilities.
@ckeditor/ckeditor5-alignment Introduces the text alignment feature.
@ckeditor/ckeditor5-autoformat Introduces the autoformatting feature. Replaces predefined characters with a corresponding format (e.g. **foo** becomes bolded <strong>foo</strong>).
@ckeditor/ckeditor5-basic-styles Introduces the bold, italic, underline and code features.
@ckeditor/ckeditor5-block-quote Introduces the block quote feature.
@ckeditor/ckeditor5-clipboard Introduces the clipboard integration.
@ckeditor/ckeditor5-enter Introduces the Enter key feature.
@ckeditor/ckeditor5-easy-image Introduces Easy Image with Cloud Services feature.
@ckeditor/ckeditor5-font Introduces the font size and font family features.
@ckeditor/ckeditor5-heading Introduces the heading feature.
@ckeditor/ckeditor5-highlight Introduces the highlight feature (markers and pens).
@ckeditor/ckeditor5-image Introduces the image feature. Supports image styles and captioning.
@ckeditor/ckeditor5-link Introduces the link feature.
@ckeditor/ckeditor5-list Introduces numbered and bulleted lists feature.
@ckeditor/ckeditor5-markdown-gfm Introduces GitHub-flavored Markdown data processor.
@ckeditor/ckeditor5-paragraph Introduces the paragraph feature.
@ckeditor/ckeditor5-typing Introduces typing and deleting features.
@ckeditor/ckeditor5-undo Introduces the undo feature.

Themes

Name Version Description
@ckeditor/ckeditor5-theme-lark The Lark theme. ckeditor5-theme-lark npm package badge build status badge

Builds

Name Version Description
@ckeditor/ckeditor5-build-classic The classic editor build.
@ckeditor/ckeditor5-build-inline The inline editor build.
@ckeditor/ckeditor5-build-balloon The balloon editor (Medium-like) build.
@ckeditor/ckeditor5-build-decoupled-document The document editor build, featuring the decoupled UI editor implementation.

License

Licensed under the GPL, LGPL and MPL licenses, at your choice. For full details about the license, please check the LICENSE.md file.