Merge branch 'main' into hd-style-details

* main: (32 commits)
  i18n(pt-br): Update `getting-started.mdx` (withastro#1776)
  i18n(es): update `configuration` (withastro#1766)
  [ci] format
  Add TrueCharts to showcases (withastro#1773)
  i18n(zh-cn): Update `sidebar.mdx` (withastro#1761)
  i18n(ko-KR): update `sidebar.mdx` (withastro#1760)
  i18n(fr): update `guides/sidebar` (withastro#1758)
  test: fix Windows path separator test issues (withastro#1759)
  i18n(fr): Update `reference/configuration.mdx` from withastro#1729 (withastro#1757)
  docs: rewrite `guides/sidebar` examples to be more generic (withastro#1751)
  i18n(ja): Update community-content.mdx (withastro#1756)
  i18n(ja): Update configuration.mdx (withastro#1755)
  i18n(zh-cn): Update `configuration.mdx` (withastro#1753)
  i18n(ko-KR): update `configuration.mdx` (withastro#1752)
  docs: add caution about scripts processing when using head config (withastro#1729)
  i18n(es): update `community-content` (withastro#1740)
  i18n(pt-br): Update `resources/community-content.mdx` (withastro#1747)
  format: quick fix
  [ci] format
  [ci] format
  ...

.changeset/sweet-vans-carry.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Refactors `<ThemeSelect>` custom element logic to improve performance

.changeset/swift-files-wave.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Fixes responding to system color scheme changes when theme is `auto`

docs/src/components/showcase-sites.astro

@@ -126,4 +126,5 @@ import FluidGrid from './fluid-grid.astro';
 		href="https://docs.fontawesome.com/"
 		thumbnail="docs.fontawesome.com.png"
 	/>
+	<Card title="TrueCharts" href="https://truecharts.org/" thumbnail="truecharts.org.png" />
 </FluidGrid>

docs/src/components/sidebar-preview.astro

@@ -17,7 +17,10 @@ function makeEntries(items: SidebarConfig): SidebarEntry[] {
 			return {
 				type: 'link',
 				label: item.label,
-				href: item.link,
+				// Empty hrefs are used to represent internal links that do not exist in the Starlight
+				// docs. Using a non-existing anchor link like `#_` will not trigger a page reload or any
+				// scrolling.
+				href: item.link.length > 0 ? item.link : '#_',
 				isCurrent: false,
 				badge: item.badge,
 				attrs: item.attrs ?? {},

docs/src/content/docs/es/reference/configuration.mdx

@@ -444,6 +444,9 @@ starlight({
 });
 ```
 
+Las entradas en el `head` son convertidas directamente a elementos HTML y no pasan por el [procesamiento de script](https://docs.astro.build/es/guides/client-side-scripts/#procesamiento-de-scripts) o [estilo](https://docs.astro.build/es/guides/styling/#estilando-en-astro) de Astro.
+Si necesitas importar activos locales como scripts, estilos o imágenes, [anula el componente Head](/es/guides/overriding-components/#reusa-un-componente-integrado).
+
 #### `HeadConfig`
 
 ```ts
@@ -489,18 +492,18 @@ Si necesitas establecer variantes adicionales o favicons de respaldo, puedes agr
 
 ```js
 starlight({
-  favicon: '/images/favicon.svg'.
-  head: [
-    // Agregar un favicon ICO de respaldo para Safari.
-    {
-      tag: 'link',
-      attrs: {
-        rel: 'icon',
-        href:'/images/favicon.ico',
-        sizes: '32x32',
-      },
-    },
-  ],
+	favicon: '/images/favicon.svg',
+	head: [
+		// Agregar un favicon ICO de respaldo para Safari.
+		{
+			tag: 'link',
+			attrs: {
+				rel: 'icon',
+				href: '/images/favicon.ico',
+				sizes: '32x32',
+			},
+		},
+	],
 });
 ```
 

docs/src/content/docs/es/resources/community-content.mdx

@@ -74,6 +74,11 @@ Explora contenido producido por la comunidad mantenido por usuarios de Starlight
 		title="Publicación de documentación con Astro Starlight"
 		description="Comenzando con la documentación de Starlight."
 	/>
+	<LinkCard
+		href="https://events-3bg.pages.dev/jotter/starlight/guide/"
+		title="Habilita View Transitions"
+		description="Consigue esa apariencia SPA con el soporte de View Transitions de Bag of Tricks"
+	/>
 
 </CardGrid>
 

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

@@ -7,7 +7,7 @@ sidebar:
 
 :::tip[¡Agrega el tuyo!]
 ¿Has construido un sitio de Starlight o una herramienta para Starlight?
-¡Abre una PR agregando un enlace a esta página!
+¡[Abre una PR](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md#showcase) agregando un enlace a esta página!
 :::
 
 ## Sitios