CKEditor 5 editor generated with the online builder

This repository presents a CKEditor 5 editor build generated by the Online builder tool

Quick start

1. Open the sample/index.html page in the browser.

If you picked the real-time collaboration plugins:

2. Fill the dialog with correct token, websocket and upload URL endpoints. If you do not have these yet or do not know their meaning, contact us.

3. Copy the URL and share it or paste in another tab to enjoy real-time collaborative editing.

If you picked the non-real-time collaboration plugins:

2. Fill the prompt with the license key. If you do not have the license key yet contact us.

Configuring build

Changes like changing toolbar items, changing order of icons or customizing plugin configurations should be relatively easy to make. Open the sample/index.html file and edit the script that initialized the CKEditor 5. Save the file and refresh the browser. That's all.

Note: If you have any problems with browser caching use the Ctrl + R or Cmd + R shortcut depending on your system.

However if you want to remove or add a plugin to the build you need to follow the next step of this guide.

Note that it is also possible to go back to the Online builder tool and pick other set of plugins. But we encourage you to try the harder way and to learn the principles of Node.js and CKEditor 5 ecosystems that will allow you to do more cool things in the future!

Updating/Adding CKEditor5 plugins

When updating version ckeditor 5 version and its plugins, or adding new plugins, we need to make sure that all ckeditor5 versions across the plugins (including any 3rd party plugins) have the same version numbers, otherwise we will run into ckeditor-duplicated-modules error, which is shown in the console log during ckeditor5 module init.

Specifically need to make sure that ckeditor dependencies are synced across plugins and we do not run into conflicts like these in yarn.lock (as in the case of @webspellchecker/wproofreader-ckeditor5 plugin for example):

ckeditor5@>=16.0.0:
  version "40.2.0"
  [...]

ckeditor5@^37.1.0:
  version "37.1.0"
  [...]

Installation

In order to rebuild the application you need to install all dependencies first. To do it, open the terminal in the project directory and type:

npm install

Make sure that you have the node and npm installed first. If not, then follow the instructions on the Node.js documentation page.

Adding or removing plugins

Now you can install additional plugin in the build. Just follow the Adding a plugin to an editor tutorial

Rebuilding editor

If you have already done the Installation and Adding or removing plugins steps, you're ready to rebuild the editor by running the following command:

npm run build

This will build the CKEditor 5 to the build directory. You can open your browser and you should be able to see the changes you've made in the code. If not, then try to refresh also the browser cache by typing Ctrl + R or Cmd + R depending on your system.

What's next?

Follow the guides available on https://ckeditor.com/docs/ckeditor5/latest/framework/index.html and enjoy the document editing.

FAQ

| Where is the place to report bugs and feature requests?

You can create an issue on https://github.com/ckeditor/ckeditor5/issues including the build id - 8w4b04m1drm-si0dzoe7vq0f. Make sure that the question / problem is unique, please look for a possibly asked questions in the search box. Duplicates will be closed.

| Where can I learn more about the CKEditor 5 framework?

Here: https://ckeditor.com/docs/ckeditor5/latest/framework/

| Is it possible to use online builder with common frameworks like React, Vue or Angular?

Not yet, but it these integrations will be available at some point in the future.