Merge pull request #17100 from ckeditor/mention-umd-builds-in-nim-mig…

…ration-guides Docs: Add information about the UMD builds to NIM migration guides.
ckeditor · Sep 16, 2024 · 36fb1cd · 36fb1cd
2 parents 18ab27a + f25bdd5
commit 36fb1cd
Show file tree

Hide file tree

Showing 3 changed files with 1,076 additions and 8 deletions.
diff --git a/docs/updating/nim-migration/migration-to-new-installation-methods.md b/docs/updating/nim-migration/migration-to-new-installation-methods.md
@@ -169,6 +169,34 @@ ClassicEditor
 </script>
 ```
 
+In some environments, you may not be able to use the import maps or JavaScript modules. In such cases, you can use the UMD builds instead. These register global variables that you can use in your scripts. This is the same setup as above, but using the UMD builds:
+
+```html
+<!-- Style sheets -->
+<link rel="stylesheet" href="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/ckeditor5.css" />
+<link rel="stylesheet" href="https://cdn.ckeditor.com/ckeditor5-premium-features/{@var ckeditor5-version}/ckeditor5-premium-features.css" />
+
+<!-- Scripts -->
+<script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/ckeditor5.umd.js"></script>
+<script src="https://cdn.ckeditor.com/ckeditor5-premium-features/{@var ckeditor5-version}/ckeditor5-premium-features.umd.js"></script>
+
+<!-- Translations -->
+<script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/translations/pl.umd.js"></script>
+<script src="https://cdn.ckeditor.com/ckeditor5-premium-features/{@var ckeditor5-version}/translations/pl.umd.js"></script>
+
+<script>
+const { ClassicEditor, Essentials, Bold, Italic, Paragraph, Mention } = CKEDITOR;
+const { FormatPainter, SlashCommand } = CKEDITOR_PREMIUM_FEATURES;
+
+ClassicEditor
+ .create( document.querySelector( '#editor' ), {
+ plugins: [ Essentials, Bold, Italic, Paragraph, Mention, FormatPainter, SlashCommand ],
+ toolbar: [ /* ... */ ],
+ licenseKey: '<LICENSE_KEY>'
+ } );
+</script>
+```
+
 ### What's new?
 
 There are a few things that stand out in both examples compared to the old installation methods:

diff --git a/docs/updating/nim-migration/online-builder.md b/docs/updating/nim-migration/online-builder.md
@@ -21,7 +21,7 @@ The CDN build is a good option to quickly add CKEditor&nbsp;5 to your website wi
 
 ## ZIP archive
 
-If you do not want to have a build process or use our CDN build, you can download the ZIP archive from the [CKEditor&nbsp;5 download page](https://ckeditor.com/ckeditor-5/download/#zip). This archive contains the editor build with all its plugins, which you can extract and include on your website.
+If you do not want to have a build process or use our CDN build, you can download a ZIP archive with the editor build. We recommend using our new interactive [Builder](https://ckeditor.com/ckeditor-5/builder/?redirect=docs) to customize the build to your needs. Then, in the `Installation` section of the Builder, you can select the `Self-hosted (ZIP)` option to learn how to add the editor to your website.
 
 ## npm package