Skip to content

i18n(fr): small rewording and fixes in guides #3431

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 17, 2025
Merged

i18n(fr): small rewording and fixes in guides #3431

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8dba9e7
i18n(fr): small rewording and fixes in `guides`
ArmandPhilippot Sep 16, 2025
e013b5b
replace `titre` with `en-tête` for headings
ArmandPhilippot Sep 17, 2025
bf75055
Merge branch 'main' into i18n/fr-update-guides
ArmandPhilippot Sep 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 26 additions & 26 deletions docs/src/content/docs/fr/guides/authoring-content.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ title: Création de contenu en Markdown
description: Un aperçu de la syntaxe Markdown prise en charge par Starlight.
---

Starlight prend en charge l'ensemble de la syntaxe [Markdown](https://daringfireball.net/projects/markdown/) dans les fichiers `.md` ainsi que la syntaxe frontale [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) pour définir des métadonnées telles qu'un titre et une description.
Starlight prend en charge l'ensemble de la syntaxe [Markdown](https://daringfireball.net/projects/markdown/) dans les fichiers `.md` ainsi que le frontmatter en [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) pour définir des métadonnées telles qu'un titre et une description.

Veillez à consulter les [MDX docs](https://mdxjs.com/docs/what-is-mdx/#markdown) ou les [Markdoc docs](https://markdoc.dev/docs/syntax) si vous utilisez ces formats de fichiers, car la prise en charge et l'utilisation de Markdown peuvent varier.
Veillez à consulter la [documentation de MDX](https://mdxjs.com/docs/what-is-mdx/#markdown) ou la [documentation de Markdoc](https://markdoc.dev/docs/syntax) si vous utilisez ces formats de fichiers, car la prise en charge et l'utilisation de Markdown peuvent varier.

## Frontmatter

Expand All @@ -23,12 +23,12 @@ Le contenu de la page suit le second `---`.
Chaque page doit inclure au moins un titre (`title`).
Consultez la [référence du frontmatter](/fr/reference/frontmatter/) pour connaître tous les champs disponibles et comment ajouter des champs personnalisés.

## Styles en ligne
## Styles incorporés au texte

Le texte peut être **gras**, _italique_, ou ~~barré~~.
Le texte peut être en **gras**, en _italique_, ou ~~barré~~.

```md
Le texte peut être **gras**, _italique_, ou ~~barré~~.
Le texte peut être en **gras**, en _italique_, ou ~~barré~~.
```

Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
Expand All @@ -37,25 +37,25 @@ Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
```

Vous pouvez mettre en évidence le `code en ligne` à l'aide d'un astérisque.
Vous pouvez mettre en évidence le `code incorporé au texte` en utilisant des accents graves.

```md
Vous pouvez mettre en évidence le `code en ligne` à l'aide de barres de défilement.
Vous pouvez mettre en évidence le `code incorporé au texte` en utilisant des accents graves.
```

## Images

Les images dans Starlight utilisent [la prise en charge intégrée des ressources optimisées d'Astro](https://docs.astro.build/fr/guides/images/).

Markdown et MDX supportent la syntaxe Markdown pour l'affichage des images qui inclut le texte alt pour les lecteurs d'écran et les technologies d'assistance.
Markdown et MDX prennent en charge la syntaxe Markdown pour l'affichage d'images qui incluent du texte alternatif pour les lecteurs d'écran et les technologies d'assistance.

![Une illustration de planètes et d'étoiles avec le mot "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
![Une illustration de planètes et d'étoiles avec le mot « astro »](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)

```md
![Une illustration de planètes et d'étoiles avec le mot "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
![Une illustration de planètes et d'étoiles avec le mot « astro »](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
```

Les chemins d'accès relatifs aux images sont également supportés pour les images stockées localement dans votre projet.
Les chemins d'accès relatifs aux images sont également pris en charge pour les images stockées localement dans votre projet.

```md
// src/content/docs/page-1.md
Expand All @@ -69,7 +69,7 @@ Vous pouvez structurer le contenu à l'aide d'un titre. En Markdown, les titres

### Comment structurer le contenu d'une page dans Starlight

Starlight est configuré pour utiliser automatiquement le titre de votre page comme titre de premier niveau et inclura un titre "Aperçu" en haut de la table des matières de chaque page. Nous vous recommandons de commencer chaque page par un paragraphe de texte normal et d'utiliser des titres de page à partir de `<h2>` :
Starlight est configuré pour utiliser automatiquement le titre de votre page comme titre de premier niveau et inclura un titre « Aperçu » en haut de la table des matières de chaque page. Nous vous recommandons de commencer chaque page par un paragraphe de texte normal et d'utiliser des titres de page à partir de `<h2>` :

```md
---
Expand All @@ -79,7 +79,7 @@ description: Comment utiliser Markdown dans Starlight

Cette page décrit comment utiliser Markdown dans Starlight.

## Styles en ligne
## Styles incorporés au texte

## Titres
```
Expand All @@ -105,15 +105,15 @@ Je peux faire un lien vers [ma conclusion](#conclusion) plus bas sur la même pa

Les titres de niveau 2 (`<h2>`) et de niveau 3 (`<h3>`) apparaissent automatiquement dans la table des matières de la page.

Pour en apprendre davantage sur la façon dont Astro traite les attributs `id` des titres de section, consultez la [documentation d'Astro](https://docs.astro.build/fr/guides/markdown-content/#identifiants-den-t%C3%AAte).
Pour en apprendre davantage sur la façon dont Astro traite les attributs `id` des titres de section, consultez la [documentation d'Astro](https://docs.astro.build/fr/guides/markdown-content/#id-des-titres).

## 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.

Starlight fournit une syntaxe Markdown personnalisée pour le rendu des encarts. Les blocs d'encarts sont indiqués en utilisant une paire de triples points `:::` pour envelopper votre contenu, et peuvent être de type `note`, `tip`, `caution` ou `danger`.

Vous pouvez imbriquer n'importe quel autre type de contenu Markdown à l'intérieur d'un aparté, mais les aparté sont mieux adaptés à des morceaux de contenu courts et concis.
Vous pouvez imbriquer n'importe quel autre type de contenu Markdown à l'intérieur d'un encart, mais les encarts sont mieux adaptés à des morceaux de contenu courts et concis.

### Encart de type note

Expand Down Expand Up @@ -179,7 +179,7 @@ Vos utilisateurs peuvent être plus productifs et trouver votre produit plus fac

- Navigation claire
- Thème de couleurs configurable par l'utilisateur
- [Support i18n](/fr/guides/i18n/)
- [Prise en charge i18n](/fr/guides/i18n/)

:::

Expand All @@ -193,21 +193,21 @@ Vos utilisateurs peuvent être plus productifs et trouver votre produit plus fac

- Navigation claire
- Thème de couleurs configurable par l'utilisateur
- [Support i18n](/fr/guides/i18n/)
- [Prise en charge i18n](/fr/guides/i18n/)

:::
```

## Blockquotes
## Blocs de citation

> Il s'agit d'une citation en bloc, couramment utilisée pour citer une autre personne ou un document.
> Il s'agit d'un bloc de citation, couramment utilisé pour citer une autre personne ou un document.
>
> Les guillemets sont indiqués par un `>` au début de chaque ligne.
> Les blocs de citation sont indiqués par un `>` au début de chaque ligne.

```md
> Il s'agit d'une citation en bloc, couramment utilisée pour citer une autre personne ou un document.
> Il s'agit d'un bloc de citation, couramment utilisé pour citer une autre personne ou un document.
>
> Les guillemets sont indiqués par un `>` au début de chaque ligne.
> Les blocs de citation sont indiqués par un `>` au début de chaque ligne.
```

## Blocs de code
Expand Down Expand Up @@ -235,7 +235,7 @@ var fun = function lang(l) {
### Fonctionnalités d'Expressive Code

Starlight utilise [Expressive Code](https://expressive-code.com/) pour étendre les possibilités de formatage des blocs de code.
Les plugins Expressive Code de marqueurs de texte et de cadres de fenêtre sont activés par défaut.
Les modules d'extension Expressive Code de marqueurs de texte et de cadres de fenêtre sont activés par défaut.
L'affichage des blocs de code peut être configuré à l'aide de [l'option de configuration `expressiveCode`](/fr/reference/configuration/#expressivecode) de Starlight.

#### Marqueurs de texte
Expand All @@ -248,7 +248,7 @@ Du texte et des lignes entières peuvent être marqués à l'aide du marqueur pa

Expressive Code fournit plusieurs options pour personnaliser l'apparence visuelle de vos exemples de code.
Beaucoup d'entre elles peuvent être combinées pour obtenir des exemples de code très illustratifs.
Merci d'explorer la [documentation d'Expressive Code](https://expressive-code.com/key-features/text-markers/#configuration) pour obtenir une liste complète des options disponibles.
Veuillez explorer la [documentation d'Expressive Code](https://expressive-code.com/key-features/text-markers/#configuration) pour obtenir une liste complète des options disponibles.
Certaines des options les plus courantes sont présentées ci-dessous :

- [Marquer des lignes entières et des plages de lignes à l'aide du marqueur `{ }`](https://expressive-code.com/key-features/text-markers/#marking-full-lines--line-ranges) :
Expand Down Expand Up @@ -548,11 +548,11 @@ Starlight prend en charge toutes les autres syntaxes de rédaction Markdown, tel

## Configuration avancée de Markdown et MDX

Starlight utilise le moteur de rendu Markdown et MDX d'Astro basé sur remark et rehype. Vous pouvez ajouter la prise en charge de syntaxe et comportement personnalisés en ajoutant `remarkPlugins` ou `rehypePlugins` dans votre fichier de configuration Astro. Pour en savoir plus, consultez [« Plugins Markdown »](https://docs.astro.build/fr/guides/markdown-content/#plugins-markdown) dans la documentation d'Astro.
Starlight utilise le moteur de rendu Markdown et MDX d'Astro basé sur remark et rehype. Vous pouvez ajouter la prise en charge de syntaxe et comportement personnalisés en ajoutant `remarkPlugins` ou `rehypePlugins` dans votre fichier de configuration Astro. Pour en savoir plus, consultez [« Modules d’extension Markdown »](https://docs.astro.build/fr/guides/markdown-content/#modules-dextension-markdown) dans la documentation d'Astro.

## Markdoc

Starlight supporte la création de contenu en Markdoc en utilisant l'intégration expérimentale [Astro Markdoc](https://docs.astro.build/fr/guides/integrations-guide/markdoc/) et le préréglage Markdoc de Starlight.
Starlight prend en charge la création de contenu en Markdoc en utilisant l'intégration expérimentale [Astro Markdoc](https://docs.astro.build/fr/guides/integrations-guide/markdoc/) et le préréglage Markdoc de Starlight.

### Créer un nouveau projet avec Markdoc

Expand Down
10 changes: 5 additions & 5 deletions docs/src/content/docs/fr/guides/css-and-tailwind.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Le CSS Tailwind de Starlight applique la configuration suivante :

### Créer un nouveau projet avec Tailwind

Démarrez un nouveau projet Starlight avec Tailwind CSS préconfiguré en utilisant `create astro` :
Démarrez un nouveau projet Starlight avec Tailwind CSS préconfiguré en utilisant `create astro` :

<Tabs syncKey="pkg">
<TabItem label="npm">
Expand Down Expand Up @@ -215,10 +215,10 @@ Lors de la [création d'un nouveau projet Starlight avec Tailwind](#créer-un-no

Si définies, les propriétés personnalisées CSS suivantes remplaceront les styles par défaut de Starlight :

- `--color-accent-*` — utilisé pour les liens et la mise en évidence de l'élément courant
- `--color-gray-*` — utilisé pour les couleurs d'arrière-plan et les bordures
- `--font-sans` — utilisé pour le texte de l'interface utilisateur et du contenu
- `--font-mono` — utilisé pour les exemples de code
- `--color-accent-*` — utilisée pour les liens et la mise en évidence de l'élément courant
- `--color-gray-*` — utilisée pour les couleurs d'arrière-plan et les bordures
- `--font-sans` — utilisée pour le texte de l'interface utilisateur et du contenu
- `--font-mono` — utilisée pour les exemples de code

```css {9-12,14-17,19-22,34-37}
/* src/styles/global.css */
Expand Down
28 changes: 14 additions & 14 deletions docs/src/content/docs/fr/guides/customization.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ L’ajout d’un logo personnalisé à l’en-tête du site est un moyen rapide

</FileTree>

2. Ajoutez le chemin vers votre logo à votre option de configuration Starlight [`logo.src`](/fr/reference/configuration/#logo) dans `astro.config.mjs`:
2. Ajoutez le chemin vers votre logo à votre option de configuration Starlight [`logo.src`](/fr/reference/configuration/#logo) dans `astro.config.mjs` :

```diff lang="js"
// astro.config.mjs
Expand Down Expand Up @@ -67,7 +67,7 @@ Vous pouvez afficher différentes versions de votre logo en modes clair et sombr

<Steps>

1. Ajouter un fichier image pour chaque variante dans `src/assets/`:
1. Ajouter un fichier image pour chaque variante dans `src/assets/` :

<FileTree>

Expand All @@ -80,7 +80,7 @@ Vous pouvez afficher différentes versions de votre logo en modes clair et sombr

</FileTree>

2. Ajouter les chemins vers vos variantes de logo dans les options `light` (clair) et `dark` (sombre) en remplacement de l’option `src` dans `astro.config.mjs`:
2. Ajouter les chemins vers vos variantes de logo dans les options `light` (clair) et `dark` (sombre) en remplacement de l’option `src` dans `astro.config.mjs` :

```diff lang="js"
starlight({
Expand All @@ -96,7 +96,7 @@ Vous pouvez afficher différentes versions de votre logo en modes clair et sombr

## Activer un plan de site

Starlight possède une prise en charge intégrée pour la génération d’un plan de site. Activez la génération du plan de site en définissant votre URL comme `site` dans `astro.config.mjs`:
Starlight possède une prise en charge intégrée pour la génération d’un plan de site. Activez la génération du plan de site en définissant votre URL comme `site` dans `astro.config.mjs` :

```js {4}
// astro.config.mjs
Expand Down Expand Up @@ -164,7 +164,7 @@ defineConfig({
</TabItem>
</Tabs>

Désactivez la table des matières complètement en définissant l’option `tableOfContents` à `false`:
Désactivez la table des matières complètement en définissant l’option `tableOfContents` à `false` :

<Tabs syncKey="config-type">
<TabItem label="Frontmatter">
Expand Down Expand Up @@ -198,7 +198,7 @@ defineConfig({

## Liens sociaux

Starlight supporte par défaut l’ajout de liens vers vos comptes de médias sociaux dans l’en-tête du site via l’option [`social`](/fr/reference/configuration/#social) dans l’intégration Starlight.
Starlight prend en charge par défaut l’ajout de liens vers vos comptes de médias sociaux dans l’en-tête du site via l’option [`social`](/fr/reference/configuration/#social) dans l’intégration Starlight.

Chaque entrée dans le tableau `social` doit être un objet avec trois propriétés :

Expand Down Expand Up @@ -232,17 +232,17 @@ export default defineConfig({

## Liens d’édition de page

Starlight peut afficher un lien "Modifier cette page" dans le pied de page de chaque page.
Starlight peut afficher un lien « Modifier cette page » dans le pied de page de chaque page.
Cela permet au lecteur de trouver facilement le fichier à modifier pour améliorer vos documents.
Pour les projets open source en particulier, cela peut aider à encourager les contributions de votre communauté.

Pour activer les liens de modification, définissez l’option de configuration [`editLink.baseUrl`](/fr/reference/configuration/#editlink) en lui assignant l’URL utilisée pour modifier votre référentiel dans la configuration de l’intégration Starlight.
Pour activer les liens de modification, définissez l’option de configuration [`editLink.baseUrl`](/fr/reference/configuration/#editlink) en lui assignant l’URL utilisée pour modifier votre dépôt dans la configuration de l’intégration Starlight.
La valeur de `editLink.baseUrl` sera automatiquement ajoutée au chemin d’accès vers la page actuelle pour former le lien d’édition complet.

Les formes d’URL les plus courantes incluent :

- GitHub: `https://github.com/NOM_UTILISATEUR/NOM_DU_DEPOT/edit/NOM_DE_LA_BRANCHE/`
- GitLab: `https://gitlab.com/NOM_UTILISATEUR/NOM_DU_DEPOT/-/edit/NOM_DE_LA_BRANCHE/`
- GitHub : `https://github.com/NOM_UTILISATEUR/NOM_DU_DEPOT/edit/NOM_DE_LA_BRANCHE/`
- GitLab : `https://gitlab.com/NOM_UTILISATEUR/NOM_DU_DEPOT/-/edit/NOM_DE_LA_BRANCHE/`

Si votre projet Starlight ne se trouve pas à la racine de votre dépôt, incluez le chemin d’accès au projet à la fin de l’URL de base.

Expand Down Expand Up @@ -319,11 +319,11 @@ export default defineConfig({
Par défaut, Starlight utilise des polices sans empattement disponibles en local sur la machine du visiteur pour tout les textes.
Cela garantit que la documentation se charge rapidement dans une police familière à chaque utilisateur, sans nécessiter de bande passante supplémentaire pour télécharger des fichiers de police volumineux.

Si vous souhaitez ajouter une police personnalisée à votre site Starlight, vous pouvez configurer les polices à utiliser dans des fichiers CSS personnalisés ou avec toute autre [technique de style Astro](https://docs.astro.build/en/guides/styling/).
Si vous souhaitez ajouter une police personnalisée à votre site Starlight, vous pouvez configurer les polices à utiliser dans des fichiers CSS personnalisés ou avec toute autre [technique de style Astro](https://docs.astro.build/fr/guides/styling/).

### Configurer les polices

Si vous avez déjà des fichiers de polices, suivez le [guide de configuration local](#configurer-les-polices-localement).
Si vous avez déjà des fichiers de polices, suivez le [guide de configuration locale](#configurer-les-polices-localement).
Pour utiliser Google Fonts, suivez le [Guide de configuration de Fontsource](#configurer-les-polices-avec-fontsource).

#### Configurer les polices localement
Expand Down Expand Up @@ -391,8 +391,8 @@ Il fournit des modules npm que vous pouvez installer pour les polices que vous s
1. Trouvez la police que vous souhaitez utiliser dans le [catalogue de Fontsource](https://fontsource.org/).
Cet exemple utilisera [IBM Plex Serif](https://fontsource.org/fonts/ibm-plex-serif).

2. Installez le package pour la police choisie.
Vous pouvez trouver le nom du package en cliquant sur "Installer" sur la page de police Fontsource.
2. Installez le paquet pour la police choisie.
Vous pouvez trouver le nom du paquet en cliquant sur « Installer » sur la page de police Fontsource.

<Tabs syncKey="pkg">

Expand Down
Loading
Loading