Ver Fonte

Docs: UI language guide corrected. [skip ci]

Anna Tomanek há 6 anos atrás
pai
commit
a42da5ced7
1 ficheiros alterados com 26 adições e 24 exclusões
  1. 26 24
      docs/features/ui-language.md

+ 26 - 24
docs/features/ui-language.md

@@ -6,9 +6,11 @@ category: features
 
 # Setting the UI language
 
-The UI of the editor can be localized. CKEditor 5 currently supports around 20 languages and the number is growing.
+The UI of the editor can be localized. CKEditor 5 currently supports around 50 languages and the number is growing.
 
-If you want to help translate CKEditor 5 into your native language, join the [CKEditor 5 project on Transifex](https://www.transifex.com/ckeditor/ckeditor5/). Your help will be much appreciated!
+<info-box>
+	If you want to help translate CKEditor 5 into your native language, join the [CKEditor 5 project on Transifex](https://www.transifex.com/ckeditor/ckeditor5/). Your help will be much appreciated!
+</info-box>
 
 See the demo of the editor in Spanish:
 
@@ -16,17 +18,17 @@ See the demo of the editor in Spanish:
 
 ## Right–to–left (RTL) languages support
 
-CKEditor 5 supports right–to–left languages out–of–the–box. When one of <abbr title="right–to–left">RTL</abbr> languages is used, the editor adapts its UI for the best editing experience, for instance, mirroring various elements like toolbars, dropdowns, buttons, etc..
+CKEditor 5 supports right–to–left languages out–of–the–box. When one of <abbr title="right–to–left">RTL</abbr> languages is used, the WYSIWYG editor adapts its UI for the best editing experience, for instance, mirroring various elements like toolbars, dropdowns, buttons, etc.
 
 See the demo of the editor in Arabic:
 
 {@snippet features/ui-language-rtl}
 
 <info-box>
-	If you want to change the language of the content only (different languages for the UI and the content), check out the ["Setting the language of the content"](#setting-the-language-of-the-content) section to learn more.
+	If you want to change the language of the content only (different languages for the UI and the content), check out the [Setting the language of the content](#setting-the-language-of-the-content) section to learn more.
 </info-box>
 
-We are doing our best to deliver the best RTL support to our users and we constantly improve the editor. Check out the ["RTL support"](https://github.com/ckeditor/ckeditor5/issues/1151) issue on GitHub to learn more and stay up–to–date. Thank you for the feedback!
+We are doing our best to deliver the best RTL support to our users and we constantly improve the editor. Check out the [RTL support](https://github.com/ckeditor/ckeditor5/issues/1151) issue on GitHub to learn more and stay up–to–date. Your feedback is much appreciated!
 
 ## Loading additional languages from CDN, npm and zip file
 
@@ -54,7 +56,7 @@ ClassicEditor
 
 ### CDN
 
-To use different language than default one (English), you need to load the editor together with the preferred language:
+To use a different language than the 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>
@@ -68,34 +70,34 @@ For example:
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/classic/translations/de.js"></script>
 ```
 
-See {@link builds/guides/integration/installation#cdn CDN installation guides} for more information.
+See the {@link builds/guides/integration/installation#cdn CDN installation guide} for more information.
 
 ### npm
 
-After installing the build from npm, languages will be available at `node_modules/@ckeditor/ckeditor5-build-[name]/build/translations/[lang].js`.
+After installing the build from npm, languages will be available in `node_modules/@ckeditor/ckeditor5-build-[name]/build/translations/[lang].js`.
 
-Single language can be loaded directly to your code by importing e.g. `'@ckeditor/ckeditor5-build-classic/build/translations/de.js'`.
+A single language can be loaded directly to your code by importing e.g. `'@ckeditor/ckeditor5-build-classic/build/translations/de.js'`.
 
-See {@link builds/guides/integration/installation#npm npm installation guides} for more information.
+See the {@link builds/guides/integration/installation#npm npm installation guide} for more information.
 
 ### Zip
 
-All additional languages are included in the `.zip` file. You need to include `ckeditor.js` file together with the chosen language file:
+All additional languages are included in the `.zip` file. You need to include the `ckeditor.js` file together with the chosen language file:
 
 ```html
 <script src="[ckeditor-path]/ckeditor.js"></script>
 <script src="[ckeditor-path]/translations/de.js"></script>
 ```
 
-See {@link builds/guides/integration/installation#zip-download zip installation guides} for more information.
+See the {@link builds/guides/integration/installation#zip-download zip installation guide} for more information.
 
 ## Building the editor using a specific language
 
-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.
+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. Check 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.
 
-If you build CKEditor from scratch or integrate it directly into your application, then all you need to do is to:
+If you build CKEditor 5 from scratch or integrate it directly into your application, then all you need to do is to:
 
 1. Install the [`@ckeditor/ckeditor5-dev-webpack-plugin`](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-webpack-plugin) package:
 
@@ -110,10 +112,10 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 	```js
 	const CKEditorWebpackPlugin = require( '@ckeditor/ckeditor5-dev-webpack-plugin' );
 
-	// Define webpack plugins ...
+	// Define webpack plugins...
 		plugins: [
 			new CKEditorWebpackPlugin( {
-				// Main language that will be built into the main bundle.
+				// The main language that will be built into the main bundle.
 				language: 'en',
 
 				// Additional languages that will be emitted to the `outputDirectory`.
@@ -121,7 +123,7 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 				// The bundle is optimized for one language when this option is omitted.
 				additionalLanguages: 'all',
 
-				// Optional directory for emitted translations. Relative to the webpack's output.
+				// An optional directory for emitted translations. Relative to the webpack's output.
 				// Defaults to `'translations'`.
 				// outputDirectory: 'ckeditor5-translations',
 
@@ -139,17 +141,17 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 	// ...
 	```
 
-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 `'translations'` directory (or different, if the `outputDirectory` option is specified).
+3. Run webpack. If the `additionalLanguages` option is not set, the CKEditor 5 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 5 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 `'translations'` 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.
+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/translations/pl.js"></script>
+	<script src="../build/translations/de.js"></script>
 	<script>
 		ClassicEditor
 			.create( document.querySelector( '#editor' ), {
-				language: 'pl'
+				language: 'de'
 			} )
 			.then( editor => {
 				window.editor = editor;
@@ -163,12 +165,12 @@ If you build CKEditor from scratch or integrate it directly into your applicatio
 <info-box>
 	We are aware that the current localization method is not sufficient for some needs. It does not 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 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).
+	You can read more about the used techniques in the [Implement translation services](https://github.com/ckeditor/ckeditor5/issues/387) and [Implement translation services v2](https://github.com/ckeditor/ckeditor5/issues/624) issues.
 </info-box>
 
 ## Setting the language of the content
 
-In CKEditor 5 you can separately configure the language of the UI and the language of the content. That means you can use the English UI of the editor but type your content in Arabic or Hebrew. The language of the content has an impact on the editing experience, for instance it affects screen readers and spell checkers. It is also particularly useful for typing in certain languages (e.g. [right–to–left](#righttoleft-rtl-languages-support) ones) because it changes the default alignment of the text.
+In CKEditor 5 you can separately configure the language of the UI and the language of the content. This means you can use the English UI of the editor but type your content in Arabic or Hebrew. The language of the content has an impact on the editing experience, for instance it affects screen readers and spell checkers. It is also particularly useful for typing in certain languages (e.g. [right–to–left](#righttoleft-rtl-languages-support) ones) because it changes the default alignment of the text.
 
 Configure {@link module:core/editor/editorconfig~EditorConfig#language `config.language`} to change the language of the content. In this example, the UI of the editor will be English but the content will be Arabic:
 
@@ -194,5 +196,5 @@ ClassicEditor
 {@snippet features/ui-language-content}
 
 <info-box>
-	If unsure what language the content will be typed in, do not set it. The language of the content will then be inherited from the {@link module:core/editor/editorconfig~EditorConfig#language language of the UI}.
+	If you are unsure about the language that the content will be typed in, do not set it. The language of the content will then be inherited from the {@link module:core/editor/editorconfig~EditorConfig#language language of the UI}.
 </info-box>