Awesome
CKEditor 5 rich text editor component for Angular
Official CKEditor 5 rich text editor component for Angular 13+.
Developer Documentation 📖
See the "Rich text editor component for Angular" guide in the CKEditor 5 documentation to learn more:
- Quick start
- Integration with
ngModel
- Supported
@Input
properties - Supported
@Output
properties - Styling
- Localization
Supported Angular versions
Because of the breaking changes in the Angular library output format, the @ckeditor/ckeditor5-angular
package is released in the following versions to support various Angular ecosystems:
Note that the package.json
file used in the main repository isn't published on npm (the production one is present in src/ckeditor/package.json
).
Contributing
After cloning this repository, install necessary dependencies:
npm install
The structure of the repository
This repository contains the following code:
./src/ckeditor
contains the implementation of the<ckeditor>
component,./src/app
is a demo application using the component.
Note: The npm package contains a packaged component only.
Testing the component (demo)
To open the demo application using the component, run:
npm run start
To test it in production, use:
npm run start -- --configuration production
To run unit tests, use:
npm run test
To run e2e tests, run:
# Prepare the server.
npm run start
# Then, start tests.
npm run test:e2e
To run coverage tests, run:
npm run coverage
Play with the application and make sure the component works properly.
Releasing package
CircleCI automates the release process and can release both channels: stable (X.Y.Z
) and pre-releases (X.Y.Z-alpha.X
, etc.).
Before you start, you need to prepare the changelog entries.
- Make sure the
#master
branch is up-to-date:git fetch && git checkout master && git pull
. - Prepare a release branch:
git checkout -b release-[YYYYMMDD]
whereYYYYMMDD
is the current day. - Generate the changelog entries:
yarn run changelog --branch release-[YYYYMMDD] [--from [GIT_TAG]]
.-
By default, the changelog generator uses the latest published tag as a starting point for collecting commits to process.
The
--from
modifier option allows overriding the default behavior. It is required when preparing the changelog entries for the next stable release while the previous one was marked as a prerelease, e.g.,@alpha
.Example: Let's assume that the
v40.5.0-alpha.0
tag is our latest and that we want to release it on a stable channel. The--from
modifier should be equal to--from v40.4.0
. -
This task checks what changed in each package and bumps the version accordingly. It won't create a new changelog entry if nothing changes at all. If changes were irrelevant (e.g., only dependencies), it would make an "internal changes" entry.
-
Scan the logs printed by the tool to search for errors (incorrect changelog entries). Incorrect entries (e.g., ones without the type) should be addressed. You may need to create entries for them manually. This is done directly in CHANGELOG.md (in the root directory). Make sure to verify the proposed version after you modify the changelog.
-
- Commit all changes and prepare a new pull request targeting the
#master
branch. - Ping the
@ckeditor/ckeditor-5-devops
team to review the pull request and trigger the release process.
License
Licensed under the terms of GNU General Public License Version 2 or later. For full details about the license, please check the LICENSE.md file.