This repository contains the development version of CKEditor 4.
Attention: The code in this repository should be used locally and for development purposes only. We do not recommend using it in production environment because the user experience will be very limited. For that purpose, you should either build the editor (see below) or use an official release available on the CKEditor website.
There is no special installation procedure to install the development code. Simply clone it to any local directory and you are set.
This repository contains the following branches:
- master – Development of the upcoming minor release.
- major – Development of the upcoming major release.
- stable – Latest stable release tag point (non-beta).
- latest – Latest release tag point (including betas).
- release/A.B.x (e.g. 4.0.x, 4.1.x) – Release freeze, tests and tagging. Hotfixing.
Note that both master and major are under heavy development. Their code did not pass the release testing phase, though, so it may be unstable.
Additionally, all releases have their respective tags in the following form: 4.4.0, 4.4.1, etc.
The samples/ folder contains some examples that can be used to test your
installation. Visit CKEditor 4 Examples for plenty of samples
showcasing numerous editor features, with source code readily available to view, copy
and use in your own solution.
The development code contains the following main elements:
- Main coding folders:
core/– The core API of CKEditor 4. Alone, it does nothing, but it provides the entire JavaScript API that makes the magic happen.plugins/– Contains most of the plugins maintained by the CKEditor 4 core team.skin/– Contains the official default skin of CKEditor 4.dev/– Contains some developer tools.tests/– Contains the CKEditor 4 tests suite.
While building this release on local, please make sure that your Nodejs version is not greater than 12. Otherwise, the generated release will have the ES6 code, and ES6 code breaks loading of some plugins like codesnippet.
A release-optimized version of the development code can be easily created
locally. The dev/builder/build.sh script can be used for that purpose:
> ./dev/builder/build.sh
A "release ready" working copy of your development code will be built in the new
dev/builder/release/ folder. An Internet connection is necessary to run the
builder, for its first time at least.
Here are steps on how to locally test your code changes in this repo.
Note :- Here, the example steps are added in context to its integration with Candidate Site. This example can be extended to other repositories as well.
- Clone this repo
cdinto the directory and enter the build command (./dev/builder/build.sh) in the root of the folder, a new release will be created inckeditor-dev/dev/builder/release/and the name of the new release folder name isckeditor- Make sure you are in the root of this directory and enter the command to serve the newly released folder through your localhost
python3 -m http.server <port> -d ./dev/builder/release/ - Replace
<port>with the port you want to serve in localhost. e.g.3333 - Replace
CKEDITOR_CDN_URLfrom hackerrank cdn to your localhost url. Example:export const CKEDITOR_CDN_URL = 'http://localhost:<port>/ckeditor/ckeditor.js';which will be present in a file similar to this in your respective repositories. - Make sure your devspace is running and, open a page in your private node where you get to see the editor(served from your localhost) in action.
Note :- After making any code changes, you need to follow the above steps, starting from step-2 and for each change you made, follow one iteration of the above steps.
Read more on how to set up the environment and execute tests in the CKEditor 4 Testing Environment guide.
Please use the CKEditor 4 GitHub issue page to report bugs and feature requests.
Copyright (c) 2003-2019, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license