Feature/tinymce5update 2 config from url handling to contribute to documentation (#2353)

Author: lorenzo-pomili

modules/ROOT/pages/configure/contributing-to-open-source.adoc

@@ -21,4 +21,4 @@ The {productname} source code is https://github.com/tinymce/tinymce[hosted on Gi
 
 == Contributing to the documentation
 
-If you would like to contribute to {productname}'s documentation, please see our link:../contributing-docs/[contribute to documentation page and style guide].
+If you would like to contribute to {productname}'s documentation, please see our xref:configure/contributing-docs.adoc[contribute to documentation page and style guide].

modules/ROOT/partials/configuration/br_in_pre.adoc

@@ -3,12 +3,11 @@
 
 This option allows you to disable {productname}'s default behavior when pressing the enter key within a `pre` tag. By default, pressing enter within a `pre` tag produces a `br` tag at the insertion point. For example:
 
-`<pre>This is inside` `<br>` `a pre tag.</pre>`
+`<pre>This is inside<br>a pre tag.</pre>`
 
 However, when `br_in_pre` is set to `false`, rather than inserting a `br` tag {productname} will split the `pre` tag. For example:
 
-`<pre>This is inside </pre>`
-`<pre>a pre tag.</pre>`
+`<pre>This is inside </pre><pre>a pre tag.</pre>`
 
 NOTE: when set to `false`, `shift+enter` will insert a `br` tag.
 

modules/ROOT/partials/configuration/convert_urls.adoc

@@ -1,6 +1,7 @@
-== convert_urls
+[[convert_urls]]
+== `convert_urls`
 
-This option enables you to control whether {productname} is to be smart and restore URLs to their original values. URLs are automatically converted (messed up) by default because the browser's built-in logic works this way. There is no way to get the real URL unless you store it away. If you set this option to `false` it tries to keep these URLs intact. This option is set to `true` by default, which means URLs are forced to be either *absolute* or *relative* depending on the state of <<relative_urls,relative_urls>>.
+This option enables you to control whether {productname} is to be smart and restore URLs to their original values. URLs are automatically converted (messed up) by default because the browser's built-in logic works this way. There is no way to get the real URL unless you store it away. If you set this option to `false` it tries to keep these URLs intact. This option is set to `true` by default, which means URLs are forced to be either *absolute* or *relative* depending on the state of xref:configure/url-handling.adoc#relative_urls[relative_urls].
 
 *Type:* `Boolean`
 

modules/ROOT/partials/configuration/document_base_url.adoc

@@ -1,8 +1,9 @@
+[[document_base_url]]
 == `document_base_url`
 
 This option specifies the base URL for all relative URLs in the document. The default value is the directory of the current document. If a value is provided, it must specify a directory (not a document) and must end with a `/`.
 
-This option also interacts with the <<relative_urls,relative_urls>>, <<remove_script_host,remove_script_host>>, and <<convert_urls,convert_urls>> options to determine whether {productname} returns relative or absolute URLs. The link:{baseurl}/general-configuration-guide/get-support/[FAQ] contains a thorough description and examples of working with relative and absolute URLs.
+This option also interacts with the xref:configure/url-handling.adoc#relative_urls[relative_urls], xref:configure/url-handling.adoc#remove_script_host[remove_script_host], and xref:configure/url-handling.adoc#convert_urls[convert_urls] options to determine whether {productname} returns relative or absolute URLs. The xref:general-configuration-guide/get-support.adoc[FAQ] contains a thorough description and examples of working with relative and absolute URLs.
 
 *Type:* `String`
 

modules/ROOT/partials/configuration/relative_urls.adoc

@@ -1,8 +1,9 @@
+[[relative_urls]]
 == `relative_urls`
 
 For URLs with the same domain as the page containing the {productname} editor. If set to:
 
-* `true` -- All URLs created in {productname} will be converted to a link relative to the <<document_base_url,`document_base_url`>>.
+* `true` -- All URLs created in {productname} will be converted to a link relative to the xref:configure/url-handling.adoc#document_base_url[`document_base_url`].
 * `false` -- All URLs will be converted to absolute URLs.
 
 *Type:* `Boolean`

modules/ROOT/partials/configuration/remove_script_host.adoc

@@ -1,6 +1,7 @@
+[[remove_script_host]]
 == `remove_script_host`
 
-This option is used if the <<relative_urls,`relative_urls`>> option is set to `false` and only applies to links with the same domain as the <<document_base_url,`document_base_url`>>.
+This option is used if the xref:configure/url-handling.adoc#relative_urls[`relative_urls`] option is set to `false` and only applies to links with the same domain as the xref:configure/url-handling.adoc#document_base_url[`document_base_url`].
 
 If this option is set to `true`, the protocol and host of the `document_base_url` is _excluded_ for relative links.
 

modules/ROOT/partials/configuration/urlconverter_callback.adoc

@@ -9,18 +9,22 @@ The format of the converter function is: `URLConverter(url, node, on_save)`, whe
 * on_save is always set to true.
 * name = the attribute name that is being set.
 
-This function should return the converted URL as a string. This option is set to an internal {productname} function xref:apis/tinymce.editor.adoc[convertURL()] by default. You may call this function from your extension in order to use the built-in convert options.
+This function should return the converted URL as a string. This option is set to an internal {productname} function xref:apis/tinymce.editor.adoc#convertURL[convertURL()] by default. You may call this function from your extension in order to use the built-in convert options.
 
 *Type:* `Javascript Function`
 
 === Example: Using `urlconverter_callback`
 
-```js
+[source, js]
+----
 tinymce.init({
   selector: 'textarea',  // change this value according to your HTML
   urlconverter_callback: function(url, node, on_save, name) {
     // Do some custom URL conversion
     url = url.substring(3);
 
- // Return new URL
- return url;   } }); ```
+    // Return new URL
+    return url;
+  }
+});
+----

modules/ROOT/partials/misc/url-handling.adoc

@@ -2,7 +2,7 @@
 
 === Relative URLs
 
-This will convert all URLs within the same domain to relative URLs. The URLs will be relative from the <<document_base_url,document_base_url>>.
+This will convert all URLs within the same domain to relative URLs. The URLs will be relative from the xref:configure/url-handling.adoc#document_base_url[document_base_url].
 
 ----
 relative_urls : true,
@@ -13,7 +13,7 @@ Example: `+http://www.example.com/path1/path2/file.htm+` >> `path2/file.htm`
 
 === Absolute URLs
 
-This will convert all relative URLs to absolute URLs. The URLs will be absolute based on the <<document_base_url,document_base_url>>.
+This will convert all relative URLs to absolute URLs. The URLs will be absolute based on the xref:configure/url-handling.adoc#document_base_url[document_base_url].
 
 ----
 relative_urls : false,
@@ -25,7 +25,7 @@ Example: path2/file.htm >> /path1/path2/file.htm
 
 === Domain absolute URLs
 
-This will convert all relative URLs to absolute URLs. The URLs will be absolute based on the <<document_base_url,document_base_url>> with domain.
+This will convert all relative URLs to absolute URLs. The URLs will be absolute based on the xref:configure/url-handling.adoc#document_base_url[document_base_url] with domain.
 
 ----
 relative_urls : false,