From 0267c1c8baf255a6d9c20bd912d3780d9034a47e Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:07:28 +0200 Subject: [PATCH 01/15] i18n(fr): update `guides/components` and add `syncKey` to various pages (#1797) Co-authored-by: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> --- docs/src/content/docs/fr/getting-started.mdx | 6 +-- .../src/content/docs/fr/guides/components.mdx | 45 +++++++++++++++++++ .../docs/fr/guides/css-and-tailwind.mdx | 6 +-- .../content/docs/fr/guides/customization.mdx | 4 +- 4 files changed, 53 insertions(+), 8 deletions(-) diff --git a/docs/src/content/docs/fr/getting-started.mdx b/docs/src/content/docs/fr/getting-started.mdx index 4c38de663f3..7c00093bbde 100644 --- a/docs/src/content/docs/fr/getting-started.mdx +++ b/docs/src/content/docs/fr/getting-started.mdx @@ -15,7 +15,7 @@ Consultez les [instructions d'installation manuelle](/fr/manual-setup/) pour ajo Créez un nouveau projet Astro + Starlight en lançant la commande suivante dans votre terminal : - + ```sh @@ -52,7 +52,7 @@ Lorsque vous travaillez localement, [le serveur de développement d'Astro](https À l'intérieur du répertoire de votre projet, exécutez la commande suivante pour démarrer le serveur de développement : - + ```sh @@ -103,7 +103,7 @@ Assurez-vous de mettre à jour Starlight régulièrement ! Starlight est une intégration Astro. Vous pouvez la mettre à jour ainsi que tous autres packages Astro en exécutant la commande suivante dans votre terminal : - + ```sh diff --git a/docs/src/content/docs/fr/guides/components.mdx b/docs/src/content/docs/fr/guides/components.mdx index e9e13b4a970..94f5e93fdf3 100644 --- a/docs/src/content/docs/fr/guides/components.mdx +++ b/docs/src/content/docs/fr/guides/components.mdx @@ -87,6 +87,51 @@ Le code ci-dessus génère les onglets suivants sur la page : +#### Onglets synchronisés + +Conservez plusieurs groupes d'onglets synchronisés en ajoutant l'attribut `syncKey`. + +Tous les composants `` sur une page avec la même valeur `syncKey` afficheront le même label actif. +Cela permet à votre lecteur de choisir une fois (par exemple, leur système d'exploitation ou leur gestionnaire de paquets) et de voir leur choix reflété sur l'ensemble de la page. + +Pour synchroniser des onglets liés, ajoutez une propriété `syncKey` identique à chaque composant `` et assurez-vous qu'ils utilisent tous les mêmes libellés de `` : + +```mdx 'syncKey="constellations"' +# src/content/docs/exemple.mdx + +import { Tabs, TabItem } from '@astrojs/starlight/components'; + +_Quelques étoiles :_ + + + Bellatrix, Rigel, Bételgeuse + Pollux, Castor A, Castor B + + +_Quelques exoplanètes :_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + +``` + +Le code ci-dessus génère les onglets suivants sur la page : + +_Quelques étoiles :_ + + + Bellatrix, Rigel, Bételgeuse + Pollux, Castor A, Castor B + + +_Quelques exoplanètes :_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + + ### Cartes import { Card, CardGrid } from '@astrojs/starlight/components'; diff --git a/docs/src/content/docs/fr/guides/css-and-tailwind.mdx b/docs/src/content/docs/fr/guides/css-and-tailwind.mdx index 2a2da0fd59a..63f34201198 100644 --- a/docs/src/content/docs/fr/guides/css-and-tailwind.mdx +++ b/docs/src/content/docs/fr/guides/css-and-tailwind.mdx @@ -63,7 +63,7 @@ Le module d'extension Tailwind de Starlight applique la configuration suivante : Démarrez un nouveau projet Starlight avec Tailwind CSS préconfiguré en utilisant `create astro` : - + ```sh @@ -95,7 +95,7 @@ Si vous avez déjà un site Starlight et que vous souhaitez ajouter Tailwind CSS 1. Ajoutez l'intégration Astro pour Tailwind : - + @@ -125,7 +125,7 @@ Si vous avez déjà un site Starlight et que vous souhaitez ajouter Tailwind CSS 2. Installez le module d'extension Tailwind de Starlight : - + diff --git a/docs/src/content/docs/fr/guides/customization.mdx b/docs/src/content/docs/fr/guides/customization.mdx index efaab45ae40..f9cd3ced786 100644 --- a/docs/src/content/docs/fr/guides/customization.mdx +++ b/docs/src/content/docs/fr/guides/customization.mdx @@ -130,7 +130,7 @@ Vous pouvez personnaliser - ou même désactiver - la table des matières global Par défaut, les titres `

` et `

` sont inclus dans la table des matières. Modifiez les niveaux de titres à inclure à l’échelle du site à l’aide des options `minHeadingLevel` et `maxHeadingLevel` dans votre option de configuration [globale `tableOfContents`](/fr/reference/configuration/#tableofcontents). Remplacez ces valeurs par défaut sur une page individuelle en ajoutant les propriétés [frontmatter `tableOfContents`](/fr/reference/frontmatter/#tableofcontents) correspondantes : - + ```md {4-6} @@ -164,7 +164,7 @@ defineConfig({ Désactivez la table des matières complètement en définissant l’option `tableOfContents` à `false`: - + ```md {4} From c3c84373ceb0f34e50ba67390d96bb21b80a8c7e Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:14:26 +0200 Subject: [PATCH 02/15] i18n(fr): update `guides/i18n.mdx` (#1799) --- docs/src/content/docs/fr/guides/i18n.mdx | 28 ++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/src/content/docs/fr/guides/i18n.mdx b/docs/src/content/docs/fr/guides/i18n.mdx index a1592cdc195..e02ef168b09 100644 --- a/docs/src/content/docs/fr/guides/i18n.mdx +++ b/docs/src/content/docs/fr/guides/i18n.mdx @@ -143,6 +143,34 @@ Starlight s'attend à ce que vous créiez des pages équivalentes dans toutes vo Si une traduction n'est pas encore disponible pour une langue, Starlight affichera aux lecteurs le contenu de cette page dans la langue par défaut (définie via `defaultLocale`). Par exemple, si vous n'avez pas encore créé de version française de votre page À propos et que votre langue par défaut est l'anglais, les visiteurs de `/fr/about` verront le contenu anglais de `/en/about` avec un avis indiquant que cette page n'a pas encore été traduite. Cela vous permet d'ajouter du contenu dans votre langue par défaut et de le traduire progressivement lorsque vos traducteurs en ont le temps. +## Traduire le titre du site + +Par défaut, Starlight utilisera le même titre de site pour toutes les langues. +Si vous avez besoin de personnaliser le titre pour chaque langue, vous pouvez passer un objet à [`title`](/fr/reference/configuration/#title-obligatoire) dans les options de Starlight : + +```diff lang="js" +// astro.config.mjs +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; + +export default defineConfig({ + integrations: [ + starlight({ +- title: 'Ma documentation', ++ title: { ++ fr: 'Ma documentation', ++ 'zh-CN': '我的文档', ++ }, + defaultLocale: 'fr', + locales: { + fr: { label: 'Français' }, + 'zh-cn': { label: '简体中文', lang: 'zh-CN' }, + }, + }), + ], +}); +``` + ## Traduire l'interface utilisateur de Starlight import LanguagesList from '~/components/languages-list.astro'; From e13e2a86845e186952a909eb2f533e2d9d148058 Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:19:17 +0200 Subject: [PATCH 03/15] i18n(fr): update `reference/configuration.mdx` (#1801) --- .../content/docs/fr/reference/configuration.mdx | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/fr/reference/configuration.mdx b/docs/src/content/docs/fr/reference/configuration.mdx index 35e689c23bd..25a44952762 100644 --- a/docs/src/content/docs/fr/reference/configuration.mdx +++ b/docs/src/content/docs/fr/reference/configuration.mdx @@ -25,10 +25,22 @@ Vous pouvez passer les options suivantes à l'intégration `starlight`. ### `title` (obligatoire) -**Type :** `string` +**Type :** `string | Record` Définissez le titre de votre site web. Il sera utilisé dans les métadonnées et dans le titre de l'onglet du navigateur. +La valeur peut être une chaîne de caractères, ou pour les sites multilingues, un objet avec des valeurs pour chacune des différentes locales. +Lorsque vous utilisez la forme objet, les clés doivent être des étiquettes d'identification BCP-47 (par exemple `fr`, `ar`, ou `zh-CN`) : + +```ts +starlight({ + title: { + fr: 'Mon délicieux site de docs', + de: 'Meine bezaubernde Dokumentationsseite', + }, +}); +``` + ### `description` **Type :** `string` From 08e6885324710435cfb2b72b109a9b8751945cfb Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:24:29 +0200 Subject: [PATCH 04/15] i18n(fr): update `reference/frontmatter.md` (#1802) --- docs/src/content/docs/fr/reference/frontmatter.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/src/content/docs/fr/reference/frontmatter.md b/docs/src/content/docs/fr/reference/frontmatter.md index 5f8e55b0fa5..be462d60d85 100644 --- a/docs/src/content/docs/fr/reference/frontmatter.md +++ b/docs/src/content/docs/fr/reference/frontmatter.md @@ -268,6 +268,21 @@ pagefind: false --- ``` +### `draft` + +**Type :** `boolean` +**Par défaut :** `false` + +Définit si cette page doit être considérée comme une ébauche et ne pas être incluse dans les [déploiements en production](https://docs.astro.build/fr/reference/cli-reference/#astro-build) et les [groupes de liens générés automatiquement](/fr/guides/sidebar/#groupes-générés-automatiquement). Définissez la valeur à `true` pour marquer une page comme une ébauche et la rendre visible uniquement pendant le développement. + +```md +--- +# src/content/docs/exemple.md +# Exclure cette page des déploiements en production +draft: true +--- +``` + ### `sidebar` **Type :** [`SidebarConfig`](#sidebarconfig) From 21f2966a219580670f1c034cc6b8d257140e8256 Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:29:57 +0200 Subject: [PATCH 05/15] i18n(fr): update `reference/overrides.md` (#1803) --- docs/src/content/docs/fr/reference/overrides.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/fr/reference/overrides.md b/docs/src/content/docs/fr/reference/overrides.md index 1f821b7fd75..99b8e204650 100644 --- a/docs/src/content/docs/fr/reference/overrides.md +++ b/docs/src/content/docs/fr/reference/overrides.md @@ -50,6 +50,12 @@ L’étiquette d’identification BCP-47 pour la langue de la page, par exemple Le chemin de base utilisé pour servir une langue. `undefined` pour les slugs de la locale racine. +#### `siteTitle` + +**Type :** `string` + +Le titre du site pour la langue de cette page. + #### `slug` **Type :** `string` @@ -218,7 +224,7 @@ Ces composants affichent la barre de navigation supérieure de Starlight. **Composant par défaut :** [`Header.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Header.astro) Composant d'en-tête affiché en haut de chaque page. -L'implémentation par défaut affiche [``](#sitetitle), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). +L'implémentation par défaut affiche [``](#sitetitle-1), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). #### `SiteTitle` @@ -332,6 +338,12 @@ Composant contenant l'élement `

` de la page courante. Les implémentations personnalisées doivent s'assurer qu'elles définissent `id="_top"` sur l'élément `

` comme dans l'implémentation par défaut. +#### `DraftContentNotice` + +**Composant par défaut :** [`DraftContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/DraftContentNotice.astro) + +Note affichée aux utilisateurs durant le développement lorsque la page actuelle est marquée comme une ébauche. + #### `FallbackContentNotice` **Composant par défaut :** [`FallbackContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/FallbackContentNotice.astro) From c94ec1f683bcd0f7e6395572b436c278bf5ac257 Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 2 May 2024 09:34:51 +0200 Subject: [PATCH 06/15] i18n(fr): update `guides/pages.mdx` (#1800) --- docs/src/content/docs/fr/guides/pages.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/src/content/docs/fr/guides/pages.mdx b/docs/src/content/docs/fr/guides/pages.mdx index d784f74ca37..047b9fefdd4 100644 --- a/docs/src/content/docs/fr/guides/pages.mdx +++ b/docs/src/content/docs/fr/guides/pages.mdx @@ -105,6 +105,7 @@ Les propriétés suivantes diffèrent du frontmatter en Markdown : - La propriété [`slug`](/fr/reference/frontmatter/#slug) n'est pas supportée et est automatiquement définie en fonction de l'URL de la page personnalisée. - L'option [`editUrl`](/fr/reference/frontmatter/#editurl) nécessite une URL pour afficher un lien d'édition. - La propriété [`sidebar`](/fr/reference/frontmatter/#sidebar) du frontmatter permettant de personnaliser l'affichage de la page dans les [groupes de liens autogénérés](/fr/reference/configuration/#sidebar) n'est pas disponible. Les pages utilisant le composant `` ne font pas partie d'une collection et ne peuvent pas être ajoutées à un groupe de liens autogénérés. +- L'option [`draft`](/fr/reference/frontmatter/#draft) affiche uniquement une [note](/fr/reference/overrides/#draftcontentnotice) indiquant que la page est une ébauche, mais ne l'exclut pas automatiquement des déploiements en production. ##### `sidebar` From 57141654dc37236ffd951c926fff50c89116f5b8 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 01:42:36 -0600 Subject: [PATCH 07/15] i18n(es): update `frontmatter` (#1819) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/reference/frontmatter.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/src/content/docs/es/reference/frontmatter.md b/docs/src/content/docs/es/reference/frontmatter.md index ddc07b2bc89..f7645f786d5 100644 --- a/docs/src/content/docs/es/reference/frontmatter.md +++ b/docs/src/content/docs/es/reference/frontmatter.md @@ -270,6 +270,21 @@ pagefind: false --- ``` +### `draft` + +**tipo:** `boolean` +**por defecto:** `false` + +Establece si esta página debe considerarse como un borrador y no incluirse en las [compilaciones de producción](https://docs.astro.build/es/reference/cli-reference/#astro-build) y [grupos de enlaces autogenerados](/es/guides/sidebar/#grupos-autogenerados). Establece en `true` para marcar una página como borrador y hacerla visible solo durante el desarrollo. + +```md +--- +# src/content/docs/example.md +# Excluye esta página de las compilaciones de producción +draft: true +--- +``` + ### `sidebar` **tipo:** [`SidebarConfig`](#sidebarconfig) From e39bef2f8527aa819343a7a501259a27bc9071c6 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 01:57:56 -0600 Subject: [PATCH 08/15] i18n(es): update `configuration` (#1821) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../content/docs/es/reference/configuration.mdx | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/es/reference/configuration.mdx b/docs/src/content/docs/es/reference/configuration.mdx index 460980f516d..2f0981ac445 100644 --- a/docs/src/content/docs/es/reference/configuration.mdx +++ b/docs/src/content/docs/es/reference/configuration.mdx @@ -24,10 +24,22 @@ Puedes pasar las siguientes opciones a la integración `starlight`. ### `title` (requerido) -**tipo:** `string` +**tipo:** `string | Record` Establece el título de tu sitio web. Se utilizará en los metadatos y en el título de la pestaña del navegador. +El valor puede ser un string o para sitios multilingües, un objeto con valores para cada idioma diferente. +Cuando se usa la forma de objeto, las claves deben ser etiquetas BCP-47 (por ejemplo, `en`, `ar` o `zh-CN`): + +```ts +starlight({ + title: { + es: 'Mi encantador sitio de documentación', + de: 'Meine bezaubernde Dokumentationsseite', + }, +}); +``` + ### `description` **tipo:** `string` From d0a82589bcbecc7330f739121ed197614e016f68 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 02:06:48 -0600 Subject: [PATCH 09/15] i18n(es): update `community-content` (#1824) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/resources/community-content.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/src/content/docs/es/resources/community-content.mdx b/docs/src/content/docs/es/resources/community-content.mdx index 1cd5a3b5356..5971c63c938 100644 --- a/docs/src/content/docs/es/resources/community-content.mdx +++ b/docs/src/content/docs/es/resources/community-content.mdx @@ -128,5 +128,11 @@ import YouTubeGrid from '~/components/youtube-grid.astro'; description: 'Pon en marcha un nuevo sitio de Starlight en unos 5 minutos', }, + { + href: 'https://www.youtube.com/watch?v=12o7WxjAxjM', + title: 'Incluye la documentación de Starlight en un proyecto de Next.js con proxies', + description: + 'Configura Starlight como un proyecto de subdirectorio dentro de un sitio web de Next.js', + }, ]} /> From dff9da6d0080e577583cd68314af033eca3bffa0 Mon Sep 17 00:00:00 2001 From: HiDeoo Date: Thu, 2 May 2024 08:07:28 +0000 Subject: [PATCH 10/15] [ci] format --- docs/src/content/docs/es/resources/community-content.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/es/resources/community-content.mdx b/docs/src/content/docs/es/resources/community-content.mdx index 5971c63c938..5ec55f26910 100644 --- a/docs/src/content/docs/es/resources/community-content.mdx +++ b/docs/src/content/docs/es/resources/community-content.mdx @@ -130,7 +130,8 @@ import YouTubeGrid from '~/components/youtube-grid.astro'; }, { href: 'https://www.youtube.com/watch?v=12o7WxjAxjM', - title: 'Incluye la documentación de Starlight en un proyecto de Next.js con proxies', + title: + 'Incluye la documentación de Starlight en un proyecto de Next.js con proxies', description: 'Configura Starlight como un proyecto de subdirectorio dentro de un sitio web de Next.js', }, From fcc3e56147eb7a939b9c2994ce90032456103e7f Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 02:14:56 -0600 Subject: [PATCH 11/15] i18n(es): update `guides/components` and add `syncKey` to various pages (#1818) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/getting-started.mdx | 6 +-- .../src/content/docs/es/guides/components.mdx | 44 +++++++++++++++++++ .../docs/es/guides/css-and-tailwind.mdx | 6 +-- .../content/docs/es/guides/customization.mdx | 4 +- 4 files changed, 52 insertions(+), 8 deletions(-) diff --git a/docs/src/content/docs/es/getting-started.mdx b/docs/src/content/docs/es/getting-started.mdx index dbe79dd7c89..5ac0e3356f8 100644 --- a/docs/src/content/docs/es/getting-started.mdx +++ b/docs/src/content/docs/es/getting-started.mdx @@ -15,7 +15,7 @@ Consulta las [instrucciones de configuración manual](/es/manual-setup/) para ag Crea un nuevo proyecto de Astro + Starlight ejecutando el siguiente comando en tu terminal: - + ```sh @@ -52,7 +52,7 @@ Cuando trabajas localmente, el [servidor de desarrollo de Astro](https://docs.as Dentro del directorio de tu proyecto, ejecuta el siguiente comando para iniciar el servidor de desarrollo: - + ```sh @@ -103,7 +103,7 @@ Debido a que Starlight es un software beta, habrá actualizaciones y mejoras fre Starlight es una integración Astro. Puedes actualizarlo y otros paquetes de Astro ejecutando el siguiente comando en tu terminal: - + ```sh diff --git a/docs/src/content/docs/es/guides/components.mdx b/docs/src/content/docs/es/guides/components.mdx index 9072b8d9cfc..71e6249cd85 100644 --- a/docs/src/content/docs/es/guides/components.mdx +++ b/docs/src/content/docs/es/guides/components.mdx @@ -84,6 +84,50 @@ El código anterior genera las siguientes pestañas en la página: +#### Pestañas sincronizadas + +Manten varias pestañas sincronizadas añadiendo el atributo `syncKey`. + +Todas las `` en una página con el mismo valor de `syncKey` mostrarán la misma etiqueta activa. Esto permite a tu lector elegir una vez (por ejemplo, su sistema operativo o gestor de paquetes) y ver su elección reflejada en toda la página. + +Para sincronizar pestañas relacionadas, añade una propiedad `syncKey` idéntica a cada componente `` y asegúrate de que todos usen las mismas etiquetas ``: + +```mdx 'syncKey="constellations"' +# src/content/docs/example.mdx + +import { Tabs, TabItem } from '@astrojs/starlight/components'; + +_Algunas estrellas:_ + + + Bellatrix, Rigel, Betelgeuse + Pollux, Cástor A, Cástor B + + +_Algunos exoplanetas:_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + +``` + +El código anterior genera lo siguiente en la página: + +_Algunas estrellas:_ + + + Bellatrix, Rigel, Betelgeuse + Pollux, Cástor A, Cástor B + + +_Algunos exoplanetas:_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + + ### Tarjetas import { Card, CardGrid } from '@astrojs/starlight/components'; diff --git a/docs/src/content/docs/es/guides/css-and-tailwind.mdx b/docs/src/content/docs/es/guides/css-and-tailwind.mdx index b3ef9449b07..418d67b92bc 100644 --- a/docs/src/content/docs/es/guides/css-and-tailwind.mdx +++ b/docs/src/content/docs/es/guides/css-and-tailwind.mdx @@ -63,7 +63,7 @@ El plugin Starlight Tailwind aplica la siguiente configuración: Empieza un nuevo proyecto en Starlight con Tailwind CSS preconfigurado usando `create astro`: - + ```sh @@ -95,7 +95,7 @@ Si ya tienes un sitio en Starlight y quieres agregar Tailwind CSS, sigue estos p 1. Agrega la integración de Tailwind de Astro: - + @@ -125,7 +125,7 @@ Si ya tienes un sitio en Starlight y quieres agregar Tailwind CSS, sigue estos p 2. Instala el plugin Starlight Tailwind: - + diff --git a/docs/src/content/docs/es/guides/customization.mdx b/docs/src/content/docs/es/guides/customization.mdx index 8ac23cfaf1e..67f40b04ad6 100644 --- a/docs/src/content/docs/es/guides/customization.mdx +++ b/docs/src/content/docs/es/guides/customization.mdx @@ -127,7 +127,7 @@ Starlight muestra una tabla de contenidos en cada página para facilitar que los De forma predeterminada, los encabezados `

` y `

` se incluyen en la tabla de contenidos. Puedes cambiar qué niveles de encabezados se incluyen en toda la página utilizando las opciones `minHeadingLevel` y `maxHeadingLevel` en tu configuración [global de `tableOfContents`](/es/reference/configuration/#tableofcontents). Puedes anular estas configuraciones predeterminadas en una página individual agregando las propiedades correspondientes de [`tableOfContents` en el frontmatter](/es/reference/frontmatter/#tableofcontents): - + ```md {4-6} @@ -161,7 +161,7 @@ defineConfig({ Desactiva completamente la tabla de contenidos estableciendo la opción `tableOfContents` en `false`: - + ```md {4} From e1190d22dda7c58a450ea1d9495541d28d21e8bf Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 02:19:44 -0600 Subject: [PATCH 12/15] i18n(es): updates `overrides` (#1820) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/reference/overrides.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/es/reference/overrides.md b/docs/src/content/docs/es/reference/overrides.md index 4f036c372d7..9e6806a86f8 100644 --- a/docs/src/content/docs/es/reference/overrides.md +++ b/docs/src/content/docs/es/reference/overrides.md @@ -51,6 +51,12 @@ Etiqueta de idioma BCP-47 para la configuración regional de esta página, por e La ruta base en la que se sirve un idioma. `undefined` para los slugs de idioma raíz. +#### `siteTitle` + +**Tipo:** `string` + +El título del sitio para el idioma de esta página. + #### `slug` **Tipo:** `string` @@ -219,7 +225,7 @@ Estos componentes renderizan la barra de navegación superior de Starlight. **Componente por defecto:** [`Header.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Header.astro) Componente de encabezado que se muestra en la parte superior de cada página. -La implementación predeterminada muestra [``](#sitetitle), [``](#search), [``](#socialicons), [``](#themeselect) y [``](#languageselect). +La implementación predeterminada muestra [``](#sitetitle-1), [``](#search), [``](#socialicons), [``](#themeselect) y [``](#languageselect). #### `SiteTitle` @@ -331,6 +337,12 @@ Componente que contiene el elemento `

` de la página actual. Las implementaciones deben asegurarse de establecer `id="_top"` en el elemento `

` como en la implementación predeterminada. +#### `DraftContentNotice` + +**Componente por defecto:** [`DraftContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/DraftContentNotice.astro) + +Aviso mostrado a los usuarios durante el desarrollo cuando la página actual está marcada como borrador. + #### `FallbackContentNotice` **Componente por defecto:** [`FallbackContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/FallbackContentNotice.astro) From b7b592fea585a027f5f507a4ab56d69c860db5de Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 02:25:34 -0600 Subject: [PATCH 13/15] i18n(es): update `i18n` (#1822) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/guides/i18n.mdx | 28 ++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/src/content/docs/es/guides/i18n.mdx b/docs/src/content/docs/es/guides/i18n.mdx index 8e86ff5784d..05227db1096 100644 --- a/docs/src/content/docs/es/guides/i18n.mdx +++ b/docs/src/content/docs/es/guides/i18n.mdx @@ -142,6 +142,34 @@ Starlight espera que crees páginas equivalentes en todos tus idiomas. Por ejemp Si no hay una traducción disponible para un idioma, Starlight mostrará a los lectores el contenido de esa página en el idioma predeterminado (establecido mediante `defaultLocale`). Por ejemplo, si aún no has creado una versión en francés de tu página Acerca de y tu idioma predeterminado es el inglés, los visitantes a `/fr/about` verán el contenido en inglés de `/en/about` con un aviso de que esta página aún no se ha traducido. Esto te ayuda a agregar contenido en tu idioma predeterminado y luego traducirlo progresivamente cuando tus traductores tengan tiempo. +## Traduce el título del sitio + +Por defecto, Starlight usará el mismo título del sitio para todos los idiomas. +Si necesitas personalizar el título para cada idioma, puedes pasar un objeto a [`title`](/es/reference/configuration/#title-requerido) en las opciones de Starlight: + +```diff lang="js" +// astro.config.mjs +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; + +export default defineConfig({ + integrations: [ + starlight({ +- title: 'Mi Documentación', ++ title: { ++ es: 'Mi Documentación', ++ 'zh-CN': '我的文档', ++ }, + defaultLocale: 'es', + locales: { + es: { label: 'Español' }, + 'zh-cn': { label: '简体中文', lang: 'zh-CN' }, + }, + }), + ], +}); +``` + ## Traduce la UI de Starlight import LanguagesList from '~/components/languages-list.astro'; From 868a889db63800f8823ddd4d0dafc03a5cfe4202 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 2 May 2024 02:30:41 -0600 Subject: [PATCH 14/15] i18n(es): updates `pages` (#1823) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/guides/pages.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/src/content/docs/es/guides/pages.mdx b/docs/src/content/docs/es/guides/pages.mdx index 9ff7d8a946a..7506a490759 100644 --- a/docs/src/content/docs/es/guides/pages.mdx +++ b/docs/src/content/docs/es/guides/pages.mdx @@ -105,6 +105,7 @@ Las siguientes propiedades difieren del frontmatter de Markdown: - La propiedad [`slug`](/es/reference/frontmatter/#slug) no es compatible y se establece automáticamente en función de la URL de la página personalizada. - La opción [`editUrl`](/es/reference/frontmatter/#editurl) requiere una URL para mostrar un enlace de edición. - La propiedad frontmatter [`sidebar`](/es/reference/frontmatter/#sidebar) para personalizar cómo aparece la página en [grupos de enlaces autogenerados](/es/reference/configuration/#sidebar) no está disponible. Las páginas que utilizan el componente `` no forman parte de una colección y no pueden ser agregadas a un grupo de barra lateral autogenerado. +- La opción [`draft`](/es/reference/frontmatter/#draft) solo muestra un [aviso](/es/reference/overrides/#draftcontentnotice) de que la página es un borrador, pero no la excluye automáticamente de las compilaciones de producción. ##### `sidebar` From b824f50ff5c7eb07440bea72da1b801f9bebf847 Mon Sep 17 00:00:00 2001 From: Eduardo Pereira Date: Thu, 2 May 2024 06:14:10 -0300 Subject: [PATCH 15/15] i18n(pt-BR): Update `css-and-tailwind.mdx` (#1817) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../docs/pt-br/guides/css-and-tailwind.mdx | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/docs/src/content/docs/pt-br/guides/css-and-tailwind.mdx b/docs/src/content/docs/pt-br/guides/css-and-tailwind.mdx index 7cb17ba2453..03deede51f1 100644 --- a/docs/src/content/docs/pt-br/guides/css-and-tailwind.mdx +++ b/docs/src/content/docs/pt-br/guides/css-and-tailwind.mdx @@ -3,12 +3,16 @@ title: CSS e Estilização description: Aprenda como estilizar seu site Starlight com CSS customizado ou integrá-lo com Tailwind CSS. --- +import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'; + Você pode estilizar seu site Starlight com arquivos CSS customizados ou utilizar o plugin Starlight Tailwind. ## Estilos CSS customizados Customize os estilos aplicados ao seu site Starlight ao fornecer arquivos CSS adicionais para modificar ou estender os estilos padrões do Starlight. + + 1. Adicione um arquivo CSS ao seu diretório `src/`. Por exemplo, você poderia definir uma largura padrão de coluna mais larga e um tamanho de texto maior para títulos da página: @@ -40,6 +44,8 @@ Customize os estilos aplicados ao seu site Starlight ao fornecer arquivos CSS ad }); ``` + + Você pode ver todas as propriedades CSS customizadas utilizadas pelo Starlight que você pode definir para customizar o seu site no [arquivo `props.css` no GitHub](https://github.com/withastro/starlight/blob/main/packages/starlight/style/props.css). ## Tailwind CSS @@ -51,15 +57,13 @@ O plugin Starlight Tailwind plugin aplica a seguinte configuração: - Configura as variantes `dark:` do Tailwind para funcionarem com o modo escuro do Starlight. - Utiliza [cores de tema e fontes](#estilizando-starlight-com-tailwind) do Tailwind na UI do Starlight. -- Desabilita os estilos de reset [Preflight](https://tailwindcss.com/docs/preflight) do Tailwind enquanto seletivamente restora partes essenciais do Preflight necessárias para o as classes utilitárias de borda do Tailwind. +- Desabilita os estilos de reset [Preflight](https://tailwindcss.com/docs/preflight) do Tailwind enquanto seletivamente restaura partes essenciais do Preflight necessárias para o as classes utilitárias de borda do Tailwind. ### Crie um novo projeto com Tailwind -import { Tabs, TabItem } from '@astrojs/starlight/components'; - Comece um novo projeto Starlight com Tailwind CSS pré-configurado utilizando `create astro`: - + ```sh @@ -87,9 +91,11 @@ yarn create astro --template starlight/tailwind Se você já tem um site Starlight e quer adicionar Tailwind CSS, siga estes passos. + + 1. Adicione a integração Astro Tailwind: - + @@ -119,7 +125,7 @@ Se você já tem um site Starlight e quer adicionar Tailwind CSS, siga estes pas 2. Instale o plugin Starlight Tailwind: - + @@ -194,6 +200,8 @@ Se você já tem um site Starlight e quer adicionar Tailwind CSS, siga estes pas }; ``` + + ### Estilizando Starlight com Tailwind Starlight irá utilizar os valores da sua [configuração de tema do Tailwind](https://tailwindcss.com/docs/theme) em sua UI. @@ -235,7 +243,7 @@ export default { ## Tema -O tema de cores do Starlight pode ser controlado ao sobreescrever suas propriedades customizada padrões. +O tema de cores do Starlight pode ser controlado sobrescrevendo suas propriedades customizadas padrão. Essas variáveis são usadas na UI com uma variedade de tons de cinza usados como cores de texto e fundo e uma cor de destaque usada para links e para destacar itens atuais da navegação. ### Editor de tema de cores