📝 docs(shortcodes): clarify `position` parameter usage for "aside"

content/blog/shortcodes/index.ca.md

@@ -1,7 +1,7 @@
 +++
 title = "Shortcodes personalitzats"
 date = 2023-02-19
-updated = 2024-12-24
+updated = 2024-12-27
 description = "Aquest tema inclou alguns shortcodes personalitzats útils que pots utilitzar per millorar les teves publicacions. Ja sigui per mostrar imatges que s'adapten als temes clar i fosc, o per donar format a una secció de referències amb un aspecte professional, aquests shortcodes personalitzats t'ajudaran."
 
 [taxonomies]
@@ -224,7 +224,7 @@ Afegeix contingut complementari als marges en pantalles amples, o com a blocs di
 
 El shortcode accepta dos paràmetres:
 
-- `position`: Establir com a "right" per col·locar al marge dret (per defecte, esquerre)
+- `position`: Establir com a `"right"` per col·locar al marge dret (per defecte, esquerre)
 - El contingut es pot proporcionar mitjançant el paràmetre `text` o entre les etiquetes del shortcode
 
 #### Ús
@@ -235,10 +235,10 @@ Fent servir el paràmetre `text`:
 {{/* aside(text="*Nota al marge* ve de *nota* (del llatí, 'marca' o 'senyal') i *marge* (del llatí *margo*, 'vora' o 'límit').") */}}
 ```
 
-Fent servir el cos del contingut:
+Fent servir el cos del contingut i indicant la posició a la dreta:
 
 ```
-{%/* aside() */%}
+{%/* aside(position="right") */%}
 Una nota més llarga que
 pot ocupar diverses línies.
 

content/blog/shortcodes/index.es.md

@@ -1,7 +1,7 @@
 +++
 title = "Shortcodes personalizados"
 date = 2023-02-19
-updated = 2024-12-24
+updated = 2024-12-27
 description = "Este tema incluye algunos shortcodes personalizados útiles que puedes utilizar para mejorar tus publicaciones. Puedes mostrar imágenes que se adapten a los temas claro y oscuro, dar formato a una sección de referencias con un aspecto profesional, y más."
 
 [taxonomies]
@@ -223,7 +223,7 @@ Añade contenido complementario en los márgenes en pantallas anchas, o como blo
 
 El shortcode acepta dos parámetros:
 
-- `position`: Establecer como "right" para colocar en el margen derecho (por defecto, izquierdo)
+- `position`: Establecer como `"right"` para colocar en el margen derecho (por defecto, izquierdo)
 - El contenido puede proporcionarse mediante el parámetro `text` o entre las etiquetas del shortcode
 
 #### Uso
@@ -234,10 +234,10 @@ Usando el parámetro `text`:
 {{/* aside(text="*Nota al margen* viene de *nota* (del latín, 'marca' o 'señal') y *margen* (del latín *margo*, 'borde' o 'límite').") */}}
 ```
 
-Usando el cuerpo del contenido:
+Usando el cuerpo del contenido e indicando la posición:
 
 ```
-{%/* aside() */%}
+{%/* aside(position="right") */%}
 Una nota más larga que
 puede ocupar varias líneas.
 

content/blog/shortcodes/index.md

@@ -1,7 +1,7 @@
 +++
 title = "Custom shortcodes"
 date = 2023-02-19
-updated = 2024-12-24
+updated = 2024-12-27
 description = "This theme includes some useful custom shortcodes that you can use to enhance your posts. Whether you want to display images that adapt to light and dark themes, or format a professional-looking reference section, these custom shortcodes have got you covered."
 
 [taxonomies]
@@ -224,7 +224,7 @@ Add supplementary content in the margins on wide screens, or as distinct blocks
 
 The shortcode accepts two parameters:
 
-- `position`: Set to "right" to place in right margin (defaults to left)
+- `position`: Set to `"right"` to place in right margin (defaults to left)
 - Content can be provided via `text` parameter or between shortcode tags
 
 #### Usage
@@ -235,10 +235,10 @@ Using the `text` parameter:
 {{/* aside(text="*Sidenote* comes from Latin *nota* ('mark') + Old English *síde* ('side').") */}}
 ```
 
-Using the content body:
+Using the content body and setting the position to right:
 
 ```
-{%/* aside() */%}
+{%/* aside(position="right") */%}
 A longer note that
 can span multiple lines.