Преглед изворни кода

Merge branch 'master' into t/686

Kamil Piechaczek пре 8 година
родитељ
комит
3a7d07e11d

BIN
.github/ckeditor 5 classic screeshot.png


+ 223 - 158
README.md

@@ -1,4 +1,4 @@
-CKEditor 5 – development repository
+CKEditor 5 [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Check%20out%20CKEditor%205%20on%20GitHub%20&url=https://github.com/ckeditor/ckeditor5)
 ===================================
 
 [![Join the chat at https://gitter.im/ckeditor/ckeditor5](https://badges.gitter.im/ckeditor/ckeditor5.svg)](https://gitter.im/ckeditor/ckeditor5?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -6,31 +6,83 @@ CKEditor 5 – development repository
 [![Dependency Status](https://img.shields.io/david/ckeditor/ckeditor5.svg)](https://david-dm.org/ckeditor/ckeditor5)
 [![devDependency Status](https://img.shields.io/david/dev/ckeditor/ckeditor5.svg)](https://david-dm.org/ckeditor/ckeditor5?type=dev)
 
-## Project Status (November 2017)
+A set of ready to use rich text editors created with a powerful framework. Made with real-time collaborative editing in mind.
 
-1.0.0-alpha.2 was released on November 14, 2017. This is the 13th developer preview of the new CKEditor 5.
+![CKEditor 5 Classic editor build screenshot](https://github.com/ckeditor/ckeditor5/blob/master/.github/ckeditor%205%20classic%20screeshot.png)
 
-Read more about the status of the project in the [CKEditor 5 v1.0.0-alpha.2 release blog post](https://github.com/ckeditor/ckeditor5-design/issues/182).
+## Table of contents
 
-The first alpha versions will be followed by several releases before CKEditor 5 reaches v1.0.0. See the [roadmap to 1.0.0 and beyond](https://github.com/ckeditor/ckeditor5-design/issues/172).
+* [Quick start](#quick-start)
+   * [CKEditor 5 Builds](#ckeditor-5-builds)
+   * [CKEditor 5 Framework](#ckeditor-5-framework)
+* [Documentation and FAQ](#documentation-and-faq)
+* [Contributing and project organization](#contributing-and-project-organization)
+   * [Ideas and discussions](#ideas-and-discussions)
+   * [Development](#development)
+   * [Reporting issues and feature requests](#reporting-issues-and-feature-requests)
+* [Releases](#releases)
+* [Packages](#packages)
+   * [Core libraries](#core-libraries)
+   * [Editors](#editors)
+   * [Features](#features)
+   * [Themes](#themes)
+   * [Builds](#builds)
+* [License](#license)
 
-## Demos
+## Quick start
 
-To play with the editors see the [CKEditor 5 Builds](https://ckeditor.com/ckeditor-5-builds/) website.
+### CKEditor 5 Builds
 
-You can also find out more examples (such as [Markdown output](https://docs.ckeditor.com/ckeditor5/latest/features/markdown.html) or [text autoformatting](https://docs.ckeditor.com/ckeditor5/latest/features/autoformat.html)) in the [Features](https://docs.ckeditor.com/ckeditor5/latest/features/index.html) section of the documentation.
+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.
 
-### Follow us!
+The following CKEditor 5 Builds are currently available:
 
-* [Periodic news and updates](https://github.com/ckeditor/ckeditor5-design/labels/announcement) about the project.
-* [Roadmap to 1.0.0 and beyond](https://github.com/ckeditor/ckeditor5-design/issues/172).
+* [Classic editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Classic-editor)
+* [Inline editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Inline-editor)
+* [Balloon editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Balloon-editor)
 
-## Documentation
+#### Example
 
-For a high-level overview of the project see:
+Creating an editor using a CKEditor 5 build is very simple and can be described in two steps:
 
-* [CKEditor 5 Builds](https://ckeditor.com/ckeditor-5-builds/) website
-* [CKEditor 5 Framework](https://ckeditor.com/ckeditor-5-framework/) website.
+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:
+
+```html
+<textarea name="content" id="editor"></textarea>
+```
+
+Load the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+
+```html
+<script src="https://cdn.ckeditor.com/ckeditor5/<version>/classic/ckeditor.js"></script>
+```
+
+Call the [`ClassicEditor.create()`](https://docs.ckeditor.com/ckeditor5/latest/api/module_editor-classic_classiceditor-ClassicEditor.html#create) method:
+
+```html
+<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](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/quick-start.html).
+
+### 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](https://docs.ckeditor.com/ckeditor5/latest/framework/guides/overview.html).
+
+## Documentation and FAQ
 
 To find out more see the following [CKEditor 5 documentation](https://docs.ckeditor.com/ckeditor5/latest/index.html) sections:
 
@@ -42,13 +94,14 @@ To find out more see the following [CKEditor 5 documentation](https://docs.ckedi
 
 The documentation is far from being complete and will be constantly evolving (as will the editor) until it is ready for v1.0.0.
 
-## Project Organization
+For FAQ please go to the [CKEditor Ecosystem help center](https://support.ckeditor.com/hc/en-us).
+For a high-level overview of the project see the [CKEditor Ecosystem website](https://ckeditor.com).
 
-### Design and discussions
+## Contributing and project organization
 
-[https://github.com/ckeditor/ckeditor5](https://github.com/ckeditor/ckeditor5) is the CKEditor 5 main development repository. 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!
+### Ideas and discussions
 
-(Note: At the early stage, most of the high-level discussions were lead in [ckeditor5-design](https://github.com/ckeditor/ckeditor5-design/issues) repository.)
+The main development repository of CKEditor 5 is located at [https://github.com/ckeditor/ckeditor5](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
 
@@ -62,6 +115,18 @@ Each repository independently handles its issues. However, it's recommended to r
 
 Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/guides/support/getting-support.html) page.
 
+## Releases
+
+The latest five releases:
+
+* [Second alpha release of CKEditor 5 v1.0.0](https://ckeditor.com/blog/Second-alpha-release-of-CKEditor-5-v1.0.0/) (<time datetime="2017-11-14T12:52:18Z"><i>Nov 14, 2017</i></time>)
+* [First alpha release of CKEditor 5 v1.0.0](https://ckeditor.com/blog/First-alpha-release-of-CKEditor-5-v1.0.0/) (<time datetime="2017-10-03T13:09:29Z"><i>Oct 3, 2017</i></time>)
+* [11th developer preview of CKEditor 5](https://ckeditor.com/blog/11th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-09-03T19:35:48Z"><i>Sep 3, 2017</i></time>)
+* [10th developer preview of CKEditor 5 available](https://ckeditor.com/blog/10th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-05-07T21:57:04Z"><i>May 7, 2017</i></time>)
+* [9th developer preview of CKEditor 5 available](https://ckeditor.com/blog/9th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-04-05T17:58:27Z"><i>Apr 5, 2017</i></time>)
+
+For more CKEditor 5 release blog posts [browse the CKEditor blog](https://ckeditor.com/blog/?category=releases&tags=CKEditor-5).
+
 ## Packages
 
 ### Core libraries
@@ -69,8 +134,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -78,78 +144,84 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-engine"><code>@ckeditor/ckeditor5-engine</code></a>
-		<br>
-		The editing engine.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-engine"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-engine.svg" alt="ckeditor5-engine npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-engine"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-engine/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-engine/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-engine.svg" alt="ckeditor5-engine coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-engine"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-engine.svg" alt="@ckeditor/ckeditor5-engine npm package badge"></a>
+	</td>
+	<td>
+		The editing engine.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-core"><code>@ckeditor/ckeditor5-core</code></a>
-		<br>
-		The core editor architecture.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-core"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-core.svg" alt="ckeditor5-core npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-core"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-core/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-core/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-core.svg" alt="ckeditor5-core coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-core"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-core.svg" alt="@ckeditor/ckeditor5-core npm package badge"></a>
+	</td>
+	<td>
+		The core editor architecture.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-ui"><code>@ckeditor/ckeditor5-ui</code></a>
-		<br>
-		The editor UI library.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-ui"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-ui.svg" alt="ckeditor5-ui npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-ui"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-ui/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-ui/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-ui.svg" alt="ckeditor5-ui coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-ui"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-ui.svg" alt="@ckeditor/ckeditor5-ui npm package badge"></a>
+	</td>
+	<td>
+		The editor UI library.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-utils"><code>@ckeditor/ckeditor5-utils</code></a>
-		<br>
-		The editor utilities library.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-utils"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-utils.svg" alt="ckeditor5-utils npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-utils"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-utils/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-utils/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-utils.svg" alt="ckeditor5-utils coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-utils"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-utils.svg" alt="@ckeditor/ckeditor5-utils npm package badge"></a>
+	</td>
+	<td>
+		The editor utilities library.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-upload"><code>@ckeditor/ckeditor5-upload</code></a>
-		<br>
-		Introduces the file upload utilities.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-upload"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-upload.svg" alt="ckeditor5-upload npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-upload"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-upload/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-upload/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-upload.svg" alt="ckeditor5-upload coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-upload"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-upload.svg" alt="@ckeditor/ckeditor5-upload npm package badge"></a>
+	</td>
+	<td>
+		Introduces the file upload utilities.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-widget"><code>@ckeditor/ckeditor5-widget</code></a>
-		<br>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-widget"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-widget.svg" alt="@ckeditor/ckeditor5-widget npm package badge"></a>
+	</td>
+	<td>
 		Introduces the widget API.
 	</td>
+</tr>
+
+<tr>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-widget"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-widget.svg" alt="ckeditor5-widget npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-widget"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-widget/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-widget/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-widget.svg" alt="ckeditor5-widget coverage badge"></a>
+		<a href="https://github.com/ckeditor/ckeditor5-cloudservices"><code>@ckeditor/ckeditor5-cloudservices</code></a>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-cloudservices"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-cloudservices.svg" alt="@ckeditor/ckeditor5-cloudservices npm package badge"></a>
+	</td>
+	<td>
+		CKEditor 5's Cloud Services integration layer.
 	</td>
 </tr>
 
@@ -161,8 +233,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -170,39 +243,36 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-classic"><code>@ckeditor/ckeditor5-editor-classic</code></a>
-		<br>
-		The classic editor implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-classic.svg" alt="ckeditor5-editor-classic npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-classic/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-classic/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-classic.svg" alt="ckeditor5-editor-classic coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-classic.svg" alt="@ckeditor/ckeditor5-editor-classic npm package badge"></a>
+	</td>
+	<td>
+		The classic editor implementation.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-inline"><code>@ckeditor/ckeditor5-editor-inline</code></a>
-		<br>
-		The inline editor implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-inline.svg" alt="ckeditor5-editor-inline npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-inline/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-inline/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-inline.svg" alt="ckeditor5-editor-inline coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-inline.svg" alt="@ckeditor/ckeditor5-editor-inline npm package badge"></a>
+	</td>
+	<td>
+		The inline editor implementation.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-balloon"><code>@ckeditor/ckeditor5-editor-balloon</code></a>
-		<br>
-		The balloon editor (Medium-like) implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-balloon.svg" alt="ckeditor5-editor-balloon npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-balloon/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-balloon/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-balloon.svg" alt="ckeditor5-editor-balloon coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-balloon.svg" alt="@ckeditor/ckeditor5-editor-balloon npm package badge"></a>
+	</td>
+	<td>
+		The balloon editor (Medium-like) implementation.
 	</td>
 </tr>
 
@@ -214,8 +284,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -223,195 +294,180 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-adapter-ckfinder"><code>@ckeditor/ckeditor5-adapter-ckfinder</code></a>
-		<br>
-		Introduces the <a href="https://ckeditor.com/ckeditor-4/ckfinder/">CKFinder</a> adapter for features which require upload capabilities.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-adapter-ckfinder.svg" alt="ckeditor5-adapter-ckfinder npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-adapter-ckfinder/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-adapter-ckfinder/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-adapter-ckfinder.svg" alt="ckeditor5-adapter-ckfinder coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-adapter-ckfinder.svg" alt="@ckeditor/ckeditor5-adapter-ckfinder npm package badge"></a>
+	</td>
+	<td>
+		Introduces the <a href="https://ckeditor.com/ckeditor-4/ckfinder/">CKFinder</a> adapter for features which require upload capabilities.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-autoformat"><code>@ckeditor/ckeditor5-autoformat</code></a>
-		<br>
-		Introduces the autoformatting feature. Replaces predefined characters with a corresponding format (e.g. <code>**foo**</code> becomes bolded <code>&lt;strong&gt;foo&lt;/strong&gt;</code>).
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-autoformat.svg" alt="ckeditor5-autoformat npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-autoformat/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-autoformat/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-autoformat.svg" alt="ckeditor5-autoformat coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-autoformat.svg" alt="@ckeditor/ckeditor5-autoformat npm package badge"></a>
+	</td>
+	<td>
+		Introduces the autoformatting feature. Replaces predefined characters with a corresponding format (e.g. <code>**foo**</code> becomes bolded <code>&lt;strong&gt;foo&lt;/strong&gt;</code>).
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-basic-styles"><code>@ckeditor/ckeditor5-basic-styles</code></a>
-		<br>
-		Introduces the bold, italic, underline and code features.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-basic-styles.svg" alt="ckeditor5-basic-styles npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-basic-styles/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-basic-styles/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-basic-styles.svg" alt="ckeditor5-basic-styles coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-basic-styles.svg" alt="@ckeditor/ckeditor5-basic-styles npm package badge"></a>
+	</td>
+	<td>
+		Introduces the bold, italic, underline and code features.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-block-quote"><code>@ckeditor/ckeditor5-block-quote</code></a>
-		<br>
-		Introduces the block quote feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-block-quote.svg" alt="ckeditor5-block-quote npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-block-quote/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-block-quote/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-block-quote.svg" alt="ckeditor5-block-quote coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-block-quote.svg" alt="@ckeditor/ckeditor5-block-quote npm package badge"></a>
+	</td>
+	<td>
+		Introduces the block quote feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-clipboard"><code>@ckeditor/ckeditor5-clipboard</code></a>
-		<br>
-		Introduces the clipboard integration.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-clipboard.svg" alt="ckeditor5-clipboard npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-clipboard/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-clipboard/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-clipboard.svg" alt="ckeditor5-clipboard coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-clipboard.svg" alt="@ckeditor/ckeditor5-clipboard npm package badge"></a>
+	</td>
+	<td>
+		Introduces the clipboard integration.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-enter"><code>@ckeditor/ckeditor5-enter</code></a>
-		<br>
-		Introduces the Enter key feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-enter"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-enter.svg" alt="ckeditor5-enter npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-enter"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-enter/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-enter/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-enter.svg" alt="ckeditor5-enter coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-enter"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-enter.svg" alt="@ckeditor/ckeditor5-enter npm package badge"></a>
+	</td>
+	<td>
+		Introduces the Enter key feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-easy-image"><code>@ckeditor/ckeditor5-easy-image</code></a>
-		<br>
-		Introduces Easy Image with Cloud Services feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-easy-image.svg" alt="ckeditor5-easy-image npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-easy-image/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-easy-image/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-easy-image.svg" alt="ckeditor5-easy-image coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-easy-image.svg" alt="@ckeditor/ckeditor5-easy-image npm package badge"></a>
+	</td>
+	<td>
+		Introduces Easy Image with Cloud Services feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-heading"><code>@ckeditor/ckeditor5-heading</code></a>
-		<br>
-		Introduces the heading feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-heading"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-heading.svg" alt="ckeditor5-heading npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-heading"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-heading/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-heading/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-heading.svg" alt="ckeditor5-heading coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-heading"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-heading.svg" alt="@ckeditor/ckeditor5-heading npm package badge"></a>
+	</td>
+	<td>
+		Introduces the heading feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-image"><code>@ckeditor/ckeditor5-image</code></a>
-		<br>
-		Introduces the image feature. Supports image styles and captioning.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-image.svg" alt="ckeditor5-image npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-image"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-image/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-image/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-image.svg" alt="ckeditor5-image coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-image.svg" alt="@ckeditor/ckeditor5-image npm package badge"></a>
+	</td>
+	<td>
+		Introduces the image feature. Supports image styles and captioning.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-link"><code>@ckeditor/ckeditor5-link</code></a>
-		<br>
-		Introduces the link feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-link"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-link.svg" alt="ckeditor5-link npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-link"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-link/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-link/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-link.svg" alt="ckeditor5-link coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-link"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-link.svg" alt="@ckeditor/ckeditor5-link npm package badge"></a>
+	</td>
+	<td>
+		Introduces the link feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-list"><code>@ckeditor/ckeditor5-list</code></a>
-		<br>
-		Introduces numbered and bulleted lists feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-list"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-list.svg" alt="ckeditor5-list npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-list"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-list/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-list/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-list.svg" alt="ckeditor5-list coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-list"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-list.svg" alt="@ckeditor/ckeditor5-list npm package badge"></a>
+	</td>
+	<td>
+		Introduces numbered and bulleted lists feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-markdown-gfm"><code>@ckeditor/ckeditor5-markdown-gfm</code></a>
-		<br>
-		Introduces GitHub-flavored Markdown data processor.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-markdown-gfm.svg" alt="ckeditor5-markdown-gfm npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-markdown-gfm/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-markdown-gfm/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-markdown-gfm.svg" alt="ckeditor5-markdown-gfm coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-markdown-gfm.svg" alt="@ckeditor/ckeditor5-markdown-gfm npm package badge"></a>
+	</td>
+	<td>
+		Introduces GitHub-flavored Markdown data processor.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-paragraph"><code>@ckeditor/ckeditor5-paragraph</code></a>
-		<br>
-		Introduces the paragraph feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-paragraph.svg" alt="ckeditor5-paragraph npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-paragraph/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-paragraph/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-paragraph.svg" alt="ckeditor5-paragraph coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-paragraph.svg" alt="@ckeditor/ckeditor5-paragraph npm package badge"></a>
+	</td>
+	<td>
+		Introduces the paragraph feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-typing"><code>@ckeditor/ckeditor5-typing</code></a>
-		<br>
-		Introduces typing and deleting features.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-typing"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-typing.svg" alt="ckeditor5-typing npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-typing"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-typing/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-typing/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-typing.svg" alt="ckeditor5-typing coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-typing"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-typing.svg" alt="@ckeditor/ckeditor5-typing npm package badge"></a>
+	</td>
+	<td>
+		Introduces typing and deleting features.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-undo"><code>@ckeditor/ckeditor5-undo</code></a>
-		<br>
-		Introduces the undo feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-undo"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-undo.svg" alt="ckeditor5-undo npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-undo"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-undo/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-undo/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-undo.svg" alt="ckeditor5-undo coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-undo"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-undo.svg" alt="@ckeditor/ckeditor5-undo npm package badge"></a>
+	</td>
+	<td>
+		Introduces the undo feature.
 	</td>
 </tr>
 
@@ -423,8 +479,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -432,7 +489,11 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-theme-lark"><code>@ckeditor/ckeditor5-theme-lark</code></a>
-		<br>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-theme-lark"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-theme-lark.svg" alt="@ckeditor/ckeditor5-theme-lark npm package badge"></a>
+	</td>
+	<td>
 		The Lark theme.
 	</td>
 	<td>
@@ -449,8 +510,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -458,33 +520,36 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-classic"><code>@ckeditor/ckeditor5-build-classic</code></a>
-		<br>
-		The classic editor build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-classic.svg" alt="ckeditor5-build-classic npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-classic.svg" alt="@ckeditor/ckeditor5-build-classic npm package badge"></a>
+	</td>
+	<td>
+		The classic editor build.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-inline"><code>@ckeditor/ckeditor5-build-inline</code></a>
-		<br>
-		The inline editor build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-inline.svg" alt="ckeditor5-build-inline npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-inline.svg" alt="@ckeditor/ckeditor5-build-inline npm package badge"></a>
+	</td>
+	<td>
+		The inline editor build.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-balloon"><code>@ckeditor/ckeditor5-build-balloon</code></a>
-		<br>
-		The balloon editor (Medium-like) build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-balloon.svg" alt="ckeditor5-build-balloon npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-balloon.svg" alt="@ckeditor/ckeditor5-build-balloon npm package badge"></a>
+	</td>
+	<td>
+		The balloon editor (Medium-like) build.
 	</td>
 </tr>
 

+ 10 - 6
docs/builds/guides/development/custom-builds.md

@@ -26,7 +26,7 @@ Some of the reasons for creating custom builds are:
 Start with [forking](https://help.github.com/articles/fork-a-repo/) one of the official builds (it will serve as the starting point for your custom one) and then clone your fork:
 
 ```bash
-git clone https://github.com/<your-username>/ckeditor5-build-classic.git
+git clone -b stable https://github.com/<your-username>/ckeditor5-build-classic.git
 ```
 
 To make updating easier you may optionally add the original build repository to your Git remotes:
@@ -41,6 +41,10 @@ git remote add upstream https://github.com/ckeditor/ckeditor5-build-classic.git
 	Alternatively, instead of creating a custom build you can {@link builds/guides/integration/advanced-setup#Scenario-2-Building-from-source integrate CKEditor 5 directly from source}. This option allows even greater flexibility and requires less overhead (you will not need to fork the official build).
 </info-box>
 
+<info-box warning>
+	It is important that you use the `stable` branch of a build, not the `master` branch. The `master` branch might contain changes which are not yet compatible with the versions of CKEditor 5 source packages which were published on npm.
+</info-box>
+
 ## Build anatomy
 
 Every build contains the following files:
@@ -106,12 +110,12 @@ module.exports = {
 		'../relative/path/to/some/othercustomplugin'
 	],
 
-	// UI language. Language codes follow the https://en.wikipedia.org/wiki/ISO_639-1 format.
-	language: 'en',
-
 	// Editor configuration.
 	config: {
-		toolbar: [ 'headings', 'bold', 'italic', 'custombutton' ]
+		toolbar: [ 'headings', 'bold', 'italic', 'custombutton' ],
+
+		// UI language. Language codes follow the https://en.wikipedia.org/wiki/ISO_639-1 format.
+		language: 'en'
 	}
 };
 ```
@@ -142,7 +146,7 @@ You may decide to update your build at any time. Since it is a fork of the offic
 
 ```bash
 git fetch upstream
-git merge upstream/master
+git merge upstream/stable
 ```
 
 You should handle eventual conflicts and verify the merged changes. After that, just follow the previous instructions for creating your build and test it.

+ 2 - 6
docs/builds/guides/integration/advanced-setup.md

@@ -11,7 +11,7 @@ In this guide, we would like to show you ways to closer integrate CKEditor with
 
 ## Bundler
 
-CKEditor 5 is currently built using [webpack](https://webpack.js.org) (>=2.x.x). All builds, examples and demos are generated using this bundler. It should also be possible to build CKEditor using other bundlers (if they are configured properly), such as [Rollup](https://github.com/rollup/rollup) or [Browserify](http://browserify.org/) but these setups are not officially supported yet. Also, the [`@ckeditor/ckeditor5-dev-webpack-plugin`](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-webpack-plugin) that allows to localize the editor is only available for webpack. More work on this subject will be done after v1.0.0.
+CKEditor 5 is currently built using [webpack](https://webpack.js.org) (>=3.x.x). All builds, examples and demos are generated using this bundler. It should also be possible to build CKEditor using other bundlers (if they are configured properly), such as [Rollup](https://github.com/rollup/rollup) or [Browserify](http://browserify.org/) but these setups are not officially supported yet. Also, the [`@ckeditor/ckeditor5-dev-webpack-plugin`](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-webpack-plugin) that allows to localize the editor is only available for webpack. More work on this subject will be done after v1.0.0.
 
 Therefore, **a prerequisite to this guide is that you are using webpack as your build tool**.
 
@@ -19,10 +19,6 @@ Therefore, **a prerequisite to this guide is that you are using webpack as your
 
 This is the simplest scenario. It assumes that you want to use {@link builds/guides/overview#Available-builds one of the existing builds} "as-is" (you can, of course, still {@link builds/guides/integration/configuration configure the editor}). It also gives the fastest build times.
 
-<info-box>
-	At the current stage, builds are only available in English. {@link features/ui-language Setting editor UI language} requires rebuilding the editor which means that this scenario is quite limited.
-</info-box>
-
 First, install the build of your choice {@link builds/guides/integration/installation#npm from npm}:
 
 ```bash
@@ -119,7 +115,7 @@ module.exports = {
 
 		new CKEditorWebpackPlugin( {
 			// See https://ckeditor5.github.io/docs/nightly/ckeditor5/latest/features/ui-language.html
-			languages: [ 'pl' ]
+			language: 'pl'
 		} )
 	],
 

Разлика између датотеке није приказан због своје велике величине
+ 100 - 1
docs/builds/guides/migrate.md


+ 3 - 3
docs/builds/guides/quick-start.md

@@ -25,7 +25,7 @@ In your HTML page add an element that CKEditor should replace:
 <textarea name="content" id="editor"></textarea>
 ```
 
-Load CKEditor 5, the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/classic/ckeditor.js"></script>
@@ -77,7 +77,7 @@ In your HTML page add an element that CKEditor should make editable:
 <div id="editor"></div>
 ```
 
-Load CKEditor 5, the inline editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the inline editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/inline/ckeditor.js"></script>
@@ -129,7 +129,7 @@ In your HTML page add an element that CKEditor should make editable:
 <div id="editor"></div>
 ```
 
-Load CKEditor 5, the balloon editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the balloon editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/balloon/ckeditor.js"></script>

+ 6 - 0
docs/builds/guides/support/getting-support.md

@@ -41,3 +41,9 @@ DON'Ts:
 * The editor crashes if I press Enter. Please help.
 
 And most importantly, be kind to everyone.
+
+## Commercial support
+
+CKEditor 5 also comes with commercial licensing benefits, such as direct support from the core CKEditor development team. Commercial licenses are designed with professionals and enterprises in mind.
+
+For more information, check the [CKEditor 5 Pricing page](https://ckeditor.com/ckeditor-5-builds/pricing/).

+ 87 - 6
docs/features/ui-language.md

@@ -13,9 +13,60 @@ See the demo of the editor in German:
 
 {@snippet features/ui-language}
 
+## Loading additional languages from CDN, npm and zip file
+
+You can load additional languages using:
+* [CDN](#CDN),
+* [npm](#npm),
+* [Zip download](#Zip).
+
+Next, configure the editor to use chosen language:
+
+```js
+ClassicEditor
+	.create( document.querySelector( '#editor' ), {
+		language: 'de'
+	} )
+	.then( editor => {
+		console.log( editor );
+	} )
+	.catch( error => {
+		console.error( error );
+	} );
+```
+
+### CDN
+
+To use different language than default one (English), you need to load the editor together with the preferred language:
+
+```html
+<script src="https://cdn.ckeditor.com/ckeditor5/[version.number]/[distribution]/ckeditor.js"></script>
+<script src="https://cdn.ckeditor.com/ckeditor5/[version.number]/[distribution]/lang/de.js"></script>
+```
+
+See {@link builds/guides/integration/installation#CDN CDN installation guides} for more information.
+
+### npm
+
+After installing the build from npm, languages will be available at `node_modules/@ckeditor/ckeditor5-build-[name]/build/lang/[lang].js`.
+Single language can be loaded directly to your code by importing `'@ckeditor/ckeditor5-build-[name]/build/lang/de.js'`.
+
+See {@link builds/guides/integration/installation#npm npm installation guides} for more information.
+
+### Zip
+
+All additional languages are included in `.zip` file. You need to include `ckeditor.js` file together with language file:
+
+```js
+<script src="[ckeditor-path]/ckeditor.js"></script>
+<script src="[ckeditor-path]/lang/de.js"></script>
+```
+
+See {@link builds/guides/integration/installation#Zip-download zip installation guides} for more information.
+
 ## Building the editor using a specific language
 
-Currently, it is only possible to change the UI language at the build stage. A single build of the editor supports only the language which was defined in the [CKEditor 5 webpack plugin](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-webpack-plugin)'s configuration.
+Currently, it is possible to change the UI language at the build stage and after the build. A single build of the editor supports the language which was defined in the [CKEditor 5 webpack plugin](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-webpack-plugin)'s configuration. See the whole translation process to see how you can change the language later.
 
 If you use one of the {@link builds/index predefined editor builds}, refer to {@link builds/guides/development/custom-builds Creating custom builds} to learn how to change the language of your build.
 
@@ -37,8 +88,19 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 	// Define webpack plugins ...
 		plugins: [
 			new CKEditorWebpackPlugin( {
-				// Note: The plugin is currently able to build just one language at a time.
-				languages: [ 'pl' ]
+				// Main language that will be built in to the main bundle.
+				language: 'en',
+
+				// Additional languages that will be emitted to the `outputDirectory`.
+				// This option can be set to array of language codes or `'all'` to build all found languages.
+				// The bundle is optimized for one language when this option is omitted.
+				additionalLanguages: 'all',
+
+				// outputDirectory - optional directory for emitted translations, `'lang'` by default, relative to the webpack's output.
+
+				// strict - will cause the building process to fail if an error is found during the building process.
+
+				// verbose - will cause logging all warnings into the console
 			} ),
 
 			// Other webpack plugins...
@@ -46,10 +108,29 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 	// ...
 	```
 
-3. Run webpack. The CKEditor plugin for webpack will replace the {@link module:utils/locale~Locale#t `t()`} function calls used in the source code with localized language strings.
+3. Run webpack. If the `additionalLanguages` option is not set, the CKEditor plugin for webpack will replace the {@link module:utils/locale~Locale#t `t()`} function call parameters used in the source code with localized language strings. Otherwise the CKEditor plugin for webpack will replace the {@link module:utils/locale~Locale#t `t()`} function call parameters with short ids and emit the translation files that should land in the `'lang'` directory (or different, if the `outputDirectory` option is specified).
+
+4. If you want to change the language after the build ends, you will need to edit the `index.html` file, add the translation file and set the UI language to the target one.
+
+	```html
+	<script src="../build/ckeditor.js"></script>
+	<script src="../build/lang/pl.js"></script>
+	<script>
+		ClassicEditor
+			.create( document.querySelector( '#editor' ), {
+				language: 'pl'
+			} )
+			.then( editor => {
+				window.editor = editor;
+			} )
+			.catch( err => {
+				console.error( err.stack );
+			} );
+	</script>
+	```
 
 <info-box>
-	We are aware that the current localization method is not sufficient for all needs. It neither supports different bundlers (e.g. Rollup or Browserify) nor building multiple languages (to make it possible to pick one at runtime). We will be extending the localization possiblities in the near future.
+	We are aware that the current localization method is not sufficient for all needs. It doesn't support different bundlers (e.g. Rollup or Browserify). We will be extending the localization possibilities in the future.
 
-	You can read more about the used techniques and future plans in the ["Implement translation services" issue](https://github.com/ckeditor/ckeditor5/issues/387).
+	You can read more about the used techniques in the ["Implement translation services" issue](https://github.com/ckeditor/ckeditor5/issues/387) and ["Implement translation services v2" issue](https://github.com/ckeditor/ckeditor5/issues/624).
 </info-box>

+ 6 - 0
docs/framework/guides/support/getting-support.md

@@ -41,3 +41,9 @@ DON'Ts:
 * The editor crashes if I press Enter. Please help.
 
 And most importantly, be kind to everyone.
+
+## Commercial support
+
+CKEditor 5 also comes with commercial licensing benefits, such as direct support from the core CKEditor development team. Commercial licenses are designed with professionals and enterprises in mind.
+
+For more information, check the [CKEditor 5 Pricing page](https://ckeditor.com/ckeditor-5-builds/pricing/).

+ 2 - 2
package.json

@@ -46,9 +46,9 @@
   },
   "devDependencies": {
     "@ckeditor/ckeditor5-dev-docs": "^8.0.0",
-    "@ckeditor/ckeditor5-dev-tests": "^9.0.0",
+    "@ckeditor/ckeditor5-dev-tests": "^10.0.0",
     "eslint": "^4.8.0",
-    "eslint-config-ckeditor5": "^1.0.6",
+    "eslint-config-ckeditor5": "^1.0.7",
     "husky": "^0.14.3",
     "lint-staged": "^4.2.3",
     "lerna": "^2.2.0",

+ 6 - 0
scripts/README.md

@@ -0,0 +1,6 @@
+Looking for CKEditor 5's source?
+================================
+
+This repository (https://github.com/ckeditor/ckeditor5) is the CKEditor 5's development environment. It centralizes various tools such as test runners, documentation and changelog generators, release scripts, etc.
+
+The source code of the editor is split into multiple repositories, one for each of CKEditor 5 packages. Every package is developed at its own pace and in its own context. Check out the list of [CKEditor 5 packages and repositories](https://github.com/ckeditor/ckeditor5#packages).

+ 2 - 4
scripts/docs/snippet-adapter/package.json

@@ -2,13 +2,11 @@
   "name": "ckeditor5-snippet-adapter",
   "private": true,
   "dependencies": {
-    "@ckeditor/ckeditor5-dev-webpack-plugin": "^2.0.18",
+    "@ckeditor/ckeditor5-dev-webpack-plugin": "^3.0.0",
     "babel-minify-webpack-plugin": "^0.2.0",
-    "css-loader": "^0.28.7",
     "extract-text-webpack-plugin": "^3.0.0",
-    "node-sass": "^4.5.3",
     "raw-loader": "^0.5.1",
-    "sass-loader": "^6.0.6",
+    "postcss-loader": "^2.0.8",
     "style-loader": "^0.18.2",
     "webpack": "^3.6.0",
     "webpack-sources": "1.0.1"

+ 11 - 20
scripts/docs/snippet-adapter/snippetadapter.js

@@ -8,7 +8,7 @@
 const path = require( 'path' );
 const fs = require( 'fs' );
 const webpack = require( 'webpack' );
-const { bundler } = require( '@ckeditor/ckeditor5-dev-utils' );
+const { bundler, styles: { getPostCssConfig } } = require( '@ckeditor/ckeditor5-dev-utils' );
 const CKEditorWebpackPlugin = require( '@ckeditor/ckeditor5-dev-webpack-plugin' );
 const ExtractTextPlugin = require( 'extract-text-webpack-plugin' );
 const BabelMinifyPlugin = require( 'babel-minify-webpack-plugin' );
@@ -22,18 +22,12 @@ module.exports = function snippetAdapter( data ) {
 
 	const snippetConfig = readSnippetConfig( data.snippetSource.js );
 	const outputPath = path.join( data.outputPath, data.snippetPath );
-	let sassImportPath;
-
-	if ( snippetConfig.sassImportPath ) {
-		sassImportPath = path.join( path.dirname( data.snippetSource.js ), snippetConfig.sassImportPath );
-	}
 
 	const webpackConfig = getWebpackConfig( {
 		entry: data.snippetSource.js,
 		outputPath,
 		language: snippetConfig.language,
-		minify: data.options.production,
-		sassImportPath
+		minify: data.options.production
 	} );
 
 	let promise;
@@ -88,7 +82,7 @@ function getWebpackConfig( config ) {
 	const plugins = [
 		new ExtractTextPlugin( 'snippet.css' ),
 		new CKEditorWebpackPlugin( {
-			languages: [ config.language || 'en' ]
+			language: config.language || 'en'
 		} ),
 		new webpack.BannerPlugin( {
 			banner: bundler.getLicenseBanner(),
@@ -133,21 +127,18 @@ function getWebpackConfig( config ) {
 					use: [ 'raw-loader' ]
 				},
 				{
-					test: /\.scss$/,
+					test: /\.css$/,
 					use: ExtractTextPlugin.extract( {
 						fallback: 'style-loader',
 						use: [
 							{
-								loader: 'css-loader',
-								options: {
-									minimize: config.minify
-								}
-							},
-							{
-								loader: 'sass-loader',
-								options: {
-									data: config.sassImportPath ? `@import '${ config.sassImportPath }';` : ''
-								}
+								loader: 'postcss-loader',
+								options: getPostCssConfig( {
+									themeImporter: {
+										themePath: require.resolve( '@ckeditor/ckeditor5-theme-lark' )
+									},
+									minify: config.minify
+								} )
 							}
 						]
 					} )

Неке датотеке нису приказане због велике количине промена