From 0c9d9732650c8028bdcba1b1825944f3ec534ed2 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Wed, 8 Nov 2023 10:39:18 -0600 Subject: [PATCH 1/4] i18n(es): Update `frontmatter` (#1030) --- .../content/docs/es/reference/frontmatter.md | 40 +++++++++++++++---- 1 file changed, 32 insertions(+), 8 deletions(-) diff --git a/docs/src/content/docs/es/reference/frontmatter.md b/docs/src/content/docs/es/reference/frontmatter.md index 61a528327ec..b2a8cb6581b 100644 --- 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 `` personalizada o un `` 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 `` personalizada o un `` en línea. + html: string; + }; actions?: Array<{ text: string; link: string; From 5e0aed9e404281512b423548d00092e2bcdcd1e4 Mon Sep 17 00:00:00 2001 From: Vitor Ayres Date: Wed, 8 Nov 2023 21:29:07 -0300 Subject: [PATCH 2/4] i18n(pt-BR): Update `reference/frontmatter.md` (#1051) * Update frontmatter.md #280 * Update frontmatter.md * Update frontmatter.md * improve wording --- .../docs/pt-br/reference/frontmatter.md | 40 +++++++++++++++---- 1 file changed, 32 insertions(+), 8 deletions(-) diff --git a/docs/src/content/docs/pt-br/reference/frontmatter.md b/docs/src/content/docs/pt-br/reference/frontmatter.md index ed8d73d07e4..1e38930a6df 100644 --- 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 `` customizada ou um `` 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 `` personalizada ou um `` inline. + html: string; + }; actions?: Array<{ text: string; link: string; From 1c1acd386bb5f0e42eb7b7b0d77841f165907407 Mon Sep 17 00:00:00 2001 From: trueberryless <99918022+trueberryless@users.noreply.github.com> Date: Thu, 9 Nov 2023 09:54:57 +0100 Subject: [PATCH 3/4] i18n(de): Update translation of another file into German (#1057) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/de/reference/configuration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/de/reference/configuration.mdx b/docs/src/content/docs/de/reference/configuration.mdx index 306ed7dce4b..abc6711b866 100644 --- 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; + badge?: string | BadgeConfig; } & ( | { link: string; - badge?: string | BadgeConfig; attrs?: Record; } | { items: SidebarItem[]; collapsed?: boolean } From dea8490b3c4664c5e9286afa3f8cd34b2a78ee56 Mon Sep 17 00:00:00 2001 From: trueberryless <99918022+trueberryless@users.noreply.github.com> Date: Thu, 9 Nov 2023 11:29:24 +0100 Subject: [PATCH 4/4] i18n(de): Update translation of authoring-content.md into German (#1053) * i18n(de): Update translation of authoring-content.md into German * Update docs/src/content/docs/de/guides/authoring-content.md Co-authored-by: Chris Swithinbank --------- Co-authored-by: Chris Swithinbank --- docs/src/content/docs/de/guides/authoring-content.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/src/content/docs/de/guides/authoring-content.md b/docs/src/content/docs/de/guides/authoring-content.md index e376af0fa08..88ffcf85b6f 100644 --- 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.