You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/src/content/docs/fr/guides/authoring-content.mdx
+31-31Lines changed: 31 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,9 +3,9 @@ title: Création de contenu en Markdown
3
3
description: Un aperçu de la syntaxe Markdown prise en charge par Starlight.
4
4
---
5
5
6
-
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.
6
+
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.
7
7
8
-
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.
8
+
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.
9
9
10
10
## Frontmatter
11
11
@@ -23,12 +23,12 @@ Le contenu de la page suit le second `---`.
23
23
Chaque page doit inclure au moins un titre (`title`).
24
24
Consultez la [référence du frontmatter](/fr/reference/frontmatter/) pour connaître tous les champs disponibles et comment ajouter des champs personnalisés.
25
25
26
-
## Styles en ligne
26
+
## Styles incorporés au texte
27
27
28
-
Le texte peut être **gras**, _italique_, ou ~~barré~~.
28
+
Le texte peut être en **gras**, en_italique_, ou ~~barré~~.
29
29
30
30
```md
31
-
Le texte peut être **gras**, _italique_, ou ~~barré~~.
31
+
Le texte peut être en **gras**, en _italique_, ou ~~barré~~.
32
32
```
33
33
34
34
Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
@@ -37,25 +37,25 @@ Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
37
37
Vous pouvez [faire un lien vers une autre page](/fr/getting-started/).
38
38
```
39
39
40
-
Vous pouvez mettre en évidence le `code en ligne` à l'aide d'un astérisque.
40
+
Vous pouvez mettre en évidence le `code incorporé au texte` en utilisant des accents graves.
41
41
42
42
```md
43
-
Vous pouvez mettre en évidence le `code en ligne` à l'aide de barres de défilement.
43
+
Vous pouvez mettre en évidence le `code incorporé au texte` en utilisant des accents graves.
44
44
```
45
45
46
46
## Images
47
47
48
48
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/).
49
49
50
-
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.
50
+
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.
51
51
52
-

52
+

53
53
54
54
```md
55
-

55
+

56
56
```
57
57
58
-
Les chemins d'accès relatifs aux images sont également supportés pour les images stockées localement dans votre projet.
58
+
Les chemins d'accès relatifs aux images sont également pris en charge pour les images stockées localement dans votre projet.
59
59
60
60
```md
61
61
// src/content/docs/page-1.md
@@ -65,11 +65,11 @@ Les chemins d'accès relatifs aux images sont également supportés pour les ima
65
65
66
66
## En-têtes
67
67
68
-
Vous pouvez structurer le contenu à l'aide d'un titre. En Markdown, les titres sont indiqués par un nombre de `#` en début de ligne.
68
+
Vous pouvez structurer le contenu à l'aide d'en-têtes. En Markdown, les en-têtes sont indiqués par un certain nombre de `#` en début de ligne.
69
69
70
70
### Comment structurer le contenu d'une page dans Starlight
71
71
72
-
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>` :
72
+
Starlight est configuré pour utiliser automatiquement le titre de votre page comme en-tête de premier niveau et inclura un en-tête « 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 en-têtes de page à partir de `<h2>` :
73
73
74
74
```md
75
75
---
@@ -79,14 +79,14 @@ description: Comment utiliser Markdown dans Starlight
79
79
80
80
Cette page décrit comment utiliser Markdown dans Starlight.
81
81
82
-
## Styles en ligne
82
+
## Styles incorporés au texte
83
83
84
-
## Titres
84
+
## En-têtes
85
85
```
86
86
87
-
### Liens d'ancrage automatiques pour les titres
87
+
### Liens d'ancrage automatiques pour les en-têtes
88
88
89
-
L'utilisation de titres en Markdown vous donnera automatiquement des liens d'ancrage afin que vous puissiez accéder directement à certaines sections de votre page :
89
+
L'utilisation d'en-têtes en Markdown vous donnera automatiquement des liens d'ancrage afin que vous puissiez accéder directement à certaines sections de votre page :
90
90
91
91
```md
92
92
---
@@ -103,17 +103,17 @@ Je peux faire un lien vers [ma conclusion](#conclusion) plus bas sur la même pa
103
103
`https://my-site.com/page1/#introduction` renvoie directement à mon Introduction.
104
104
```
105
105
106
-
Les titres de niveau 2 (`<h2>`) et de niveau 3 (`<h3>`) apparaissent automatiquement dans la table des matières de la page.
106
+
Les en-têtes de niveau 2 (`<h2>`) et de niveau 3 (`<h3>`) apparaissent automatiquement dans la table des matières de la page.
107
107
108
-
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).
108
+
Pour en apprendre davantage sur la façon dont Astro traite les attributs `id` des en-têtes de section, consultez la [documentation d'Astro](https://docs.astro.build/fr/guides/markdown-content/#id-des-titres).
109
109
110
110
## Encarts
111
111
112
112
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.
113
113
114
114
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`.
115
115
116
-
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.
116
+
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.
117
117
118
118
### Encart de type note
119
119
@@ -179,7 +179,7 @@ Vos utilisateurs peuvent être plus productifs et trouver votre produit plus fac
179
179
180
180
- Navigation claire
181
181
- Thème de couleurs configurable par l'utilisateur
182
-
-[Support i18n](/fr/guides/i18n/)
182
+
-[Prise en charge i18n](/fr/guides/i18n/)
183
183
184
184
:::
185
185
@@ -193,21 +193,21 @@ Vos utilisateurs peuvent être plus productifs et trouver votre produit plus fac
193
193
194
194
- Navigation claire
195
195
- Thème de couleurs configurable par l'utilisateur
196
-
- [Support i18n](/fr/guides/i18n/)
196
+
- [Prise en charge i18n](/fr/guides/i18n/)
197
197
198
198
:::
199
199
```
200
200
201
-
## Blockquotes
201
+
## Blocs de citation
202
202
203
-
> Il s'agit d'une citation en bloc, couramment utilisée pour citer une autre personne ou un document.
203
+
> Il s'agit d'un bloc de citation, couramment utilisé pour citer une autre personne ou un document.
204
204
>
205
-
> Les guillemets sont indiqués par un `>` au début de chaque ligne.
205
+
> Les blocs de citation sont indiqués par un `>` au début de chaque ligne.
206
206
207
207
```md
208
-
> Il s'agit d'une citation en bloc, couramment utilisée pour citer une autre personne ou un document.
208
+
> Il s'agit d'un bloc de citation, couramment utilisé pour citer une autre personne ou un document.
209
209
>
210
-
> Les guillemets sont indiqués par un `>` au début de chaque ligne.
210
+
> Les blocs de citation sont indiqués par un `>` au début de chaque ligne.
211
211
```
212
212
213
213
## Blocs de code
@@ -235,7 +235,7 @@ var fun = function lang(l) {
235
235
### Fonctionnalités d'Expressive Code
236
236
237
237
Starlight utilise [Expressive Code](https://expressive-code.com/) pour étendre les possibilités de formatage des blocs de code.
238
-
Les plugins Expressive Code de marqueurs de texte et de cadres de fenêtre sont activés par défaut.
238
+
Les modules d'extension Expressive Code de marqueurs de texte et de cadres de fenêtre sont activés par défaut.
239
239
L'affichage des blocs de code peut être configuré à l'aide de [l'option de configuration `expressiveCode`](/fr/reference/configuration/#expressivecode) de Starlight.
240
240
241
241
#### Marqueurs de texte
@@ -248,7 +248,7 @@ Du texte et des lignes entières peuvent être marqués à l'aide du marqueur pa
248
248
249
249
Expressive Code fournit plusieurs options pour personnaliser l'apparence visuelle de vos exemples de code.
250
250
Beaucoup d'entre elles peuvent être combinées pour obtenir des exemples de code très illustratifs.
251
-
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.
251
+
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.
252
252
Certaines des options les plus courantes sont présentées ci-dessous :
253
253
254
254
-[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) :
@@ -548,11 +548,11 @@ Starlight prend en charge toutes les autres syntaxes de rédaction Markdown, tel
548
548
549
549
## Configuration avancée de Markdown et MDX
550
550
551
-
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.
551
+
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.
552
552
553
553
## Markdoc
554
554
555
-
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.
555
+
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.
0 commit comments