From 766e8754b798960056c2729f9d28b045dd4f6e3e Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 02:34:22 -0600 Subject: [PATCH 1/4] i18n(es): translate `reference/icons` (#2409) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/reference/icons.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/src/content/docs/es/reference/icons.mdx diff --git a/docs/src/content/docs/es/reference/icons.mdx b/docs/src/content/docs/es/reference/icons.mdx new file mode 100644 index 00000000000..1b1b3406079 --- /dev/null +++ b/docs/src/content/docs/es/reference/icons.mdx @@ -0,0 +1,19 @@ +--- +title: Referencia de iconos +description: Una descripción general de todos los iconos disponibles en Starlight. +--- + +Starlight proporciona un conjunto de iconos integrados que puedes mostrar en tu contenido usando el componente ``. + +## Usar iconos + +Los iconos se pueden mostrar usando el componente [``](/es/components/icons/). +Estos también se utilizan a menudo en otros componentes, como [tarjetas](/es/components/cards/) o configuraciones como [acciones de hero](/es/reference/frontmatter/#hero). + +## Todos los iconos + +Una lista de todos los iconos disponibles se muestra a continuación con sus nombres asociados. Haz clic en un icono para copiar su nombre al portapapeles. + +import IconsList from '~/components/icons-list.astro'; + + From 2ba048f9abc931b2d789171fd94335fb900abdf3 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 02:45:25 -0600 Subject: [PATCH 2/4] i18n(es): translate `link-cards` (#2411) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../content/docs/es/components/link-cards.mdx | 128 ++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 docs/src/content/docs/es/components/link-cards.mdx diff --git a/docs/src/content/docs/es/components/link-cards.mdx b/docs/src/content/docs/es/components/link-cards.mdx new file mode 100644 index 00000000000..b92db5ab65b --- /dev/null +++ b/docs/src/content/docs/es/components/link-cards.mdx @@ -0,0 +1,128 @@ +--- +title: Tarjetas de enlace +description: Aprende a mostrar enlaces de forma destacada como tarjetas en Starlight. +sidebar: + order: 3 +--- + +import { LinkCard } from '@astrojs/starlight/components'; + +Para mostrar enlaces a diferentes páginas de forma destacada, utiliza el componente ``. + +import Preview from '~/components/component-preview.astro'; + + + + + + + +## Importación + +```tsx +import { LinkCard } from '@astrojs/starlight/components'; +``` + +## Uso + +Mostrar un enlace de forma destacada utilizando el componente ``. +Cada `` requiere un atributo [`title`](#title) y un atributo [`href`](#href). + + + +```mdx +import { LinkCard } from '@astrojs/starlight/components'; + + +``` + + + +```markdoc +{% linkcard title="Creación de contenido en Markdown" href="/es/guides/authoring-content/" /%} +``` + + + + + + + +### Agregar una descripción de enlace + +Agrega una descripción breve a una tarjeta de enlace utilizando el atributo [`description`](#description). + + + +```mdx {6} +import { LinkCard } from '@astrojs/starlight/components'; + + +``` + + + +```markdoc {4} +{% linkcard + title="Internacionalización" + href="/es/guides/i18n/" + description="Configura Starlight para admitir varios idiomas." /%} +``` + + + + + + + +### Agrupar tarjetas de enlace + +Muestra varias tarjetas de enlace una al lado de la otra cuando hay suficiente espacio agrupándolas con el componente [``](/es/components/card-grids/). +Ve la guía [“Agrupar tarjetas de enlace”](/es/components/card-grids/#agrupar-tarjetas) para un ejemplo. + +## Props de `` + +**Implementación:** [`LinkCard.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkCard.astro) + +El componente `` acepta las siguientes propiedades, así como todos los demás atributos de los elementos [``](https://developer.mozilla.org/es/docs/Web/HTML/Element/a): + +### `title` + +**requerido** +**tipo:** `string` + +El título de la tarjeta de enlace a mostrar. + +### `href` + +**requerido** +**tipo:** `string` + +El URL al que enlazar cuando se interactúa con la tarjeta. + +### `description` + +**tipo:** `string` + +Una descripción opcional para mostrar debajo del título. From f7b15091af8254a74ecafbeb5c40713b96627dea Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 03:13:22 -0600 Subject: [PATCH 3/4] i18n(es): translate `link-buttons` (#2410) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../docs/es/components/link-buttons.mdx | 145 ++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 docs/src/content/docs/es/components/link-buttons.mdx diff --git a/docs/src/content/docs/es/components/link-buttons.mdx b/docs/src/content/docs/es/components/link-buttons.mdx new file mode 100644 index 00000000000..62599b0d6ad --- /dev/null +++ b/docs/src/content/docs/es/components/link-buttons.mdx @@ -0,0 +1,145 @@ +--- +title: Botones de enlace +description: Aprende a crear botones de enlace en Starlight para enlaces de llamada a la acción visualmente distintos. +--- + +import { LinkButton } from '@astrojs/starlight/components'; + +Para mostrar enlaces de llamada a la acción visualmente distintos, usa el componente ``. + +import Preview from '~/components/component-preview.astro'; + + + + + Lee la documentación + + + + +## Importación + +```tsx +import { LinkButton } from '@astrojs/starlight/components'; +``` + +## Uso + +Usa el componente `` para mostrar un enlace de llamada a la acción visualmente distinto. +Un botón de enlace es útil para dirigir a los usuarios al contenido más relevante o accionable y se usa a menudo en páginas de destino. + +Un `` requiere un atributo [`href`](#href). +Opcionalmente, personaliza la apariencia del botón de enlace usando el atributo [`variant`](#variant), que se puede establecer en `primary` (el valor predeterminado), `secondary` o `minimal`. + + + +```mdx +import { LinkButton } from '@astrojs/starlight/components'; + +Comienza + + Referencia de configuración + +``` + + + +```markdoc +{% linkbutton href="/es/getting-started/" %}Comienza{% /linkbutton %} + +{% linkbutton href="/es/reference/configuration/" variant="secondary" %} +Referencia de configuración +{% /linkbutton %} +``` + + + + + Comienza + + Referencia de configuración + + + + + +### Agregar iconos a los botones de enlace + +Incluye un icono en un botón de enlace usando el atributo [`icon`](#icon) establecido en el nombre de [uno de los iconos integrados de Starlight](/es/reference/icons/#todos-los-iconos). + +El atributo [`iconPlacement`](#iconplacement) se puede usar para colocar el icono antes del texto estableciéndolo en `start` (el valor predeterminado es `end`). + + + +```mdx {6-7} +import { LinkButton } from '@astrojs/starlight/components'; + + + Relacionado: Astro + +``` + + + +```markdoc {4-5} +{% linkbutton + href="https://docs.astro.build" + variant="secondary" + icon="external" + iconPlacement="start" %} +Relacionado: Astro +{% /linkbutton %} +``` + + + + + Relacionado: Astro + + + + +## Props de `` + +**Implementación:** [`LinkButton.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkButton.astro) + +El componente `` acepta las siguientes props y también cualquier [otro atributo ``](https://developer.mozilla.org/es/docs/Web/HTML/Element/a): + +### `href` + +**requerido** +**tipo:** `string` + +El URL al que apunta el botón de enlace. + +### `variant` + +**tipo:** `'primary' | 'secondary' | 'minimal'` +**por defecto:** `'primary'` + +La apariencia del botón de enlace. +Establece `primary` para un enlace de llamada a la acción prominente que usa el color de acento del tema, `secondary` para un enlace menos prominente o `minimal` para un enlace con un estilo mínimo. + +### `icon` + +**tipo:** `string` + +Un botón de enlace puede incluir un atributo `icon` establecido en el nombre de [uno de los iconos integrados de Starlight](/es/reference/icons/#todos-los-iconos). + +### `iconPlacement` + +**tipo:** `'start' | 'end'` +**por defecto:** `'end'` + +Determina la ubicación del icono en relación con el texto del botón de enlace. From 295100df03b4ea144350049422047458642fc22e Mon Sep 17 00:00:00 2001 From: Nin3 <30520689+Nin3lee@users.noreply.github.com> Date: Thu, 26 Sep 2024 17:21:26 +0800 Subject: [PATCH 4/4] i18n(zh-cn): Update `index.mdx` (#2413) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>