CKEditor 4 Official Documentation

This is the official developer documentation project for CKEditor. It uses the customized CKEditor JSDuck clone for compilation and is available online at http://docs.ckeditor.com.

All issues regarding CKEditor 4 Documentation should be reported in the ckeditor4 repository.

Building the Documentation

Follow the steps listed below to build CKEditor documentation locally.

Requirements

• Ruby
• Custom CKEditor JSDuck clone (installation instructions are provided below).
• NPM.

Building Instructions

Clone this repository locally:

> git clone git@github.com:ckeditor/ckeditor4-docs.git

Go to the ckeditor4-docs directory and update the submodules:

> cd ckeditor4-docs
> git submodule update --init --recursive

Clone the custom CKEditor JSDuck repository to a separate folder next to ckeditor4-docs:

> cd ..
> git clone git@github.com:ckeditor/jsduck.git

Checkout the stable branch of the jsduck repository and install the latest ckeditor-jsduck-<version>.gem:

> cd jsduck
> git checkout stable
> gem install ckeditor-jsduck-<version>.gem

Go back to the ckeditor4-docs repository and install npm dependencies:

> npm install

Then finally execute grunt build-serve:

> grunt build-serve [--options]

Available options:

• --dev - use it to build documentation and view it locally,
• --skipApi - skips rendering API docs,
• --skipValidation - skips link validation,
• --clean - when --dev flag is used, --clean enables to clear the build directory before outputting new documentation

Use grunt docs to build documentation without setting a server.

API Documentation

The repos/ folder contains submodules for the repositories currently included in the API documentation. As expected, the API is documented inline in the source code contained in these repositories, and is then integrated into the documentation files.

Using Local Versions of ckeditor4

While the main CKEditor repository for API documents, ckeditor4, is available as a submodule, it is also possible to make the builder use its local copy to avoid submodule limitations and speed up API documentation work. There are two ways to achieve it:

• Keeping ckeditor4-docs/ and ckeditor4/ folders in the same directory.

• Setting the CKEDITOR_DEV_PATH environment variable to point to your ckeditor4/ folder path.

License

See the LICENSE.md file for licensing details.