getting-started.mdx

title	description
Empezando	Aprende cómo empezar a construir tu próximo sitio de documentación con Starlight utilizando Astro.

import { Tabs, TabItem } from '@astrojs/starlight/components';

Starlight es un tema de documentación completo construido sobre el framework Astro. Esta guía te ayudará a comenzar con un nuevo proyecto. Consulta las instrucciones de configuración manual para agregar Starlight a un proyecto de Astro existente.

Inicio rápido

Crea un nuevo proyecto

Crea un nuevo proyecto de Astro + Starlight ejecutando el siguiente comando en tu terminal:

npm create astro@latest -- --template starlight

pnpm create astro --template starlight

yarn create astro --template starlight

Esto creará un nuevo directorio de proyecto con todos los archivos y configuraciones necesarios para tu sitio.

:::tip[Míralo en acción] Prueba Starlight en tu navegador: abre la plantilla en StackBlitz. :::

Inicia el servidor de desarrollo

Cuando trabajas localmente, el servidor de desarrollo de Astro te permite previsualizar tu trabajo y actualiza automáticamente tu navegador cuando realizas cambios.

Dentro del directorio de tu proyecto, ejecuta el siguiente comando para iniciar el servidor de desarrollo:

npm run dev

pnpm dev

yarn dev

Esto imprimirá un mensaje en tu terminal con la URL de la vista previa local. Abre esta URL para comenzar a navegar por tu sitio.

Añade contenido

Starlight está listo para que añadas nuevo contenido o ¡traigas tus archivos existentes!.

Agrega nuevas páginas a tu sitio web creando archivos Markdown en el directorio src/content/docs/.

Lee más sobre el enrutamiento basado en archivos y el soporte para archivos MDX y Markdoc en la Guía de Páginas

Siguientes pasos

• Configura: Aprende acerca de las opciones comunes en “Personalizando Starlight”.
• Navega: Configura tu barra lateral siguiendo la guía “Barra Lateral de Navegación”.
• Componentes: Descubre tarjetas incorporadas, pestañas y más en la guía “Componentes”.
• Despliega: Publica tu trabajo siguiendo la guía “Despliega tu sitio” en la documentación de Astro.

Actualizando Starlight

:::tip Debido a que Starlight es un software beta, habrá actualizaciones y mejoras frecuentes. ¡Asegúrate de actualizar Starlight regularmente! :::

Starlight es una integración Astro. Puedes actualizarlo y otros paquetes de Astro ejecutando el siguiente comando en tu terminal:

npx @astrojs/upgrade

pnpm dlx @astrojs/upgrade

yarn dlx @astrojs/upgrade

Consulta el registro de cambios de Starlight para obtener una lista completa de los cambios realizados en cada versión.

Solución de problemas de Starlight

Utiliza las páginas de referencia de configuración del proyecto y configuración del frontmatter de páginas individuales para asegurarte de que tu sitio de Starlight esté configurado y funcione correctamente. Consulta las guías en la barra lateral para obtener ayuda en la adición de contenido y personalización de tu sitio de Starlight.

Si no encuentras la respuesta en la documentación, visita la documentación completa de Astro para obtener la documentación completa de Astro. Es posible que tu pregunta se responda comprendiendo cómo funciona Astro en general, debajo de este tema Starlight.

También puedes revisar cualquier problema conocido de Starlight en GitHub y obtener ayuda en el Discord de Astro de nuestra activa y amigable comunidad. ¡Publica preguntas en nuestro foro #support con la etiqueta "starlight" o visita nuestro canal dedicado #starlight para discutir el desarrollo actual y más!