Skip to content

Commit

Permalink
i18n(fr): Update components/i18n/sidebar/configuration/frontmatter.md…
Browse files Browse the repository at this point in the history
…x files (#1964)

Co-authored-by: HiDeoo <[email protected]>
Co-authored-by: pioupia <[email protected]>
Co-authored-by: Paul Valladares <[email protected]>
  • Loading branch information
4 people authored Jun 6, 2024
1 parent 8338c68 commit 0df299f
Show file tree
Hide file tree
Showing 5 changed files with 65 additions and 8 deletions.
35 changes: 32 additions & 3 deletions docs/src/content/docs/fr/guides/components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,8 +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>` 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 `<Tabs>` et assurez-vous qu'ils utilisent tous les mêmes libellés de `<TabItem>` :

Expand Down Expand Up @@ -147,7 +146,7 @@ Une `<Card>` nécessite un `title` et peut optionnellement inclure un attribut `
import { Card, CardGrid } from '@astrojs/starlight/components';

<Card title="Regardez-ça">
Contenu intéressant que vous souhaitez mettre en évidence.
Contenu intéressant que vous souhaitez mettre en évidence.
</Card>

<CardGrid>
Expand Down Expand Up @@ -423,6 +422,36 @@ import { Steps } from '@astrojs/starlight/components';

</Steps>

### Badges

import { Badge } from '@astrojs/starlight/components';

Utilisez le composant `<Badge>` pour afficher de petits éléments d'information, tels que des statuts ou des étiquettes.
Passez le contenu que vous souhaitez afficher à l'attribut `text` du composant `<Badge>`.

Par défaut, le badge utilisera la couleur d'accentuation du thème de votre site. Pour utiliser une couleur de badge intégrée, définissez l'attribut `variant` à l'une des valeurs suivantes : `note` (bleu), `tip` (violet), `danger` (rouge), `caution` (orange), ou `success` (vert).
L'attribut `size` (par défaut : `small`) contrôle la taille du texte du badge. Les valeurs `medium` et `large` sont également disponibles pour afficher un badge plus grand.

Pour une personnalisation plus poussée, utilisez d'autres attributs de l'élément `<span>` tels que `class` ou `style` avec du CSS personnalisé.

```mdx title="src/content/docs/example.mdx"
import { Badge } from '@astrojs/starlight/components';
<Badge text="Nouveau" variant="tip" size="small" />
<Badge text="Obsolète" variant="caution" size="medium" />
<Badge text="Starlight" variant="note" size="large" />
<Badge text="Personnalisé" variant="success" style={{ fontStyle: 'italic' }} />
```

Le code ci-dessus génère ce qui suit sur la page :

<Badge text="Nouveau" variant="tip" size="small" />
<Badge text="Déclassé" variant="caution" size="medium" />
<Badge text="Starlight" variant="note" size="large" />
<Badge text="Personnalisé" variant="success" style={{ fontStyle: 'italic' }} />

### Icônes

import { Icon } from '@astrojs/starlight/components';
Expand Down
15 changes: 15 additions & 0 deletions docs/src/content/docs/fr/guides/i18n.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,8 @@ Starlight offre une prise en charge intégrée des sites multilingues, y compris
</Steps>
Pour les scénarios i18n plus avancés, Starlight prend également en compte la configuration de l'internationalisation à l'aide de l'option de [configuration `i18n` d'Astro](https://docs.astro.build/fr/guides/internationalization/#configure-i18n-routing).
### Utiliser une racine locale
Vous pouvez utiliser une “racine” locale pour servir une langue sans aucun préfixe i18n dans son chemin. Par exemple, si l'anglais est votre racine locale, le chemin d'une page en anglais ressemblera à `/about` au lieu de `/en/about`.
Expand Down Expand Up @@ -271,3 +273,16 @@ export const collections = {
```

Consultez [« Définir un schéma de collection de contenus »](https://docs.astro.build/fr/guides/content-collections/#defining-a-collection-schema) dans la documentation d'Astro pour en savoir plus sur les schémas de collection de contenus.

## Accès aux paramètres régionaux

Vous pouvez utiliser [`Astro.currentLocale`](https://docs.astro.build/fr/reference/api-reference/#astrocurrentlocale) pour lire les paramètres régionaux et linguistiques actuels dans les composants `.astro`.

L'exemple suivant lit les paramètres régionaux actuels et les utilise pour générer un lien vers une page d'information dans la même langue :

```astro
---
// src/components/AboutLink.astro
---
<a href={`/${Astro.currentLocale}/about`}>À propos</a>
```
8 changes: 5 additions & 3 deletions docs/src/content/docs/fr/guides/sidebar.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -295,12 +295,14 @@ La configuration ci-dessus génère la barre latérale suivante :
]}
/>

### Variantes de badges
### Variantes de badges et style personnalisé

Personnalisez le style du badge en utilisant un objet avec les propriétés `text` et `variant`.
Personnalisez le style du badge en utilisant un objet avec les propriétés `text`, `variant`, et `class`.

La propriété `text` représente le contenu à afficher (par exemple, "Nouveau").
Remplacez le style `default`, qui utilise la couleur d'accentuation de votre site, en définissant la propriété `variant` avec l'une des valeurs suivantes : `note`, `tip`, `danger`, `caution` ou `success`.
Par défaut, le badge utilise la couleur d'accentuation de votre site. Pour utiliser un style de badge intégré, définissez la propriété `variant` à l'une des valeurs suivantes : `note`, `tip`, `danger`, `caution` ou `success`.

Facultativement, vous pouvez créer un style de badge personnalisé en définissant la propriété `class` à un nom de classe CSS.

```js {10}
starlight({
Expand Down
13 changes: 12 additions & 1 deletion docs/src/content/docs/fr/reference/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,8 @@ type SidebarItem = {
```ts
interface BadgeConfig {
text: string;
variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
variant?: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
class?: string;
}
```

Expand Down Expand Up @@ -568,3 +569,13 @@ starlight({
```

Consultez la [référence des modules d'extension](/fr/reference/plugins/) pour plus de détails pour créer vos propres modules d'extension.

### `credits`

Permet l'affichage d'un lien "Créé avec Starlight" dans le pied de page de votre site.

```js
starlight({
credits: true,
});
```
2 changes: 1 addition & 1 deletion docs/src/content/docs/fr/reference/frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -355,7 +355,7 @@ sidebar:

Ajoute un badge à la page dans la barre latérale lorsqu'elle est affichée dans un groupe de liens généré automatiquement.
Lors de l'utilisation d'une chaîne de caractères, le badge sera affiché avec une couleur d'accentuation par défaut.
Passez éventuellement un [objet `BadgeConfig`](/fr/reference/configuration/#badgeconfig) avec les propriétés `text` et `variant` pour personnaliser le badge.
Passez éventuellement un [objet `BadgeConfig`](/fr/reference/configuration/#badgeconfig) avec les propriétés `text`, `variant`, et `class` pour personnaliser le badge.

```md
---
Expand Down

0 comments on commit 0df299f

Please sign in to comment.