Merge branch 'main' into hd-examples-index-hero-actions-variants

HiDeoo · web-flow · commit c5eceeed50a6 · 2024-08-17T13:29:40.000+02:00
diff --git a/docs/src/content/docs/da/index.mdx b/docs/src/content/docs/da/index.mdx
@@ -12,10 +12,10 @@ hero:
   actions:
     - text: Kom igang
       icon: right-arrow
-      variant: primary
       link: /da/getting-started/
     - text: Se på GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/de/index.mdx b/docs/src/content/docs/de/index.mdx
@@ -10,10 +10,10 @@ hero:
   actions:
     - text: Los geht's
       icon: right-arrow
-      variant: primary
       link: /de/getting-started/
     - text: Auf GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/es/index.mdx b/docs/src/content/docs/es/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Empezar
       icon: right-arrow
-      variant: primary
       link: /es/getting-started/
     - text: Ver en GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/fr/guides/components.mdx b/docs/src/content/docs/fr/guides/components.mdx
@@ -91,7 +91,7 @@ Le code ci-dessus génère les onglets suivants sur la page :
 
 Conservez plusieurs groupes d'onglets synchronisés en ajoutant l'attribut `syncKey`.
 
-Tous les composants `<Tabs>` 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.
+Tous les composants `<Tabs>` 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 persisté au travers de navigations entre différentes pages.
 
 Pour synchroniser des onglets liés, ajoutez une propriété `syncKey` identique à chaque composant `<Tabs>` et assurez-vous qu'ils utilisent tous les mêmes libellés de `<TabItem>` :
 
@@ -186,7 +186,7 @@ Ajoutez l'attribut `stagger` pour décaler verticalement la deuxième colonne de
 
 :::
 
-### Cartes de Liaison
+### Cartes de liaison
 
 Utilisez le composant `<LinkCard>` pour créer un lien bien visible vers différentes pages.
 
@@ -232,6 +232,38 @@ import { LinkCard } from '@astrojs/starlight/components';
 	<LinkCard title="Composants" href="/fr/guides/components/" />
 </CardGrid>
 
+### Boutons de liaison
+
+Utilisez le composant `<LinkButton>` pour créer des liens visuellement distincts qui appellent à l'action (également connus sous le nom de « call-to-action » ou « CTA » en anglais).
+Un bouton de liaison est utile pour diriger les utilisateurs vers le contenu le plus pertinent ou actionnable et est souvent utilisé sur les pages d'accueil.
+
+Un `<LinkButton>` nécessite un attribut [`href`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/a#href) et accepte en option d'autres attributs de lien tels que `target`.
+
+L'attribut `icon` peut être défini avec le nom de [l'une des icônes intégrées à Starlight](#toutes-les-icônes) pour inclure une icône à côté du texte.
+L'attribut `iconPlacement` peut être utilisé pour placer l'icône avant le texte en le définissant à `start` (par défaut à `end`).
+
+Personnalisez l'apparence du bouton de liaison en utilisant l'attribut `variant`, qui peut être défini à `primary` (par défaut), `secondary` ou `minimal`.
+
+```mdx
+# src/content/docs/exemple.mdx
+
+import { LinkButton } from '@astrojs/starlight/components';
+
+<LinkButton href="/fr/getting-started/">Mise en route</LinkButton>
+<LinkButton href="https://docs.astro.build" variant="secondary" icon="external">
+	Référence: Astro
+</LinkButton>
+```
+
+Le code ci-dessus génère ce qui suit sur la page :
+
+import { LinkButton } from '@astrojs/starlight/components';
+
+<LinkButton href="/fr/getting-started/">Mise en route</LinkButton>
+<LinkButton href="https://docs.astro.build" variant="secondary" icon="external">
+	Référence: Astro
+</LinkButton>
+
 ### Encarts
 
 Les encarts (également connus sous le nom de « admonitions » ou « asides » en anglais) sont utiles pour afficher des informations secondaires à côté du contenu principal d'une page.
diff --git a/docs/src/content/docs/fr/guides/pages.mdx b/docs/src/content/docs/fr/guides/pages.mdx
@@ -109,28 +109,27 @@ Les propriétés suivantes diffèrent du frontmatter en Markdown :
 
 ##### `sidebar`
 
-**Type :** `SidebarEntry[]`  
+**Type :** [`SidebarItem[]`](/fr/reference/configuration/#sidebaritem)  
 **Par défaut :** la barre latérale générée en fonction de la [configuration globale `sidebar`](/fr/reference/configuration/#sidebar)
 
 Fournit une barre latérale de navigation personnalisée pour cette page.
 Si elle n'est pas définie, la page utilisera la barre latérale globale par défaut.
 
-Par exemple, la page suivante remplace la barre latérale par défaut par un lien vers la page d'accueil et un groupe de liens vers différentes constellations.
-La page courante dans la barre latérale est définie à l'aide de la propriété `isCurrent` et un `badge` optionnel a été ajouté à un élément de lien.
+Par exemple, la page suivante remplace la barre latérale par défaut par un lien vers la page d'accueil et un groupe de liens vers diverses autres pages personnalisées.
 
-```astro {3-13}
+```astro {3-17}
 <StarlightPage
 	frontmatter={{ title: 'Orion' }}
 	sidebar={[
-		{ label: 'Accueil', href: '/' },
+		{ label: 'Accueil', link: '/' },
 		{
 			label: 'Constellations',
 			items: [
-				{ label: 'Andromède', href: '/andromède/' },
-				{ label: 'Orion', href: '/orion/', isCurrent: true },
+				{ label: 'Andromède', link: '/andromède/' },
+				{ label: 'Orion', link: '/orion/' },
 				{
 					label: 'La Petite Ourse',
-					href: '/la-petite-ourse/',
+					link: '/la-petite-ourse/',
 					badge: 'Ébauche',
 				},
 			],
@@ -141,6 +140,8 @@ La page courante dans la barre latérale est définie à l'aide de la propriét
 </StarlightPage>
 ```
 
+Consultez le guide [« Barre latérale de navigation »](/fr/guides/sidebar/) pour en savoir plus sur les options disponibles pour personnaliser la barre latérale.
+
 ##### `hasSidebar`
 
 **Type :** `boolean`  
diff --git a/docs/src/content/docs/fr/reference/frontmatter.md b/docs/src/content/docs/fr/reference/frontmatter.md
@@ -115,10 +115,10 @@ hero:
     - text: En savoir plus
       link: /getting-started/
       icon: right-arrow
-      variant: primary
     - text: Voir sur GitHub
       link: https://github.com/astronaut/my-project
       icon: external
+      variant: minimal
       attrs:
         rel: me
 ---
@@ -166,8 +166,8 @@ interface HeroConfig {
   actions?: Array<{
     text: string;
     link: string;
-    variant: 'primary' | 'secondary' | 'minimal';
-    icon: string;
+    variant?: 'primary' | 'secondary' | 'minimal';
+    icon?: string;
     attrs?: Record<string, string | number | boolean>;
   }>;
 }
diff --git a/docs/src/content/docs/hi/index.mdx b/docs/src/content/docs/hi/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: शुरू हो जाओ
       icon: right-arrow
-      variant: primary
       link: /hi/getting-started/
     - text: GitHub पर देखें
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/id/index.mdx b/docs/src/content/docs/id/index.mdx
@@ -10,10 +10,10 @@ hero:
   actions:
     - text: Memulai
       icon: right-arrow
-      variant: primary
       link: /id/getting-started/
     - text: Lihat di GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/it/index.mdx b/docs/src/content/docs/it/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Inizia
       icon: right-arrow
-      variant: primary
       link: /it/getting-started/
     - text: Vedi su GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/ja/index.mdx b/docs/src/content/docs/ja/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: はじめる
       icon: right-arrow
-      variant: primary
       link: /ja/getting-started/
     - text: GitHubで見る
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/pt-br/index.mdx b/docs/src/content/docs/pt-br/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Começar
       icon: right-arrow
-      variant: primary
       link: /pt-br/getting-started/
     - text: Veja no GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/pt-pt/index.mdx b/docs/src/content/docs/pt-pt/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Começar
       icon: right-arrow
-      variant: primary
       link: /pt-pt/getting-started/
     - text: Veja no GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Начать
       icon: right-arrow
-      variant: primary
       link: /ru/getting-started/
     - text: Открыть в GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/tr/index.mdx b/docs/src/content/docs/tr/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Başla
       icon: right-arrow
-      variant: primary
       link: getting-started
     - text: Github'da Görüntüle
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/uk/index.mdx b/docs/src/content/docs/uk/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: Розпочати
       icon: right-arrow
-      variant: primary
       link: /uk/getting-started/
     - text: Переглянути на GitHub
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
diff --git a/docs/src/content/docs/zh-cn/index.mdx b/docs/src/content/docs/zh-cn/index.mdx
@@ -15,10 +15,10 @@ hero:
   actions:
     - text: 开始使用
       icon: right-arrow
-      variant: primary
       link: /zh-cn/getting-started/
     - text: 在 GitHub 上查看
       icon: external
+      variant: minimal
       link: https://github.com/withastro/starlight
 ---
 
