Starlight es el paquete oficial de Astro para construir sitios web de documentación rápidos y accesibles, con todas las funciones que necesitas integradas.
Aquí está lo nuevo en este lanzamiento:
- Enlaces autogenerados de la barra lateral más flexibles
- Mejoras de estilos
- Funciones para sitios multilingües
Para actualizar un sitio existente de Starlight, usa la herramienta CLI automatizada @astrojs/upgrade. Esto actualizará Starlight, Astro y cualquier otra integración que estés usando:
npx @astrojs/upgradeConsulta el CHANGELOG de Starlight para la guía de migración y todos los detalles de los cambios disruptivos.
Autogeneración flexible de barra lateral
Starlight ha incluido soporte para generar enlaces de navegación de la barra lateral desde directorios de contenido desde el primer día. Este lanzamiento trae nueva flexibilidad a cómo funciona esto.
Anteriormente, la autogeneración siempre creaba un grupo etiquetado en la barra lateral para el directorio especificado. Con v0.39, los enlaces autogenerados de Starlight pueden colocarse junto a cualquier otro tipo de enlace.
Si tienes grupos de enlaces autogenerados existentes en tu barra lateral, actualízalos envolviendo la configuración en un array items:
starlight({ sidebar: [ { label: 'My group', autogenerate: { directory: 'some-dir' }, items: [{ autogenerate: { directory: 'some-dir' } }], }, ], // ...}),Este cambio facilita combinar la autogeneración con diferentes tipos de enlaces.
Por ejemplo, ahora puedes añadir enlaces personalizados puntuales junto a los autogenerados.
El siguiente ejemplo agrupa una página local, todas las páginas en el directorio features y un enlace externo:
starlight({ sidebar: [ { label: 'Features', items: [ // A page not in the features directory 'features-overview', // All pages in the features directory { autogenerate: { directory: 'features' } }, // An external link { label: 'Support', link: 'https://support.example.com' }, ], }, ], // ...}),Mejoras de estilos
El CSS moderno hace la vida de todos más fácil cada día, y con este lanzamiento le estamos dando buen uso.
- Hemos mejorado el espaciado de listas anidadas en tu contenido gracias a la magia de
:has(). (Echa un vistazo al selector completo — es una belleza.) - Cuando los usuarios expanden o colapsan un grupo de la barra lateral, causando desbordamiento, la barra lateral de Starlight ahora es más estable. Desterramos el desplazamiento de diseño con un simple
scrollbar-gutter: stable.
Mejores sitios multilingües
La historia de internacionalización de Starlight ha sido clave desde el principio, y siempre estamos buscando impulsarla. Este lanzamiento trae:
- SEO multilingüe mejorado con meta enlaces
x-defaulta páginas en el idioma por defecto del sitio. Estos enlaces alternativos son usados por los motores de búsqueda como señal de a qué idioma recurrir si no hay otro disponible. - Mejor diseño de texto en documentación en chino y japonés gracias a la propiedad CSS
text-autospace. Esta propiedad CSS más reciente hace el texto más legible aplicando automáticamente espaciado entre caracteres CJK y no-CJK. - Hemos actualizado
i18next, la biblioteca subyacente que impulsa las APIs de localización de Starlight, de v23 a v26.
Comunidad
El core team de Astro es:
Alexander Niebuhr , Armand Philippot , Chris Swithinbank , Emanuele Stoppa , Erika , Florian Lefebvre , Fred Schott , HiDeoo , Luiz Ferraz , Matt Kane , Matthew Phillips , Reuben Tier , Sarah Rainsberger , and Yan Thomas .
Gracias a todos los que contribuyeron a nuestros lanzamientos recientes con PRs y revisiones, incluyendo a alomtvassam-ui, Andreas Deininger, Andriy Massimilla, Bugo, Elian, Felix Schneider, gesslar, Ian Trewella, John Goodliff, Joost de Valk, Josef Ježek, Junseong Park, Kevin Z, Linus Grolmes, Luke Hsiao, Maxime Mangel, MilesChou, Patrick Schratz, Paweł Cisło, Roman, Sakku, Shinya Fujino, Swapnil Jain, Tatsunori Uchino, vincent, Vojtěch Křižan y Woody Chang.
¡Esperamos ver qué construyes con Starlight! Si tienes preguntas, comentarios o solo quieres saludar, pásate por el Discord de Astro.