diff --git a/docs/src/content/docs/es/guides/authoring-content.md b/docs/src/content/docs/es/guides/authoring-content.mdx similarity index 84% rename from docs/src/content/docs/es/guides/authoring-content.md rename to docs/src/content/docs/es/guides/authoring-content.mdx index 231b3c30c1..1d83581307 100644 --- a/docs/src/content/docs/es/guides/authoring-content.md +++ b/docs/src/content/docs/es/guides/authoring-content.mdx @@ -202,8 +202,8 @@ Un bloque de código se indica con un bloque de tres comillas invertidas ` ```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; }; ``` @@ -211,8 +211,8 @@ var fun = function lang(l) { ```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,7 +259,7 @@ 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'; } ``` @@ -267,7 +267,7 @@ 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'; } ``` ```` @@ -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'; + + + + +```sh +npm create astro@latest -- --template starlight/markdoc +``` + + + + +```sh +pnpm create astro --template starlight/markdoc +``` + + + + +```sh +yarn create astro --template starlight/markdoc +``` + + + + +### Agrega Markdoc a un proyecto existente + +Si ya tienes un sitio Starlight y quieres agregar Markdoc, sigue estos pasos. + + + +1. Agrega la integración de Markdoc de Astro: + + + + + + ```sh + npx astro add markdoc + ``` + + + + + + ```sh + pnpm astro add markdoc + ``` + + + + + + ```sh + yarn astro add markdoc + ``` + + + + + +2. Instala el preajuste de Starlight Markdoc: + + + + + + ```sh + npm install @astrojs/starlight-markdoc + ``` + + + + + + ```sh + pnpm add @astrojs/starlight-markdoc + ``` + + + + + + ```sh + yarn add @astrojs/starlight-markdoc + ``` + + + + + +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()], + }); + ``` + + + +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/). diff --git a/docs/src/content/docs/es/guides/customization.mdx b/docs/src/content/docs/es/guides/customization.mdx index 67f40b04ad..44f367bd21 100644 --- a/docs/src/content/docs/es/guides/customization.mdx +++ b/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. - + diff --git a/docs/src/content/docs/es/guides/pages.mdx b/docs/src/content/docs/es/guides/pages.mdx index 7506a49075..e99d7c2716 100644 --- a/docs/src/content/docs/es/guides/pages.mdx +++ b/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} ``` +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` diff --git a/docs/src/content/docs/es/guides/site-search.mdx b/docs/src/content/docs/es/guides/site-search.mdx index a100172a2d..144c32a5a5 100644 --- a/docs/src/content/docs/es/guides/site-search.mdx +++ b/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`: - + diff --git a/docs/src/content/docs/es/index.mdx b/docs/src/content/docs/es/index.mdx index 457604b95a..4d2515ab48 100644 --- a/docs/src/content/docs/es/index.mdx +++ b/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! ; }>; } diff --git a/docs/src/content/docs/es/resources/plugins.mdx b/docs/src/content/docs/es/resources/plugins.mdx index 5f0f1fff6f..dcc06c3a30 100644 --- a/docs/src/content/docs/es/resources/plugins.mdx +++ b/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." /> + + + + +### 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. + + +