Skip to content

Commit f215549

Browse files
authored
i18n(fr): update various content layer related pages (#2710)
1 parent 3fe09c1 commit f215549

File tree

6 files changed

+48
-34
lines changed

6 files changed

+48
-34
lines changed

‎docs/src/content/docs/fr/guides/i18n.mdx

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -188,16 +188,17 @@ Vous pouvez fournir des traductions pour les langues supplémentaires que vous s
188188

189189
<Steps>
190190

191-
1. Configurez la collection de contenus `i18n` dans `src/content/config.ts` si elle n'est pas déjà configurée :
191+
1. Configurez la collection de contenus `i18n` dans `src/content.config.ts` si elle n'est pas déjà configurée :
192192

193-
```diff lang="js" ins=/, (i18nSchema)/
194-
// src/content/config.ts
193+
```diff lang="js" ins=/, (i18nLoader|i18nSchema)/
194+
// src/content.config.ts
195195
import { defineCollection } from 'astro:content';
196+
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
196197
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
197198

198199
export const collections = {
199-
docs: defineCollection({ schema: docsSchema() }),
200-
+ i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
200+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
201+
+ i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
201202
};
202203
```
203204

@@ -257,14 +258,15 @@ Ajoutez des clés personnalisées aux dictionnaires de traduction de votre site
257258
Dans l'exemple suivant, une nouvelle clé optionnelle `custom.label` est ajoutée aux clés par défaut :
258259

259260
```diff lang="js"
260-
// src/content/config.ts
261+
// src/content.config.ts
261262
import { defineCollection, z } from 'astro:content';
263+
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
262264
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
263265

264266
export const collections = {
265-
docs: defineCollection({ schema: docsSchema() }),
267+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
266268
i18n: defineCollection({
267-
type: 'data',
269+
loader: i18nLoader(),
268270
schema: i18nSchema({
269271
+ extend: z.object({
270272
+ 'custom.label': z.string().optional(),
@@ -274,7 +276,7 @@ export const collections = {
274276
};
275277
```
276278

277-
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.
279+
Consultez [« Définir un schéma de collection de contenus »](https://docs.astro.build/fr/guides/content-collections/#définition-dun-schéma-de-collection) dans la documentation d'Astro pour en savoir plus sur les schémas de collection de contenus.
278280

279281
## Utiliser les traductions de l'interface utilisateur
280282

‎docs/src/content/docs/fr/guides/project-structure.mdx

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ description: Apprenez à organiser les fichiers dans votre projet Starlight.
55

66
Ce guide vous montrera comment un projet Starlight est organisé et ce que font les différents fichiers de votre projet.
77

8-
Les projets Starlight suivent généralement la même structure de fichiers et de répertoires que les autres projets Astro. Voir [la documentation sur la structure des projets Astro](https://docs.astro.build/fr/core-concepts/project-structure/) pour plus de détails.
8+
Les projets Starlight suivent généralement la même structure de fichiers et de répertoires que les autres projets Astro. Voir [la documentation sur la structure des projets Astro](https://docs.astro.build/fr/basics/project-structure/) pour plus de détails.
99

1010
## Fichiers et répertoires
1111

1212
- `astro.config.mjs` — Le fichier de configuration d'Astro ; inclut l'intégration et la configuration de Starlight.
13-
- `src/content/config.ts` — Fichier de configuration des collections de contenu ; ajoute les schémas de la matière première de Starlight à votre projet.
13+
- `src/content.config.ts` — Fichier de configuration des collections de contenu ; ajoute les schémas de la matière première de Starlight à votre projet.
1414
- `src/content/docs/` — Fichiers de contenu. Starlight transforme chaque fichier `.md`, `.mdx` ou `.mdoc` de ce répertoire en une page de votre site.
1515
- `src/content/i18n/` (optionnel) — Données de traduction pour prendre en charge l'[internationalisation](/fr/guides/i18n/).
1616
- `src/` — Autre code source et fichiers (composants, styles, images, etc.) pour votre projet.
@@ -39,8 +39,7 @@ import { FileTree } from '@astrojs/starlight/components';
3939
- 01-getting-started.md
4040
- 02-advanced.md
4141
- index.mdx
42-
- config.ts
43-
- env.d.ts
42+
- content.config.ts
4443
- astro.config.mjs
4544
- package.json
4645
- tsconfig.json

‎docs/src/content/docs/fr/guides/site-search.mdx

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -126,16 +126,17 @@ Ajoutez des traductions de l'interface utilisateur de la modale pour votre langu
126126

127127
1. Étendez la définition de la collection de contenus `i18n` de Starlight avec le schéma DocSearch dans `src/content/config.ts` :
128128

129-
```js ins={4} ins=/{ extend: .+ }/
130-
// src/content/config.ts
129+
```js ins={5} ins=/{ extend: .+ }/
130+
// src/content.config.ts
131131
import { defineCollection } from 'astro:content';
132+
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
132133
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
133134
import { docSearchI18nSchema } from '@astrojs/starlight-docsearch/schema';
134135

135136
export const collections = {
136-
docs: defineCollection({ schema: docsSchema() }),
137+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
137138
i18n: defineCollection({
138-
type: 'data',
139+
loader: i18nLoader(),
139140
schema: i18nSchema({ extend: docSearchI18nSchema() }),
140141
}),
141142
};

‎docs/src/content/docs/fr/manual-setup.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -62,20 +62,24 @@ Retrouvez toutes les options disponibles dans la [référence de configuration S
6262

6363
### Configurer les collections de contenu
6464

65-
Starlight s'appuie sur les [collections de contenu d'Astro](https://docs.astro.build/fr/guides/content-collections/), qui sont configurées dans le fichier `src/content/config.ts`.
65+
Starlight s'appuie sur les [collections de contenu d'Astro](https://docs.astro.build/fr/guides/content-collections/), qui sont configurées dans le fichier `src/content.config.ts`.
6666

67-
Créez ou mettez à jour le fichier de configuration du contenu, en ajoutant une collection `docs` qui utilise le schéma `docsSchema` de Starlight :
67+
Créez ou mettez à jour le fichier de configuration du contenu, en ajoutant une collection `docs` qui utilise les `docsLoader` et `docsSchema` de Starlight :
6868

69-
```js ins={3,6}
70-
// src/content/config.ts
69+
```js ins={3-4,7}
70+
// src/content.config.ts
7171
import { defineCollection } from 'astro:content';
72+
import { docsLoader } from '@astrojs/starlight/loaders';
7273
import { docsSchema } from '@astrojs/starlight/schema';
7374

7475
export const collections = {
75-
docs: defineCollection({ schema: docsSchema() }),
76+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
7677
};
7778
```
7879

80+
Starlight supporte également [l'option `legacy.collections`](https://docs.astro.build/fr/reference/legacy-flags/) où les collections sont gérées en utilisant l'implémentation de collections de contenu héritée.
81+
Celà est utile si vous avez un projet Astro existant et que vous ne pouvez pas apporter de modifications aux collections pour utiliser un chargeur.
82+
7983
### Ajouter du contenu
8084

8185
Starlight est maintenant configuré et il est temps d'ajouter du contenu !
@@ -125,6 +129,6 @@ import { FileTree } from '@astrojs/starlight/components';
125129

126130
### Utiliser Starlight avec SSR
127131

128-
Pour activer le SSR, suivez le guide [« Adaptateurs de rendu à la demande »](https://docs.astro.build/fr/guides/server-side-rendering/) dans la documentation d'Astro pour ajouter un adaptateur serveur à votre projet Starlight.
132+
Pour activer le SSR, suivez le guide [« Adaptateurs de rendu à la demande »](https://docs.astro.build/fr/guides/on-demand-rendering/) dans la documentation d'Astro pour ajouter un adaptateur serveur à votre projet Starlight.
129133

130134
Les pages de documentation générées par Starlight sont pré-rendues par défaut, quel que soit le mode de rendu de votre projet. Pour désactiver le pré-rendu de vos pages Starlight, définissez [l'option de configuration `prerender`](/fr/reference/configuration/#prerender) à `false`.

‎docs/src/content/docs/fr/reference/frontmatter.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ La description de la page est utilisée pour les métadonnées de la page et ser
3333

3434
**type**: `string`
3535

36-
Remplace le slug de la page. Consultez [« Définition d’un slug personnalisé »](https://docs.astro.build/fr/guides/content-collections/#d%C3%A9finition-dun-slug-personnalis%C3%A9e) dans la documentation d'Astro pour plus de détails.
36+
Remplace le slug de la page. Consultez [« Définition d’identifiants personnalisés »](https://docs.astro.build/fr/guides/content-collections/#définition-didentifiants-personnalisés) dans la documentation d'Astro pour plus de détails.
3737

3838
### `editUrl`
3939

@@ -397,19 +397,20 @@ sidebar:
397397

398398
## Personnaliser le schéma du frontmatter
399399

400-
Le schéma du frontmatter de la collection de contenus `docs` de Starlight est configuré dans `src/content/config.ts` en utilisant l'utilitaire `docsSchema()` :
400+
Le schéma du frontmatter de la collection de contenus `docs` de Starlight est configuré dans `src/content.config.ts` en utilisant l'utilitaire `docsSchema()` :
401401

402-
```ts {3,6}
403-
// src/content/config.ts
402+
```ts {4,7}
403+
// src/content.config.ts
404404
import { defineCollection } from 'astro:content';
405+
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
405406
import { docsSchema } from '@astrojs/starlight/schema';
406407

407408
export const collections = {
408-
docs: defineCollection({ schema: docsSchema() }),
409+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
409410
};
410411
```
411412

412-
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.
413+
Consultez [« Définir un schéma de collection de contenus »](https://docs.astro.build/fr/guides/content-collections/#définition-dun-schéma-de-collection) dans la documentation d'Astro pour en savoir plus sur les schémas de collection de contenus.
413414

414415
`docsSchema()` accepte les options suivantes :
415416

@@ -423,13 +424,15 @@ La valeur doit être un [schéma Zod](https://docs.astro.build/fr/guides/content
423424

424425
Dans l'exemple suivant, nous définissons un type plus strict pour `description` pour le rendre obligatoire et ajouter un nouveau champ `category` facultatif :
425426

426-
```ts {8-13}
427-
// src/content/config.ts
427+
```ts {10-15}
428+
// src/content.config.ts
428429
import { defineCollection, z } from 'astro:content';
430+
import { docsLoader } from '@astrojs/starlight/loaders';
429431
import { docsSchema } from '@astrojs/starlight/schema';
430432

431433
export const collections = {
432434
docs: defineCollection({
435+
loader: docsLoader(),
433436
schema: docsSchema({
434437
extend: z.object({
435438
// Rend un champ de base obligatoire au lieu de facultatif.
@@ -444,13 +447,15 @@ export const collections = {
444447

445448
Pour tirer parti de l'[utilitaire `image()` d'Astro](https://docs.astro.build/fr/guides/images/#images-in-content-collections), utilisez une fonction qui retourne votre extension de schéma :
446449

447-
```ts {8-13}
448-
// src/content/config.ts
450+
```ts {10-15}
451+
// src/content.config.ts
449452
import { defineCollection, z } from 'astro:content';
453+
import { docsLoader } from '@astrojs/starlight/loaders';
450454
import { docsSchema } from '@astrojs/starlight/schema';
451455

452456
export const collections = {
453457
docs: defineCollection({
458+
loader: docsLoader(),
454459
schema: docsSchema({
455460
extend: ({ image }) => {
456461
return z.object({

‎docs/src/content/docs/fr/reference/overrides.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,11 +69,14 @@ Pour les sites multilingues, cette valeur inclura la locale actuelle, par exempl
6969

7070
Le slug de la page généré à partir du nom du fichier du contenu.
7171

72+
Cette propriété est dépréciée et sera supprimée dans une version future de Starlight.
73+
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.
74+
7275
#### `id`
7376

7477
**Type :** `string`
7578

76-
L'identifiant unique de cette page basé sur le nom du fichier du contenu.
79+
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.
7780

7881
#### `isFallback`
7982

0 commit comments

Comments
 (0)