Skip to content

Commit

Permalink
i18n(fr): Update pages.mdx and plugins.mdx (#1545)
Browse files Browse the repository at this point in the history
Co-authored-by: Chris Swithinbank <357379+delucis@users.noreply.github.com>
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
Co-authored-by: McFlyPartages <44530252+McFlyPartages@users.noreply.github.com>
Co-authored-by: Paul Valladares <85648028+dreyfus92@users.noreply.github.com>
  • Loading branch information
5 people authored Feb 22, 2024
1 parent 7a3c5c1 commit e8e3b7a
Show file tree
Hide file tree
Showing 2 changed files with 58 additions and 21 deletions.
42 changes: 32 additions & 10 deletions docs/src/content/docs/fr/guides/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -104,15 +104,37 @@ 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) n'est pas supportée. Dans le frontmatter en Markdown, cette option permet de personnaliser les [groupes de liens autogénérés](/fr/reference/configuration/#sidebar), ce qui n'est pas applicable aux pages utilisant le composant `<StarlightPage />`.

{/* ##### `sidebar` */}

{/* **Type :** `SidebarEntry[] | undefined` */}
{/* **Par défaut :** la barre latérale générée en fonction de la [configuration globale `sidebar`](/fr/reference/configuration/#sidebar) */}

{/* Fournir 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. */}
- 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 `<StarlightPage />` ne font pas partie d'une collection et ne peuvent pas être ajoutées à un groupe de liens autogénérés.

##### `sidebar`

**Type :** `SidebarEntry[]`
**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.

```astro {3-13}
<StarlightPage
frontmatter={{ title: 'Orion' }}
sidebar={[
{ label: 'Accueil', href: '/' },
{
label: 'Constellations',
items: [
{ label: 'Andromède', href: '/andromède/' },
{ label: 'Orion', href: '/orion/', isCurrent: true },
{ label: 'La Petite Ourse', href: '/la-petite-ourse/', badge: 'Ébauche' },
],
},
]}
>
Exemple de contenu.
</StarlightPage>
```

##### `hasSidebar`

Expand Down Expand Up @@ -148,4 +170,4 @@ Définit l'étiquette d’identification BCP-47 pour le contenu de cette page, p
**Type :** `boolean`
**Par défaut :** `false`

Indique si cette page utilise un [contenu de repli](/fr/guides/i18n/#contenu-de-repli) parce qu'il n'y a pas de traduction pour la langue actuelle.
Indique si cette page utilise un [contenu de repli](/fr/guides/i18n/#contenu-de-repli) parce qu'il n'y a pas de traduction pour la langue actuelle.
37 changes: 26 additions & 11 deletions docs/src/content/docs/fr/resources/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar:
---

:::tip[Ajoutez le vôtre !]
Avez-vous construit un modules d'extension ou un outil pour Starlight ?
Avez-vous construit un module d'extension ou un outil pour Starlight ?
Ouvrez une PR ajoutant un lien à cette page !
:::

Expand Down Expand Up @@ -38,6 +38,26 @@ Les [modules d'extension](/fr/reference/plugins/) peuvent personnaliser la confi
title="starlight-typedoc"
description="Générer des pages Starlight à partir de TypeScript en utilisant TypeDoc."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-blog"
title="starlight-blog"
description="Ajouter un blogue à votre site de documentation."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-openapi"
title="starlight-openapi"
description="Créer des pages de documentation à partir de spécifications OpenAPI/Swagger."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-obsidian"
title="starlight-obsidian"
description="Publier vos coffres (vaults) Obsidian sur votre site Starlight."
/>
<LinkCard
href="https://astro-ghostcms.xyz/intro/starlight/install/"
title="starlight-ghostcms"
description="Ajoutez vos articles de blogue GhostCMS à votre documentation Starlight"
/>
</CardGrid>

## Outils et intégrations communautaires
Expand All @@ -52,16 +72,6 @@ Ces outils et intégrations communautaires peuvent être utilisés pour ajouter
title="FeelBack"
description="Ajouter un système de retour d'expérience utilisateur à vos pages de documentation."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-blog"
title="starlight-blog"
description="Ajouter un blogue à votre site de documentation."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-openapi"
title="starlight-openapi"
description="Créer des pages de documentation à partir de spécifications OpenAPI/Swagger."
/>
<LinkCard
href="https://github.com/val-town/notion-to-astro"
title="notion-to-astro"
Expand All @@ -72,4 +82,9 @@ Ces outils et intégrations communautaires peuvent être utilisés pour ajouter
title="astro-live-code"
description="Afficher vos blocs de code MDX sous forme de composants interactifs"
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-i18n"
title="starlight-i18n"
description="Extension Visual Studio Code pour aider à traduire les pages Starlight."
/>
</CardGrid>

0 comments on commit e8e3b7a

Please sign in to comment.