diff options
author | HiDeoo | 2025-02-16 19:48:52 +0100 |
---|---|---|
committer | GitHub | 2025-02-16 19:48:52 +0100 |
commit | 0b9460309ed769ce9fbcf8b5e1f0aee117d936c5 (patch) | |
tree | ab898e14505488b35d5eb8a515a2e6a7a75c2b4f | |
parent | b21de6b429299bb8532a4e98f816a4da758ce973 (diff) | |
download | IT.starlight-0b9460309ed769ce9fbcf8b5e1f0aee117d936c5.tar.gz IT.starlight-0b9460309ed769ce9fbcf8b5e1f0aee117d936c5.tar.bz2 IT.starlight-0b9460309ed769ce9fbcf8b5e1f0aee117d936c5.zip |
i18n(fr): update `reference/overrides` & `guides/sidebar` (#2887)
Co-authored-by: trueberryless <99918022+trueberryless@users.noreply.github.com>
-rw-r--r-- | docs/src/content/docs/fr/guides/sidebar.mdx | 2 | ||||
-rw-r--r-- | 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 />`](#sitetitle-1), [`<Search />`](#search), [`<SocialIcons />`](#socialicons), [`<ThemeSelect />`](#themeselect) et [`<LanguageSelect />`](#languageselect). +L'implĂ©mentation par dĂ©faut affiche [`<SiteTitle />`](#sitetitle), [`<Search />`](#search), [`<SocialIcons />`](#socialicons), [`<ThemeSelect />`](#themeselect) et [`<LanguageSelect />`](#languageselect). #### `SiteTitle` |