docs: describe linking formats and languages #850

docs/content/authoring/frontmatter/linking/index.en.md

@@ -11,7 +11,7 @@ weight = 3
 
 {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} By default, external links open in a new tab. To change this, use the `externalLinkTarget` setting with a proper [link target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).
 
-To set default values for all links, use [link effects](authoring/linkeffects).
+To set default values for all links, use [link effects](authoring/linking/linkeffects).
 
 For example, this will open links in the same tab
 

docs/content/authoring/linking/_index.en.md

@@ -0,0 +1,9 @@
++++
+alwaysopen = false
+categories = ["reference"]
+description = "How to link your content"
+title = "Linking"
+weight = 5
++++
+
+{{% children containerstyle="div" style="h2" description=true %}}

docs/content/authoring/linking/_index.pir.md

@@ -0,0 +1,8 @@
++++
+alwaysopen = false
+categories = ["reference"]
+description = "How to link your content"
+title = "Linking"
+weight = 5
++++
+{{< piratify >}}

docs/content/authoring/linking/imageeffects.en.md

@@ -3,7 +3,7 @@ categories = ["explanation"]
 description = "How to apply effects to your images"
 frontmatter = ["imageEffects"]
 title = "Image Effects"
-weight = 6
+weight = 3
 +++
 
 The theme offers [effects](authoring/markdown#image-effects) for your linked images.

docs/content/authoring/linking/imageeffects.pir.md

@@ -3,6 +3,6 @@ categories = ["explanation"]
 description = "How to apply effects to your images"
 frontmatter = ["imageEffects"]
 title = "Image Effects"
-weight = 6
+weight = 3
 +++
 {{< piratify >}}

docs/content/authoring/linking/linkeffects.en.md

@@ -1,9 +1,9 @@
 +++
 categories = ["explanation"]
-description = "How to apply graphical effects to your links"
+description = "How to apply effects to your links"
 frontmatter = ["linkEffects"]
 title = "Link Effects"
-weight = 5
+weight = 2
 +++
 
 The theme offers [effects](authoring/markdown#link-effects) for your linked links.

docs/content/authoring/linking/linkeffects.pir.md

@@ -1,8 +1,8 @@
 +++
 categories = ["explanation"]
-description = "How to apply graphical effects to your links"
+description = "How to apply effects to your links"
 frontmatter = ["linkEffects"]
 title = "Link Effects"
-weight = 5
+weight = 2
 +++
 {{< piratify >}}

docs/content/authoring/linking/pages.en.md

@@ -0,0 +1,6 @@
++++
+categories = ["explanation"]
+description = "How to link to pages and resources"
+title = "Pages & Resources"
+weight = 1
++++

docs/content/authoring/linking/pages.pir.md

@@ -0,0 +1,7 @@
++++
+categories = ["explanation"]
+description = "How to link to pages and resources"
+title = "Pages & Resources"
+weight = 1
++++
+{{< piratify >}}

docs/content/authoring/markdown.en.md

@@ -683,7 +683,7 @@ That's some more text with a footnote.[^someid]
 
 ### Link Effects
 
-{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the URL. See the [link effects docs](authoring/linkeffects) for a detailed example and how to configure it.
+{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the URL. See the [link effects docs](authoring/linking/linkeffects) for a detailed example and how to configure it.
 
 #### Target
 
@@ -753,7 +753,7 @@ Images can also be linked by reference ID to later define the URL location. This
 
 ### Image Effects
 
-{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the image URL. See the [image effects docs](authoring/imageeffects) for a detailed example and how to configure it.
+{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the image URL. See the [image effects docs](authoring/linking/imageeffects) for a detailed example and how to configure it.
 
 #### Resizing