feature(Configuration reference / Content formatting options -> Local… (#2355)

hamza0867 · web-flow · commit 4d2d74b8cdd0 · 2022-04-20T15:46:56.000+10:00
* feature(Configuration reference / Content formatting options -&gt; Localization options): Update docs to new system

* feature(Configuration reference / Content formatting options -&gt; Localization options): Make changes as suggested per review
diff --git a/modules/ROOT/pages/plugins/opensource/image.adoc b/modules/ROOT/pages/plugins/opensource/image.adoc
@@ -60,7 +60,7 @@ include::partial$configuration/image_title.adoc[]
 
 include::partial$configuration/image_uploadtab.adoc[]
 
-include::partial$configuration/images_file_types.adoc[]
+include::partial$configuration/images_file_types.adoc[leveloffset=+1]
 
 include::partial$configuration/images_upload_base_path.adoc[leveloffset=+1]
 
diff --git a/modules/ROOT/partials/configuration/automatic_uploads.adoc b/modules/ROOT/partials/configuration/automatic_uploads.adoc
@@ -1,7 +1,7 @@
 [[automatic_uploads]]
 == `automatic_uploads`
 
-Enable or disable automatic upload of images represented by data URLs or blob URIs. Such images get generated, for example, as a result of image manipulation through link:{baseurl}/plugins/opensource/imagetools[Image Tools] plugin, or after image is drag-n-dropped onto the editor from the desktop.
+Enable or disable automatic upload of images represented by data URLs or blob URIs. Such images get generated, for example, as a result of image manipulation through xref:plugins/opensource/imagetools.adoc[Image Tools] plugin, or after image is drag-n-dropped onto the editor from the desktop.
 
 NOTE: This option will do nothing if `images_upload_url` is not specified.
 
diff --git a/modules/ROOT/partials/configuration/browser_spellcheck.adoc b/modules/ROOT/partials/configuration/browser_spellcheck.adoc
@@ -3,7 +3,7 @@
 
 This option configures {productname} to use the browser's native spell checker.
 
-`browser_spellcheck` is not available in either Internet Explorer 8 or 9, as neither browser has native spell checker functionality. For more complete browser support, we recommend using link:../../enterprise/check-spelling/[Spell Checker Pro].
+`browser_spellcheck` is not available in either Internet Explorer 8 or 9, as neither browser has native spell checker functionality. For more complete browser support, we recommend using xref:plugins/premium/tinymcespellchecker.adoc[Spell Checker Pro].
 
 *Type:* `Boolean`
 
@@ -19,4 +19,4 @@ tinymce.init({
 });
 ----
 
-For more information about spell checking in {productname}, see link:{baseurl}/general-configuration-guide/spell-checking/[this page] in the General-configuration-guide/ guide.
+For more information about spell checking in {productname}, see xref:general-configuration-guide/spell-checking.adoc[this page] in the General-configuration-guide/ guide.
diff --git a/modules/ROOT/partials/configuration/builtinformats.adoc b/modules/ROOT/partials/configuration/builtinformats.adoc
@@ -92,12 +92,16 @@ The following formats will work on most content.
 | Font size (1-7).
 |===
 
-NOTE: The `mceToggleFormat` and `FormatBlock` link:{baseurl}/advanced/editor-command-identifiers/[commands] do not accept the following formats:
+[NOTE]
+====
+The `mceToggleFormat` and `FormatBlock` xref:advanced/editor-command-identifiers.adoc[commands] do not accept the following formats:
+
 * `forecolor`
 * `hilitecolor`
 * `fontname`
 * `fontsize`
 * `fontsize_class`
+====
 
 ==== Definition list related formats
 
diff --git a/modules/ROOT/partials/configuration/content_langs.adoc b/modules/ROOT/partials/configuration/content_langs.adoc
@@ -5,7 +5,7 @@ include::partial$misc/requires_5_9v.adoc[]
 
 include::partial$configuration/content_langs_base.adoc[]
 
-There is no default value for the `content_langs` option. If no value is specified, the `language` toolbar button and menu item are not available. A default value for this option is provided by the Spell Checker Pro plugin. For information on using the `content_langs` option with the Spell Checker Pro plugin, see: link:{baseurl}/plugins/premium/tinymcespellchecker/#content_langs[Spell Checker Pro plugin - `content_langs`].
+There is no default value for the `content_langs` option. If no value is specified, the `language` toolbar button and menu item are not available. A default value for this option is provided by the Spell Checker Pro plugin. For information on using the `content_langs` option with the Spell Checker Pro plugin, see: xref:plugins/premium/tinymcespellchecker.adoc#content_langs[Spell Checker Pro plugin - `content_langs`].
 
 *Type:* `Array`
 
diff --git a/modules/ROOT/partials/configuration/content_langs_base.adoc b/modules/ROOT/partials/configuration/content_langs_base.adoc
@@ -1,5 +1,6 @@
 This option sets the languages displayed in the `language` toolbar button and the `language` menu item. The option accepts an array of language specs. Each language spec is a JavaScript object defined using the following properties.
 
+[cols="1,1,1,4"]
 |===
 | Name | Type | Requirement | Description
 
diff --git a/modules/ROOT/partials/configuration/formats.adoc b/modules/ROOT/partials/configuration/formats.adoc
@@ -5,7 +5,7 @@ This option is used to override default {productname} *formats* or add custom *f
 
 {productname} is equipped with a formatting engine that allows you to register a set of styles and attributes as a named *format*. For example, the `bold` format is the style that is applied to text when the bold button is clicked.
 
-Check out the link:{baseurl}/demo/format-custom/[custom formats example] for a demonstration of this option.
+Check out the xref:demo/format-custom.adoc[custom formats example] for a demonstration of this option.
 
 The `formats` configuration option takes an object of format name and format specification pairs. Each format specification must be defined as an object where the value is either an object of format options or an array of such objects.
 
@@ -41,7 +41,7 @@ There are three types of formats:
 * Inline format
 * Selector format
 
-All three format types can be used with the `formats` configuration option. They can also be used to specify a new format item in the link:{baseurl}/configure/editor-appearance/#style_formats[`style_formats`] configuration option. However, a format that is specified using `formats` is then registered with the editor, and can be referred to by name in `style_formats` rather than needing to specify the format again.
+All three format types can be used with the `formats` configuration option. They can also be used to specify a new format item in the xref:configure/editor-appearance.adoc#style_formats[`style_formats`] configuration option. However, a format that is specified using `formats` is then registered with the editor, and can be referred to by name in `style_formats` rather than needing to specify the format again.
 
 For example, these two configurations are equivalent:
 
@@ -71,7 +71,7 @@ tinymce.init({
 });
 ----
 
-A registered format can also be used by name with the built-in link:{baseurl}/api/tinymce/tinymce.formatter[formatter] methods. See link:{baseurl}/configure/content-formatting/#usingcustomformats[/configure/content-formatting/#usingcustomformats] for an example.
+A registered format can also be used by name with the built-in xref:apis/tinymce.formatter.adoc[formatter] methods. See xref:configure/content-formatting.adoc#usingcustomformats[Using custom formats] for an example.
 
 ==== `block`
 
@@ -270,7 +270,7 @@ Specifies what the remove behavior of the element should be when the format is r
 
 This can be set to three different modes:
 
-* *none*: Only styles, classes or attributes are removed from the element the element is never removed.
+* *none*: Only styles, classes or attributes are removed from the element. The element is never removed.
 * *empty*: If the element has no styles, classes, or attributes then the element is removed.
 * *all*: Removes the element regardless of its styles, classes, and or attributes.
 
@@ -423,6 +423,7 @@ tinymce.init({
 });
 ----
 
+[[usingcustomformats]]
 === Using custom formats
 
 Custom formats can be handled through the {productname} API. Here is a basic example of usage for the custom format defined above.
diff --git a/modules/ROOT/partials/configuration/gecko_spellcheck.adoc b/modules/ROOT/partials/configuration/gecko_spellcheck.adoc
@@ -1,9 +1,7 @@
 [[gecko_spellcheck]]
 == `gecko_spellcheck`
 
-____
-Gecko Spell Check was deprecated in TinyMCE v4.3 (consider using  <<browser_spellcheck,#browser_spellcheck>>). This option will be removed in {productname} 6.0.
-____
+NOTE: Gecko Spell Check was deprecated in TinyMCE v4.3 (consider using  xref:browser_spellcheck[browser_spellcheck]). This option will be removed in {productname} 6.0.
 
 This option allows you to disable https://en.wikipedia.org/wiki/Gecko_(software)[Gecko] based browsers' internal spell checker from being used in {productname}.
 
diff --git a/modules/ROOT/partials/configuration/iframe_aria_text.adoc b/modules/ROOT/partials/configuration/iframe_aria_text.adoc
@@ -4,12 +4,12 @@
 include::partial$misc/requires_5_9v.adoc[]
 
 This option is used to customize the `title` attribute on the {productname} `iframe` element. For example:
+[source, html]
+----
+<iframe title="Rich Text Area. Press ALT-0 for help."></iframe>
+----
 
-```html+++<iframe title="Rich Text Area. Press ALT-0 for help.">++++++</iframe>+++
-
-```
-
-The `title` attribute is read by screen-readers to help users identify the editor. This option only applies to {productname} classic (iframe) mode and has no effect on link:{baseurl}/configure/editor-appearance/#inline[`inline` editors].
+The `title` attribute is read by screen-readers to help users identify the editor. This option only applies to {productname} classic (iframe) mode and has no effect on xref:configure/editor-appearance.adoc#inline[`inline` editors].
 
 *Type:* `String`
 
diff --git a/modules/ROOT/partials/configuration/images_file_types.adoc b/modules/ROOT/partials/configuration/images_file_types.adoc
@@ -1,19 +1,20 @@
 [[images_file_types]]
-=== `images_file_types`
+== `images_file_types`
 
 include::partial$misc/requires_5_6v.adoc[]
 
 This option configures which image file formats are accepted by the editor. Changing this option will adjust the following editor behaviour:
-  - Which image file formats are allowed to be uploaded in the xref:plugins/opensource/image.adoc[Image] dialog.
-  - Which image file formats are recognized and placed in an `img` element by the xref:plugins/opensource/paste.adoc[Paste] and xref:plugins/premium/powerpaste.adoc[PowerPaste] `smart_paste` functionality.
+
+* Which image file formats are allowed to be uploaded in the xref:plugins/opensource/image.adoc[Image] dialog.
+* Which image file formats are recognized and placed in an `img` element by the xref:plugins/opensource/paste.adoc[Paste] and xref:plugins/premium/powerpaste.adoc[PowerPaste] `smart_paste` functionality.
 
 *Type:* `String`
 
 *Default Value:* `'jpeg,jpg,jpe,jfi,jif,jfif,png,gif,bmp,webp'`
 
 *Possible Values:* A list of valid web image file extensions. For a list of possible values see: https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types[MDN Web Docs - Image file type and format guide].
 
-==== Example: Using `images_file_types`
+=== Example: Using `images_file_types`
 
 [source, js]
 ----
diff --git a/modules/ROOT/partials/configuration/language.adoc b/modules/ROOT/partials/configuration/language.adoc
@@ -10,8 +10,8 @@ Before changing the language option, ensure that the language pack is available
 
 For information on:
 
-* Using the premium language packs, see: <<usingthepremiumlanguagepacks,Using the premium language packs>>.
-* Using the community language packs, see: <<usingthecommunitylanguagepacks,Using the community language packs>>.
+* Using the premium language packs, see: xref:usingthepremiumlanguagepacks[Using the premium language packs].
+* Using the community language packs, see: xref:usingthecommunitylanguagepacks[Using the community language packs].
 
 *Option:* `language`
 
@@ -31,6 +31,7 @@ tinymce.init({
 });
 ----
 
+[[usingthepremiumlanguagepacks]]
 === Using the premium language packs
 
 The following professionally localized language packs are provided to paid {cloudname} and premium self-hosted deployments. To use these language packs, set the `language` option to the corresponding language code. No additional configuration is required.
diff --git a/modules/ROOT/partials/misc/spell-checker-pro.adoc b/modules/ROOT/partials/misc/spell-checker-pro.adoc
@@ -2,4 +2,4 @@
 
 {productname} Spell Checker Pro is a premium feature that allows spell checking as-you-type and custom dictionary words.
 
-For more information, see link:../../enterprise/check-spelling/[Check Spelling As-You-Type] in the Premium Features section.
+For more information, see xref:enterprise/check-spelling/index.adoc[Check Spelling As-You-Type] in the Premium Features section.
diff --git a/modules/ROOT/partials/misc/using-community-lang-packs.adoc b/modules/ROOT/partials/misc/using-community-lang-packs.adoc
@@ -1,7 +1,8 @@
+[[usingthecommunitylanguagepacks]]
 === Using the community language packs
 
 ifeval::[{forModuleLoaders} != true]
-> *Note*: {companyname} recommends using the `language_url` for the community language packs, to avoid copying the language pack into the `tinymce/langs` folder every time you upgrade {productname}.
+NOTE: {companyname} recommends using the `language_url` for the community language packs, to avoid copying the language pack into the `tinymce/langs` folder every time you upgrade {productname}.
 endif::[]
 
 To use change the user interface language using a community language pack:
