Merge branch 'main' into patch-4

withastro · Nov 9, 2023 · 32108c9 · 32108c9
2 parents e328a3e + dea8490
commit 32108c9
Show file tree

Hide file tree

Showing 4 changed files with 69 additions and 17 deletions.
diff --git a/docs/src/content/docs/de/guides/authoring-content.md b/docs/src/content/docs/de/guides/authoring-content.md
@@ -207,3 +207,7 @@ Lange, einzeilige Codeblöcke sollten nicht umgebrochen werden. Sie sollten hori
 ## Andere allgemeine Markdown-Funktionen
 
 Starlight unterstützt alle anderen Markdown-Autorensyntaxen, wie Listen und Tabellen. Einen schnellen Überblick über alle Markdown-Syntaxelemente findest du im [Markdown Cheat Sheet von The Markdown Guide](https://www.markdownguide.org/cheat-sheet/).
+
+## Erweiterte Markdown- und MDX-Konfiguration
+
+Starlight verwendet Astros Markdown- und MDX-Renderer, der auf remark und rehype aufbaut. Du kannst eine Unterstützung für eigene Syntax und Verhalten hinzufügen, indem du `remarkPlugins` oder `rehypePlugins` in deiner Astro-Konfigurationsdatei hinzufügst. Weitere Informationen findest du unter ["Markdown konfigurieren"] (https://docs.astro.build/de/guides/markdown-content/#markdown-konfigurieren) in der Astro-Dokumentation.
diff --git a/docs/src/content/docs/de/reference/configuration.mdx b/docs/src/content/docs/de/reference/configuration.mdx
@@ -181,10 +181,10 @@ sidebar: [
 type SidebarItem = {
 	label: string;
 	translations?: Record<string, string>;
+	badge?: string | BadgeConfig;
 } & (
 	| {
 			link: string;
-			badge?: string | BadgeConfig;
 			attrs?: Record<string, string | number | boolean | undefined>;
 	  }
 	| { items: SidebarItem[]; collapsed?: boolean }

diff --git a/docs/src/content/docs/es/reference/frontmatter.md b/docs/src/content/docs/es/reference/frontmatter.md
@@ -111,20 +111,44 @@ hero:
 ---
 ```
 
+Puedes mostrar diferentes versiones de la imagen hero en los modos claro y oscuro.
+
+```md
+---
+hero:
+  image:
+    alt: Un logotipo brillante, de colores brillantes
+    dark: ../../assets/logo-dark.png
+    light: ../../assets/logo-light.png
+---
+```
+
 #### `HeroConfig`
 
 ```ts
 interface HeroConfig {
   title?: string;
   tagline?: string;
-  image?: {
-    alt?: string;
-    // Ruta relativa a una imagen en tu repositorio.
-    file?: string;
-    // HTML crudo para usar en el espacio de la imagen.
-    // Podría ser una etiqueta `<img>` personalizada o un `<svg>` en línea.
-    html?: string;
-  };
+  image?:
+    | {
+        // Ruta relativa a una imagen en tu repositorio.
+        file: string;
+        // Texto alternativo para hacer que la imagen sea accesible a la tecnología de asistencia
+        alt?: string;
+      }
+    | {
+        // Ruta relativa a una imagen en tu repositorio para usar en el modo oscuro.
+        dark: string;
+        // Ruta relativa a una imagen en tu repositorio para usar en el modo claro.
+        light: string;
+        // Texto alternativo para hacer que la imagen sea accesible a la tecnología de asistencia
+        alt?: string;
+      }
+    | {
+        // HTML crudo para usar en el espacio de la imagen.
+        // Podría ser una etiqueta `<img>` personalizada o un `<svg>` en línea.
+        html: string;
+      };
   actions?: Array<{
     text: string;
     link: string;

diff --git a/docs/src/content/docs/pt-br/reference/frontmatter.md b/docs/src/content/docs/pt-br/reference/frontmatter.md
@@ -111,20 +111,44 @@ hero:
 ---
 ```
 
+Você pode exibir diferentes versões da imagem hero no modo claro e escuro.
+
+```md
+---
+hero:
+  image:
+    alt: Um logo brilhante e colorido
+    dark: ../../assets/logo-escuro.png
+    light: ../../assets/logo-claro.png
+---
+```
+
 #### `HeroConfig`
 
 ```ts
 interface HeroConfig {
   title?: string;
   tagline?: string;
-  image?: {
-    alt?: string;
-    // Caminho relativo a uma imagem no seu repositório.
-    file?: string;
-    // HTML bruto para utilizar no slot de imagem.
-    // Pode ser uma tag `<img>` customizada ou um `<svg>` inline.
-    html?: string;
-  };
+  image?:
+    | {
+        // Caminho relativo de uma imagem no seu repositório.
+        file: string;
+        // Texto alternativo para tornar a imagem acessível à tecnologia assistiva
+        alt?: string;
+      }
+    | {
+        // Caminho relativo de uma imagem em seu repositório para ser usada no modo escuro.
+        dark: string;
+        // Caminho relativo de uma imagem em seu repositório para ser usada no modo claro.
+        light: string;
+        // Texto alternativo para tornar a imagem acessível à tecnologia assistiva
+        alt?: string;
+      }
+    | {
+        // HTML bruto para utilizar no slot de imagem.
+        // Pode ser uma tag `<img>` personalizada ou um `<svg>` inline.
+        html: string;
+      };
   actions?: Array<{
     text: string;
     link: string;