Merge pull request #147 from Waxer59/i18n-update-syntax

i18n(es): `markdown-syntax.md` replaced to `authoring-content.md`

2 files changed, 209 insertions, 293 deletions

diff --git a/docs/src/content/docs/es/guides/authoring-content.md b/docs/src/content/docs/es/guides/authoring-content.md
new file mode 100644
index 00000000..5160a897
--- /dev/null
+++ b/docs/src/content/docs/es/guides/authoring-content.md
@@ -0,0 +1,209 @@
+---
+title: Creación de contenido en Markdown
+description: Una descripción general de la sintaxis Markdown que soporta Starlight.
+---
+
+Starlight admite la gama completa de la sintaxis [Markdown](https://daringfireball.net/projects/markdown/) en archivos `.md`, así como el frontmatter en [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) para definir metadatos como el título y la descripción.
+
+Por favor, asegúrate de consultar la documentación de [MDX](https://mdxjs.com/docs/what-is-mdx/#markdown) o [Markdoc](https://markdoc.dev/docs/syntax) si estás utilizando esos formatos de archivo, ya que el soporte y el uso de Markdown pueden variar.
+
+## Estilos en línea
+
+El texto puede estar **en negrita**, _en cursiva_, o ~~tachado~~.
+
+```md
+El texto puede estar **en negrita**, _en cursiva_, o ~~tachado~~.
+```
+
+Puedes [enlazar a otra página](/getting-started.md).
+
+```md
+Puedes [enlazar a otra página](/getting-started.md).
+```
+
+Puedes resaltar `código en línea` con comillas invertidas.
+
+```md
+Puedes resaltar `código en línea` con comillas invertidas.
+```
+
+## Imágenes
+
+Las imágenes en Starlight utilizan el soporte de assets optimizados incorporado en Astro.
+
+Markdown y MDX admiten la sintaxis Markdown para mostrar imágenes, que incluye alt-text para lectores de pantalla y tecnología de asistencia.
+
+![Una ilustración de planetas y estrellas con la palabra “astro”](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
+
+```md
+![Una ilustración de planetas y estrellas con la palabra “astro”](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
+```
+
+También se admiten rutas de imágenes relativas para imágenes almacenadas localmente en tu proyecto.
+
+```md
+// src/content/docs/page-1.md
+
+![Una nave espacial en el espacio.](../../assets/images/rocket.svg)
+```
+
+
+## Encabezados
+
+Puedes estructurar el contenido utilizando encabezados. Los encabezados en Markdown se indican con uno o más `#` al comienzo de la línea.
+
+### Cómo estructurar el contenido de la página en Starlight
+
+Starlight está configurado para utilizar automáticamente el título de tu página como un encabezado de nivel superior y se incluirá un encabezado "Visión general" en la parte superior de la tabla de contenido de cada página. Recomendamos comenzar cada página con contenido de texto de párrafo regular y utilizar encabezados dentro de la página a partir de `<h2>` en adelante:
+
+```md
+---
+title: Guía de Markdown
+description: Cómo utilizar Markdown en Starlight
+---
+
+Esta página describe cómo utilizar Markdown en Starlight.
+
+## Estilos en línea
+
+## Encabezados
+
+```
+
+### Enlaces de anclaje automáticos para encabezados.
+
+Al utilizar encabezados en Markdown, se generan automáticamente enlaces de anclaje para que puedas vincular directamente a ciertas secciones de tu página:
+
+```md
+---
+title: Mi página de contenido
+description: Cómo utilizar los enlaces de anclaje integrados de Starlight.
+---
+## Introducción
+
+Puedo enlazar a [mi conclusión](#conclusión) más abajo en la misma página.
+
+## Conclusión
+
+`https://mi-sitio.com/page1/#introduction` navega directamente a mi Introducción.
+```
+Los encabezados de nivel 2 (`<h2>`) y nivel 3 (`<h3>`) aparecerán automáticamente en la tabla de contenido de la página.
+
+
+## Apartados
+
+Los apartados (también conocidos como “apartados” o ”contenido destacado”) son útiles para mostrar información secundaria junto al contenido principal de una página.
+
+Starlight proporciona una sintaxis personalizada de Markdown para renderizar apartados. Los bloques de apartados se indican utilizando un par de triples dos puntos `:::` para envolver tu contenido, y pueden ser de tipo `note`, `tip`, `caution` o `danger`.
+
+Puedes anidar cualquier otro tipo de contenido Markdown dentro de un apartado, pero los apartados son más adecuados para fragmentos de contenido cortos y concisos.
+
+### Nota de apartados
+
+:::note
+Starlight es un conjunto de herramientas para crear sitios web de documentación construido con [Astro](https://astro.build/). Puedes comenzar con este comando:
+
+```sh
+npm run create astro@latest --template starlight
+```
+
+:::
+
+````md
+:::note
+Starlight es un conjunto de herramientas para sitios de documentación construido con [Astro](https://astro.build/). Puedes comenzar con este comando:
+
+```sh
+npm run create astro@latest --template starlight
+```
+
+:::
+````
+
+### Títulos personalizados para los apartados
+
+Puedes especificar un título personalizado para el apartado utilizando corchetes cuadrados después del tipo del apartado, por ejemplo, `:::tip[¿Sabías esto?]`.
+
+:::tip[¿Sabías esto?]
+Astro te ayuda a construir sitios web más rápidos con la[“Arquitectura de Islas”](https://docs.astro.build/es/concepts/islands/).
+:::
+
+```md
+:::tip[¿Sabías esto?]
+Astro te ayuda a construir sitios web más rápidos con la[“Arquitectura de Islas”](https://docs.astro.build/es/concepts/islands/).
+:::
+```
+
+### Más tipos de apartados
+
+Los apartados de caution y danger son útiles para llamar la atención del usuario sobre detalles que podrían generar problemas. Si te encuentras utilizando estos tipos de apartados con frecuencia, también puede ser una señal de que lo que estás documentando podría beneficiarse de una reestructuración o rediseño.
+
+:::caution
+Si no estás seguro de si deseas un sitio de documentación increíble, piénsalo dos veces antes de usar [Starlight](../../).
+:::
+
+:::danger
+Tus usuarios pueden ser más productivos y encontrar más fácil de usar tu producto gracias a las útiles características de Starlight.
+
+- Navegación clara
+- Tema de color configurable por el usuario
+- [Soporte de i18n](/guides/i18n)
+
+:::
+
+```md
+:::caution
+Si no estás seguro de si deseas un sitio de documentación increíble, piénsalo dos veces antes de usar [Starlight](../../).
+:::
+
+:::danger
+Tus usuarios pueden ser más productivos y encontrar más fácil de usar tu producto gracias a las útiles características de Starlight.
+
+- Navegación clara
+- Tema de color configurable por el usuario
+- [Soporte de i18n](/guides/i18n)
+
+:::
+```
+
+## Citas en bloque
+
+> Esto es una cita en bloque, que se utiliza comúnmente para citar a otra persona o documento.
+>
+> Las citas en bloque se indican con un `>` al inicio de cada línea.
+
+```md
+> Esto es una cita en bloque, que se utiliza comúnmente para citar a otra persona o documento.
+>
+> Las citas en bloque se indican con un `>` al inicio de cada línea.
+```
+
+## Bloques de código
+
+Un bloque de código se indica con un bloque de tres comillas invertidas <code>```</code> al inicio y al final. Puedes indicar el lenguaje de programación que se está utilizando después de las comillas invertidas de apertura.
+
+```js
+// Código JavaScript con resaltado de sintaxis.
+var fun = function lang(l) {
+  dateformat.i18n = require('./lang/' + l);
+  return true;
+};
+```
+
+````md
+```js
+// Código JavaScript con resaltado de sintaxis.
+var fun = function lang(l) {
+  dateformat.i18n = require('./lang/' + l);
+  return true;
+};
+```
+````
+
+```md
+Los bloques de código largos de una sola línea no deben ajustarse automáticamente. Deben desplazarse horizontalmente si son demasiado largos. Esta línea debe ser lo suficientemente larga para demostrar esto.
+```
+
+## Otras características comunes de Markdown
+
+Starlight admite todas las demás sintaxis de autoría de Markdown, como listas y tablas. Puedes consultar la [Guía de referencia de Markdown](https://www.markdownguide.org/cheat-sheet/) para obtener una descripción general rápida de todos los elementos de sintaxis de Markdown.
diff --git a/docs/src/content/docs/es/reference/markdown-syntax.md b/docs/src/content/docs/es/reference/markdown-syntax.md
deleted file mode 100644
index 46136ee2..00000000
--- a/docs/src/content/docs/es/reference/markdown-syntax.md
+++ /dev/null
@@ -1,293 +0,0 @@
----
-title: Sintaxis de Markdown
-description: Una visión general de la sintaxis Markdown que Starlight admite.
----
-
-Starlight admite la gama completa de sintaxis de Markdown.
-
-## Estilos en línea
-
-El texto puede estar **en negrita**, _en cursiva_, o ~~tachado~~.
-
-```md
-El texto puede estar **en negrita**, _en cursiva_, o ~~tachado~~.
-```
-
-Puedes [enlazar a otra página](/getting-started.md).
-
-```md
-Puedes [enlazar a otra página](/getting-started.md).
-```
-
-Puedes resaltar `código en línea` con comillas invertidas.
-
-```md
-Puedes resaltar `código en línea` con comillas invertidas.
-```
-
-## Encabezados
-
-Puedes estructurar el contenido utilizando encabezados. Los encabezados en Markdown se indican con uno o más `#` al inicio de la línea. Aunque es compatible, generalmente se recomienda evitar los encabezados de nivel superior y comenzar los encabezados en la página desde `<h2>` en adelante.
-
-## Encabezado 2
-
-### Encabezado 3
-
-#### Encabezado 4
-
-##### Encabezado 5
-
-###### Encabezado 6
-
-```md
-## Encabezado 2
-
-### Encabezado 3
-
-#### Encabezado 4
-
-##### Encabezado 5
-
-###### Encabezado 6
-```
-
-## Asides
-
-Los asides (también conocidos como “admoniciones” o ”callouts”) son útiles para mostrar información secundaria junto al contenido principal de una página.
-
-Starlight proporciona una sintaxis personalizada de Markdown para renderizar asides. Los bloques de asides se indican utilizando tres dos puntos `:::` y pueden ser de tipo `note`, `tip`, `caution` o `danger`.
-
-Puedes anidar cualquier otro tipo de contenido Markdown dentro de un aside, pero los asides son más adecuados para fragmentos de contenido cortos y concisos.
-
-### Nota aside
-
-:::note
-Starlight es un conjunto de herramientas para crear sitios web de documentación construido con [Astro](https://astro.build/). Puedes comenzar con este comando:
-
-```sh
-npm run create astro@latest --template starlight
-```
-
-:::
-
-````md
-:::note
-Starlight es un conjunto de herramientas para sitios de documentación construido con [Astro](https://astro.build/). Puedes comenzar con este comando:
-
-```sh
-npm run create astro@latest --template starlight
-```
-
-:::
-````
-
-### Títulos personalizados para los asides
-
-Puedes especificar un título personalizado para el aside utilizando corchetes cuadrados después del tipo del aside, por ejemplo, `:::tip[¿Sabías esto?]`.
-
-:::tip[¿Sabías esto?]
-Astro te ayuda a construir sitios web más rápidos con la[“Arquitectura de Islas”](https://docs.astro.build/es/concepts/islands/).
-:::
-
-```md
-:::tip[¿Sabías esto?]
-Astro te ayuda a construir sitios web más rápidos con la[“Arquitectura de Islas”](https://docs.astro.build/es/concepts/islands/).
-:::
-```
-
-### Más tipos de asides
-
-Los asides de caution y danger son útiles para llamar la atención del usuario sobre detalles que podrían generar problemas. Si te encuentras utilizando estos tipos de asides con frecuencia, también puede ser una señal de que lo que estás documentando podría beneficiarse de una reestructuración o rediseño.
-
-:::caution
-Si no estás seguro de si deseas un sitio de documentación increíble, piénsalo dos veces antes de usar [Starlight](../../).
-:::
-
-:::danger
-Tus usuarios pueden ser más productivos y encontrar más fácil de usar tu producto gracias a las útiles características de Starlight.
-
-- Navegación clara
-- Tema de color configurable por el usuario
-- [Soporte de i18n](/guides/i18n)
-
-:::
-
-```md
-:::caution
-Si no estás seguro de si deseas un sitio de documentación increíble, piénsalo dos veces antes de usar [Starlight](../../).
-:::
-
-:::danger
-Tus usuarios pueden ser más productivos y encontrar más fácil de usar tu producto gracias a las útiles características de Starlight.
-
-- Navegación clara
-- Tema de color configurable por el usuario
-- [Soporte de i18n](/guides/i18n)
-
-:::
-```
-
-## Citas en bloque
-
-> Esto es una cita en bloque, que se utiliza comúnmente para citar a otra persona o documento.
->
-> Las citas en bloque se indican con un `>` al inicio de cada línea.
-
-```md
-> Esto es una cita en bloque, que se utiliza comúnmente para citar a otra persona o documento.
->
-> Las citas en bloque se indican con un `>` al inicio de cada línea.
-```
-
-## Bloques de código
-
-Un bloque de código se indica con un bloque de tres comillas invertidas <code>```</code> al inicio y al final. Puedes indicar el lenguaje de programación que se está utilizando después de las comillas invertidas de apertura.
-
-```js
-// Código JavaScript con resaltado de sintaxis.
-var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
-};
-```
-
-````md
-```js
-// Código JavaScript con resaltado de sintaxis.
-var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
-};
-```
-````
-
-```md
-Los bloques de código largos de una sola línea no deben ajustarse automáticamente. Deben desplazarse horizontalmente si son demasiado largos. Esta línea debe ser lo suficientemente larga para demostrar esto.
-```
-
-## Listas
-
-Markdown admite listas desordenadas (a menudo llamadas listas de “puntos”) y listas ordenadas, que están numeradas secuencialmente.
-
-### Aquí tienes una lista desordenada:
-
-- Elemento foo
-- Elemento bar
-- Elemento baz
-
-### Y una lista ordenada:
-
-1.  Elemento uno
-1.  Elemento dos
-1.  Elemento tres
-
-### Y algunas listas anidadas
-- Elemento de nivel 1 (ul)
-  1. Elemento de nivel 2 (ol)
-  2. Elemento de nivel 2 (ol)
-     - Elemento de nivel 3 (ul)
-     - Elemento de nivel 3 (ul)
-- Elemento de nivel 1 (ul)
-  1. Elemento de nivel 2 (ol)
-  2. Elemento de nivel 2 (ol)
-     - Elemento de nivel 3 (ul)
-     - Elemento de nivel 3 (ul)
-       1. Elemento de nivel 4 (ol)
-       2. Elemento de nivel 4 (ol)
-     - Elemento de nivel 3 (ul)
-     - Elemento de nivel 3 (ul)
-- Elemento de nivel 1 (ul)
-
-### Anidar contenido mixto en listas
-
-- Esta lista contiene ejemplos de código
-
-  ```js
-  console.log('hi');
-  ```
-
-- Y **otro** contenido como imágenes:
-  ![Logo de VuePress](https://raw.githubusercontent.com/withastro/docs/main/public/logos/vuepress.png)
-
-- o citas en bloque
-
-  > para identar
-
-- Pero los estilos en línea como **negrita**, _cursiva_, `código`, o ~~tachado~~, no cambian el espaciado vertical.
-
-- ¿Cierto?
-
-## Tablas
-
-Las tablas Markdown admiten la alineación horizontal.
-
-| head1        |     head dos          | tres  |
-| :----------- | :-------------------: | ----: |
-| ok           |  buen pescado sueco   |  bien |
-| agotado      |  bueno y abundante    |  bien |
-| ok           |   buenos `oreos`      |   hmm |
-| ok           | buena gota de `zoute` |  yumm |
-
-```md
-| head1        |     head dos          | tres  |
-| :----------- | :-------------------: | ----: |
-| ok           |  buen pescado sueco   |  bien |
-| agotado      |  bueno y abundante    |  bien |
-| ok           |   buenos `oreos`      |   hmm |
-| ok           | buena gota de `zoute` |  yumm |
-```
-
-## Líneas horizontales
-
-Markdown admite representar una línea horizontal (un elemento `<hr>`) utilizando una sintaxis de triple guion: `---`.
-
----
-
-```md
----
-```
-
-## Listas de definición
-
-Si bien Markdown no proporciona una sintaxis personalizada para listas de definiciones, aún puedes escribirlas utilizando los elementos HTML estándar `<dl>`, `<dt>` y `<dd>`:
-
-<dl>
-  <dt>Nombre</dt>
-  <dd>Godzilla</dd>
-  <dt>Nacido</dt>
-  <dd>1952</dd>
-  <dt>Término 1</dt>
-  <dt>Término 2</dt>
-  <dd>Primera descripción de Término1 y Término2, posiblemente en más de una línea</dd>
-  <dd>Segunda descripción de Término1 y Término2, posiblemente en más de una línea</dd>
-</dl>
-
-## Imágenes
-
-### Imagen pequeña
-
-![Logo de VuePress](https://raw.githubusercontent.com/withastro/docs/main/public/logos/vuepress.png)
-
-```md
-![Logo de VuePress](https://raw.githubusercontent.com/withastro/docs/main/public/logos/vuepress.png)
-```
-
-### Imagen grande
-
-![Una ilustración de planetas y estrellas con la palabra “astro”](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
-
-```md
-![Una ilustración de planetas y estrellas con la palabra “astro”](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
-```
-
-## Pruebas de marcado variadas
-
-### Prueba de enlaces largos
-
-[Este es un enlace muy largo que se ajusta automáticamente y, por lo tanto, no desborda incluso cuando está al principio](.) de la línea.
-
-- [Este es un enlace muy largo que se ajusta automáticamente y, por lo tanto, no desborda la línea cuando se utiliza primero en un elemento](.) en una lista.
-
-### ¡Supercalifragilisticoespialidoso!
-
-Asegurándose de que este encabezado con una palabra muy larga se ajuste automáticamente en lugar de desbordarse en pantallas pequeñas.