Merge commit '5be51ac3db225d5df501ed1fa1499c41d97dbf65'

docs/content/en/functions/urls/AbsLangURL.md

@@ -3,50 +3,56 @@ title: urls.AbsLangURL
 description: Returns an absolute URL with a language prefix, if any.
 categories: []
 keywords: []
-action:
-  aliases: [absLangURL]
-  related:
-    - functions/urls/AbsURL 
-    - functions/urls/RelLangURL
-    - functions/urls/RelURL
-  returnType: string
-  signatures: [urls.AbsLangURL INPUT]
+params:
+  functions_and_methods:
+    aliases: [absLangURL]
+    returnType: string
+    signatures: [urls.AbsLangURL INPUT]
 aliases: [/functions/abslangurl]
 ---
 
 Use this function with both monolingual and multilingual configurations. The URL returned by this function depends on:
 
-- Whether the input begins with a slash
-- The `baseURL` in site configuration
+- Whether the input begins with a slash (`/`)
+- The `baseURL` in your site configuration
 - The language prefix, if any
 
-In examples that follow, the project is multilingual with content in both English (`en`) and Spanish (`es`). The returned values are from the English site.
+This is the site configuration for the examples that follow:
 
-### Input does not begin with a slash
+{{< code-toggle file=hugo >}}
+defaultContentLanguage = 'en'
+defaultContentLanguageInSubdir = true
+[languages.en]
+weight = 1
+[languages.es]
+weight = 2
+{{< /code-toggle >}}
+
+## Input does not begin with a slash
 
 If the input does not begin with a slash, the path in the resulting URL will be relative to the `baseURL` in your site configuration.
 
-With `baseURL = https://example.org/`
+When rendering the `en` site with `baseURL = https://example.org/`
 
 ```go-html-template
-{{ absLangURL "" }}          → https://example.org/en/
-{{ absLangURL "articles" }}  → https://example.org/en/articles
-{{ absLangURL "style.css" }} → https://example.org/en/style.css
+{{ absLangURL "" }}           → https://example.org/en/
+{{ absLangURL "articles" }}   → https://example.org/en/articles
+{{ absLangURL "style.css" }}  → https://example.org/en/style.css
 ```
 
-With `baseURL = https://example.org/docs/`
+When rendering the `en` site with `baseURL = https://example.org/docs/`
 
 ```go-html-template
-{{ absLangURL "" }}          → https://example.org/docs/en/
-{{ absLangURL "articles" }}  → https://example.org/docs/en/articles
-{{ absLangURL "style.css" }} → https://example.org/docs/en/style.css
+{{ absLangURL "" }}           → https://example.org/docs/en/
+{{ absLangURL "articles" }}   → https://example.org/docs/en/articles
+{{ absLangURL "style.css" }}  → https://example.org/docs/en/style.css
 ```
 
-### Input begins with a slash
+## Input begins with a slash
 
 If the input begins with a slash, the path in the resulting URL will be relative to the protocol+host of the `baseURL` in your site configuration.
 
-With `baseURL = https://example.org/`
+When rendering the `en` site with `baseURL = https://example.org/`
 
 ```go-html-template
 {{ absLangURL "/" }}          → https://example.org/en/
@@ -54,10 +60,13 @@ With `baseURL = https://example.org/`
 {{ absLangURL "/style.css" }} → https://example.org/en/style.css
 ```
 
-With `baseURL = https://example.org/docs/`
+When rendering the `en` site with `baseURL = https://example.org/docs/`
 
 ```go-html-template
 {{ absLangURL "/" }}          → https://example.org/en/
 {{ absLangURL "/articles" }}  → https://example.org/en/articles
 {{ absLangURL "/style.css" }} → https://example.org/en/style.css
 ```
+
+> [!note]
+> As illustrated by the previous example, using a leading slash is rarely desirable and can lead to unexpected outcomes. In nearly all cases, omit the leading slash.