From 0b9460309ed769ce9fbcf8b5e1f0aee117d936c5 Mon Sep 17 00:00:00 2001 From: HiDeoo Date: Sun, 16 Feb 2025 19:48:52 +0100 Subject: i18n(fr): update `reference/overrides` & `guides/sidebar` (#2887) Co-authored-by: trueberryless <99918022+trueberryless@users.noreply.github.com>--- docs/src/content/docs/fr/guides/sidebar.mdx | 2 +- docs/src/content/docs/fr/reference/overrides.md | 145 +----------------------- 2 files changed, 2 insertions(+), 145 deletions(-) diff --git a/docs/src/content/docs/fr/guides/sidebar.mdx b/docs/src/content/docs/fr/guides/sidebar.mdx index 40dd0779..8a3146bf 100644 --- a/docs/src/content/docs/fr/guides/sidebar.mdx +++ b/docs/src/content/docs/fr/guides/sidebar.mdx @@ -191,7 +191,7 @@ La configuration ci-dessus génère la barre latérale suivante : Starlight peut générer automatiquement un groupe dans votre barre latérale en fonction d'un répertoire de votre documentation. Cela est utile lorsque vous ne souhaitez pas entrer manuellement chaque élément de la barre latérale dans un groupe. -Par défaut, les pages sont triées par ordre alphabétique selon le [`slug`](/fr/reference/overrides/#slug) du fichier. +Par défaut, les pages sont triées par ordre alphabétique selon le [`slug`](/fr/reference/route-data/#slug) du fichier. Ajoutez un groupe généré automatiquement en utilisant un objet avec les propriétés `label` et `autogenerate`. La configuration de `autogenerate` doit spécifier le répertoire à utiliser pour les entrées de la barre latérale avec la propriété `directory`. Par exemple, avec la configuration suivante : diff --git a/docs/src/content/docs/fr/reference/overrides.md b/docs/src/content/docs/fr/reference/overrides.md index 1b08ce73..8eddb50d 100644 --- a/docs/src/content/docs/fr/reference/overrides.md +++ b/docs/src/content/docs/fr/reference/overrides.md @@ -10,149 +10,6 @@ Cette page répertorie tous les composants disponibles qui peuvent être redéfi Pour en savoir plus, consultez le [guide des redéfinitions de composants](/fr/guides/overriding-components/). -## Props des composants - -Tous les composants peuvent accéder à un objet `Astro.props` standard qui contient des informations concernant la page courante. - -Pour typer vos composants personnalisés, importez le type `Props` depuis Starlight : - -```astro ---- -// src/components/Custom.astro -import type { Props } from '@astrojs/starlight/props'; - -const { hasSidebar } = Astro.props; -// ^ type: boolean ---- -``` - -Cela vous permettra d'obtenir de l'autocomplétion et un typage lors de l'utilisation de `Astro.props`. - -### Props - -Starlight passera les props suivantes à vos composants personnalisés. - -#### `dir` - -**Type :** `'ltr' | 'rtl'` - -Le sens d'écriture de la page. - -#### `lang` - -**Type :** `string` - -L’étiquette d’identification BCP-47 pour la langue de la page, par exemple `en`, `zh-CN` ou `pt-BR`. - -#### `locale` - -**Type :** `string | undefined` - -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. - -#### `siteTitleHref` - -**Type :** `string` - -La valeur de l’attribut `href` du titre du site, renvoyant à la page d'accueil, par exemple `/`. -Pour les sites multilingues, cette valeur inclura la locale actuelle, par exemple `/fr/` ou `/zh-cn/`. - -#### `slug` - -**Type :** `string` - -Le slug de la page généré à partir du nom du fichier du contenu. - -Cette propriété est dépréciée et sera supprimée dans une version future de Starlight. -Migrez vers la nouvelle API Content Layer en utilisant le [`docsLoader` de Starlight](/fr/manual-setup/#configurer-les-collections-de-contenu) et utilisez la propriété [`id`](#id) à la place. - -#### `id` - -**Type :** `string` - -Le slug de cette page ou l'identifiant unique de cette page basé sur le nom du fichier du contenu si l'option [`legacy.collections`](https://docs.astro.build/fr/reference/legacy-flags/#collections) est utilisée. - -#### `isFallback` - -**Type :** `true | undefined` - -`true` si cette page n'est pas traduite dans la langue actuelle et utilise le contenu de la langue par défaut en tant que repli. -Utilisé uniquement dans les sites multilingues. - -#### `entryMeta` - -**Type :** `{ dir: 'ltr' | 'rtl'; lang: string }` - -Métadonnées de la locale pour le contenu de la page. Peut être différent des valeurs de locale de premier niveau lorsque la page utilise un contenu de repli. - -#### `entry` - -L'entrée de la collection de contenu Astro pour la page courante. -Inclut les valeurs du frontmatter pour la page courante dans `entry.data`. - -```ts -entry: { - data: { - title: string; - description: string | undefined; - // etc. - } -} -``` - -Pour en savoir plus sur le format de cet objet, consultez la [référence du type d'entrée de collection](https://docs.astro.build/fr/reference/modules/astro-content/#collectionentry). - -#### `sidebar` - -**Type :** `SidebarEntry[]` - -Les entrées de la barre latérale de navigation du site pour cette page. - -#### `hasSidebar` - -**Type :** `boolean` - -Indique si la barre latérale est affichée sur cette page. - -#### `pagination` - -**Type :** `{ prev?: Link; next?: Link }` - -Liens vers la page précédente et suivante dans la barre latérale si celle-ci est activée. - -#### `toc` - -**Type :** `{ minHeadingLevel: number; maxHeadingLevel: number; items: TocItem[] } | undefined` - -Table des matières de la page courante si celle-ci est activée. - -#### `headings` - -**Type :** `{ depth: number; slug: string; text: string }[]` - -Un tableau de toutes les en-têtes Markdown extraites de la page courante. -Utilisez [`toc`](#toc) à la place si vous souhaitez construire un composant de table des matières qui respecte les options de configuration de Starlight. - -#### `lastUpdated` - -**Type :** `Date | undefined` - -Un objet JavaScript de type `Date` représentant la date de dernière mise à jour de cette page si cette fonctionnalité est activée. - -#### `editUrl` - -**Type :** `URL | undefined` - -Un objet `URL` de l'adresse où cette page peut être modifiée si cette fonctionnalité est activée. - ---- - ## Composants ### Métadonnées @@ -230,7 +87,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-1), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). +L'implémentation par défaut affiche [``](#sitetitle), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). #### `SiteTitle` -- cgit