Merge branch 'main' into updates-28

docs/src/content/docs/es/guides/authoring-content.md → docs/src/content/docs/es/guides/authoring-content.mdx

@@ -202,17 +202,17 @@ Un bloque de código se indica con un bloque de tres comillas invertidas <code>`
 ```js
 // Código JavaScript con resaltado de sintaxis.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	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;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 ````
@@ -248,8 +248,8 @@ Algunos de los ejemplos más comunes se muestran a continuación:
   ````md
   ```js {2-3}
   function demo() {
-    // Esta línea (#2) y la siguiente están resaltadas
-    return 'Esta es la línea #3 de este fragmento';
+  	// Esta línea (#2) y la siguiente están resaltadas
+  	return 'Esta es la línea #3 de este fragmento';
   }
   ```
   ````
@@ -259,15 +259,15 @@ Algunos de los ejemplos más comunes se muestran a continuación:
   ```js "Términos individuales" /También.*compatibles/
   // Términos individuales también pueden ser resaltados
   function demo() {
-    return 'También las expresiones regulares son compatibles';
+  	return 'También las expresiones regulares son compatibles';
   }
   ```
 
   ````md
   ```js "Términos individuales" /También.*compatibles/
   // Términos individuales también pueden ser resaltados
   function demo() {
-    return 'También las expresiones regulares son compatibles';
+  	return 'También las expresiones regulares son compatibles';
   }
   ```
   ````
@@ -276,18 +276,18 @@ Algunos de los ejemplos más comunes se muestran a continuación:
 
   ```js "return true;" ins="insertados" del="eliminados"
   function demo() {
-    console.log('Estos son tipos de marcadores insertados y eliminados');
-    // La declaración de retorno utiliza el tipo de marcador predeterminado
-    return true;
+  	console.log('Estos son tipos de marcadores insertados y eliminados');
+  	// La declaración de retorno utiliza el tipo de marcador predeterminado
+  	return true;
   }
   ```
 
   ````md
   ```js "return true;" ins="insertados" del="eliminados"
   function demo() {
-    console.log('Estos son tipos de marcadores insertados y eliminados');
-    // La declaración de retorno utiliza el tipo de marcador predeterminado
-    return true;
+  	console.log('Estos son tipos de marcadores insertados y eliminados');
+  	// La declaración de retorno utiliza el tipo de marcador predeterminado
+  	return true;
   }
   ```
   ````
@@ -392,3 +392,118 @@ Starlight admite todas las demás sintaxis de autoría de Markdown, como listas
 ## Configuración avanzada de Markdown y MDX
 
 Starlight utiliza el motor de renderizado de Markdown y MDX de Astro, construido sobre remark y rehype. Puedes añadir soporte para sintaxis y comportamientos personalizados añadiendo `remarkPlugins` o `rehypePlugins` en tu archivo de configuración de Astro. Consulta la sección ["Configuración de Markdown y MDX"](https://docs.astro.build/es/guides/markdown-content/#configuraci%C3%B3n-de-markdown-y-mdx) en la documentación de Astro para obtener más información.
+
+## Markdoc
+
+Starlight admite la creación de contenido en Markdoc utilizando la integración experimental de [Astro Markdoc](https://docs.astro.build/es/guides/integrations-guide/markdoc/) y el preset de Starlight Markdoc.
+
+### Crea un nuevo proyecto con Markdoc
+
+Empieza un nuevo proyecto en Starlight con Markdoc preconfigurado usando `create astro`:
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+<Tabs syncKey="pkg">
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight/markdoc
+```
+
+</TabItem>
+</Tabs>
+
+### Agrega Markdoc a un proyecto existente
+
+Si ya tienes un sitio Starlight y quieres agregar Markdoc, sigue estos pasos.
+
+<Steps>
+
+1.  Agrega la integración de Markdoc de Astro:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npx astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn astro add markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+2.  Instala el preajuste de Starlight Markdoc:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npm install @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+3.  Crea un archivo de configuración de Markdoc en `markdoc.config.mjs` y utiliza el preset de Starlight Markdoc:
+
+    ```js
+    import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+    import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+    export default defineMarkdocConfig({
+    	extends: [starlightMarkdoc()],
+    });
+    ```
+
+</Steps>
+
+Para obtener más información sobre la sintaxis y las características de Markdoc, consulta la [documentación de Markdoc](https://markdoc.dev/docs/syntax) o la [guía de integración de Astro Markdoc](https://docs.astro.build/es/guides/integrations-guide/markdoc/).

docs/src/content/docs/es/guides/customization.mdx

@@ -106,6 +106,8 @@ export default defineConfig({
 });
 ```
 
+Aprende cómo [agregar un enlace del mapa del sitio a `robots.txt`](https://docs.astro.build/es/guides/integrations-guide/sitemap/#enlace-de-sitemap-en-robotstxt) en la documentación de Astro.
+
 ## Diseño de página
 
 De forma predeterminada, las páginas de Starlight utilizan un diseño con una barra lateral de navegación global y una tabla de contenidos que muestra los encabezados de la página actual.
@@ -376,7 +378,7 @@ Proporciona módulos npm que puedes instalar para las fuentes que deseas utiliza
 2.  Instala el paquete para la fuente que has elegido.
     Puedes encontrar el nombre del paquete haciendo clic en “Install” en la página de la fuente de Fontsource.
 
-             <Tabs>
+             <Tabs syncKey="pkg">
 
         <TabItem label="npm">
 

docs/src/content/docs/es/guides/pages.mdx

@@ -14,7 +14,7 @@ Esta guía muestra cómo funciona la generación de páginas en Starlight.
 ### Formatos de archivo
 
 Starlight admite la creación de contenido en Markdown y MDX sin necesidad de configuración.
-Puedes agregar soporte para Markdoc instalando la integración experimental de [Astro Markdoc](https://docs.astro.build/es/guides/integrations-guide/markdoc/).
+Puedes agregar soporte para Markdoc siguiendo la [guía de “Markdoc”](/es/guides/authoring-content/#markdoc).
 
 ### Agregar páginas
 
@@ -109,26 +109,25 @@ Las siguientes propiedades difieren del frontmatter de Markdown:
 
 ##### `sidebar`
 
-**tipo:** `SidebarEntry[]`  
+**tipo:** [`SidebarItem[]`](/es/reference/configuration/#sidebaritem)  
 **por defecto:** la barra lateral generada basada en la [configuración global de `sidebar`](/es/reference/configuration/#sidebar)
 
 Proporciona una barra lateral de navegación personalizada para esta página.
 Si no se establece, la página usará la barra lateral global predeterminada.
 
-Por ejemplo, la siguiente página sobrescribe la barra lateral predeterminada con un enlace a la página de inicio y un grupo de enlaces a diferentes constelaciones.
-La página actual en la barra lateral se establece utilizando la propiedad `isCurrent` y se ha agregado un `badge` opcional a un elemento de enlace.
+Por ejemplo, la siguiente página anula la barra lateral predeterminada con un enlace a la página de inicio y un grupo de enlaces a varias otras páginas personalizadas.
 
 ```astro {3-13}
 <StarlightPage
 	frontmatter={{ title: 'Orion' }}
 	sidebar={[
-		{ label: 'Home', href: '/' },
+		{ label: 'Home', link: '/' },
 		{
 			label: 'Constelaciones',
 			items: [
-				{ label: 'Andromeda', href: '/andromeda/' },
-				{ label: 'Orion', href: '/orion/', isCurrent: true },
-				{ label: 'Osa Menor', href: '/ursa-minor/', badge: 'Stub' },
+				{ label: 'Andromeda', link: '/andromeda/' },
+				{ label: 'Orion', link: '/orion/', isCurrent: true },
+				{ label: 'Osa Menor', link: '/ursa-minor/', badge: 'Stub' },
 			],
 		},
 	]}
@@ -137,6 +136,8 @@ La página actual en la barra lateral se establece utilizando la propiedad `isCu
 </StarlightPage>
 ```
 
+Ver la guía [“Navegación de la barra lateral”](/es/guides/sidebar/) para obtener más información sobre las opciones disponibles para personalizar la barra lateral.
+
 ##### `hasSidebar`
 
 **tipo:** `boolean`  

docs/src/content/docs/es/guides/site-search.mdx

@@ -52,7 +52,7 @@ Si tienes acceso al [programa DocSearch de Algolia](https://docsearch.algolia.co
 
 1. Instala `@astrojs/starlight-docsearch`:
 
-   <Tabs>
+   <Tabs syncKey="pkg">
 
    <TabItem label="npm">
 

docs/src/content/docs/es/index.mdx

@@ -71,7 +71,7 @@ import Testimonial from '~/components/testimonial.astro';
 	la atención a los detalles son inspiradores. Se encarga de la tecnología y el aspecto, 
 	para que puedas centrarte en tu contenido 👏
 
-    ¡El equipo de StackBlitz lo ama absolutamente!
+¡El equipo de StackBlitz lo ama absolutamente!
 
   </Testimonial>
   <Testimonial

docs/src/content/docs/es/reference/frontmatter.md

@@ -115,10 +115,10 @@ hero:
     - text: Cuéntame más
       link: /getting-started/
       icon: right-arrow
-      variant: primary
     - text: View on GitHub
       link: https://github.com/astronaut/my-project
       icon: external
+      variant: minimal
       attrs:
         rel: me
 ---
@@ -166,8 +166,8 @@ interface HeroConfig {
   actions?: Array<{
     text: string;
     link: string;
-    variant: 'primary' | 'secondary' | 'minimal';
-    icon: string;
+    variant?: 'primary' | 'secondary' | 'minimal';
+    icon?: string;
     attrs?: Record<string, string | number | boolean>;
   }>;
 }

docs/src/content/docs/es/resources/plugins.mdx

@@ -78,6 +78,23 @@ Amplia tu sitio con un plugins oficiales respaldados por el equipo de Starlight
 		title="starlight-versions"
 		description="Agrega versiones a tus páginas de documentación de Starlight."
 	/>
+	<LinkCard
+		href="https://inox-tools.fryuni.dev/star-warp"
+		title="star-warp"
+		description="Viaja a través de los resultados de búsqueda en tu documentación"
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-heading-badges"
+		title="starlight-heading-badges"
+		description="Agrega insignias a tus encabezados de Markdown y MDX."
+	/>
+</CardGrid>
+
+### Temas de la comunidad
+
+Un tema es un plugin de Starlight que cambia la apariencia visual de un sitio con reemplazos de componentes, CSS personalizado u otras nuevas características.
+
+<CardGrid>
 	<LinkCard
 		href="https://github.com/HiDeoo/starlight-theme-rapide"
 		title="starlight-theme-rapide"
@@ -122,4 +139,9 @@ Estas herramientas e integraciones de la comunidad se pueden utilizar para añad
 		title="starlight-showcases"
 		description="Conjunto de componentes de Starlight para crear páginas de vitrina."
 	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/generator-starlight-plugin"
+		title="@hideoo/starlight-plugin"
+		description="Un generador para crear rápidamente plugins de Starlight."
+	/>
 </CardGrid>