Skip to content

Commit

Permalink
i18n(fr): fix tutorial/5-astro-api wording (#9464)
Browse files Browse the repository at this point in the history
In French and in this context, `tag` should be translated with `étiquette`
and not with `balise`. Also, this word is mostly used in `3.mdx` so we should
be consistent.

Co-authored-by: Yan <[email protected]>
  • Loading branch information
ArmandPhilippot and yanthomasdev authored Sep 23, 2024
1 parent 12c2514 commit da13ca6
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 28 deletions.
44 changes: 22 additions & 22 deletions src/content/docs/fr/tutorial/5-astro-api/2.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
type: tutorial
title: Générer des pages de balises
title: Générer des pages d'étiquettes
description: |-
Tutoriel : Construisez votre premier blog Astro —
Utilisez getStaticPaths() pour créer plusieurs pages (routes) en une seule fois
Expand Down Expand Up @@ -45,13 +45,13 @@ Vous pouvez créer des ensembles entiers de pages dynamiquement en utilisant des
const { tag } = Astro.params;
---
<BaseLayout pageTitle={tag}>
<p>Articles marqués avec {tag}</p>
<p>Articles étiquetés avec {tag}</p>
</BaseLayout>
```

La fonction `getStaticPaths` retourne un tableau de routes de page, et toutes les pages à ces routes utiliseront le même modèle défini dans le fichier.
La fonction `getStaticPaths` retourne un tableau de routes de page, et toutes les pages correspondant à ces routes utiliseront le même modèle défini dans le fichier.

2. Si vous avez personnalisé vos billets de blog, remplacez les valeurs individuelles des balises (par exemple, "astro", "succès", "communauté", etc.) par les balises utilisées dans vos propres billets.
2. Si vous avez personnalisé vos billets de blog, remplacez les valeurs individuelles des balises (par exemple, « astro », « succès », « communauté », etc.) par les balises utilisées dans vos propres billets.

3. Assurez-vous que chaque billet de blog contient au moins une balise, écrite sous forme de tableau, par exemple `tags: ["blogging"]`.

Expand Down Expand Up @@ -87,7 +87,7 @@ Vous pouvez créer des ensembles entiers de pages dynamiquement en utilisant des
---
```

2. Filtrez votre liste de billets pour inclure uniquement les billets contenant la propre balise de la page.
2. Filtrez votre liste de billets pour inclure uniquement les billets contenant l'étiquette de cette page.

```astro title="src/pages/tags/[tag].astro" ins={4}
---
Expand All @@ -97,11 +97,11 @@ Vous pouvez créer des ensembles entiers de pages dynamiquement en utilisant des
---
```

3. Vous pouvez maintenant mettre à jour votre modèle HTML pour afficher une liste de chaque billet de blog contenant la balise de la page. Ajoutez le code suivant à `[tag].astro` :
3. Vous pouvez maintenant mettre à jour votre modèle HTML pour afficher une liste de chaque billet de blog contenant l'étiquette de cette page. Ajoutez le code suivant à `[tag].astro` :

```astro title="src/pages/tags/[tag].astro" ins={3-5}
<BaseLayout pageTitle={tag}>
<p>Articles marqués avec {tag}</p>
<p>Articles étiquetés avec {tag}</p>
<ul>
{filteredPosts.map((post) => <li><a href={post.url}>{post.frontmatter.title}</a></li>)}
</ul>
Expand All @@ -112,15 +112,15 @@ Vous pouvez créer des ensembles entiers de pages dynamiquement en utilisant des

```astro title="src/pages/tags/[tag].astro" del={4} ins={5}
<BaseLayout pageTitle={tag}>
<p>Articles marqués avec {tag}</p>
<p>Articles étiquetés avec {tag}</p>
<ul>
{filteredPosts.map((post) => <li><a href={post.url}>{post.frontmatter.title}</a></li>)}
{filteredPosts.map((post) => <BlogPost url={post.url} title={post.frontmatter.title}/>)}
</ul>
</BaseLayout>
```

5. Vérifiez votre aperçu de navigateur pour vos pages de balises individuelles, et vous devriez maintenant voir une liste de tous vos billets de blog contenant cette balise particulière.
5. Vérifiez votre aperçu de navigateur pour chacune de vos pages d'étiquette, et vous devriez maintenant voir une liste de tous vos billets de blog contenant cette étiquette.
</Steps>

<Box icon="question-mark">
Expand All @@ -136,7 +136,7 @@ Pour chacun des éléments suivants, indiquez si le code est écrit **à l'inté
<Option>à l'extérieur de `getStaticPaths`</Option>
</MultipleChoice>

2. La liste des routes à générer (retournée) par `getStaticPaths()`
2. La liste des routes à générer (retourner) par `getStaticPaths()`

<MultipleChoice>
<Option isCorrect>à l'intérieur de `getStaticPaths`</Option>
Expand All @@ -158,23 +158,23 @@ Pour recevoir des informations dans le modèle HTML d'une route de page, écrive
:::


## JavaScript avancé : Générer des pages à partir de balises existantes
## JavaScript avancé : Générer des pages à partir d'étiquettes existantes

Vos pages de balises sont désormais définies statiquement dans `[tag].astro`. Si vous ajoutez une nouvelle balise à un billet de blog, vous devrez également revenir sur cette page et mettre à jour vos routes de page.
Vos pages d'étiquettes sont désormais définies statiquement dans `[tag].astro`. Si vous ajoutez une nouvelle balise à un billet de blog, vous devrez également revenir sur cette page et mettre à jour vos routes de page.

L'exemple suivant montre comment remplacer votre code sur cette page par du code qui recherchera automatiquement et générera des pages pour chaque balise utilisée dans vos billets de blog.
L'exemple suivant montre comment remplacer votre code sur cette page par du code qui recherchera automatiquement et générera des pages pour chaque étiquette utilisée dans vos billets de blog.

:::note
Même si cela semble difficile, vous pouvez essayer de suivre les étapes pour construire vous-même cette fonction ! Si vous ne souhaitez pas suivre le code JavaScript requis pour le moment, vous pouvez passer à la [version finale du code](#code-final) et l'utiliser directement dans votre projet, en remplaçant le contenu existant.
Même si cela semble difficile, vous pouvez essayer de suivre les étapes pour construire vous-même cette fonction ! Si vous ne souhaitez pas parcourir le code JavaScript requis pour le moment, vous pouvez passer à la [version finale du code](#code-final) et l'utiliser directement dans votre projet, en remplaçant le contenu existant.
:::

<Steps>

1. Vérifiez que tous vos billets de blog contiennent des balises
1. Vérifiez que tous vos billets de blog contiennent des étiquettes

Revisitez chacune de vos pages Markdown existantes et assurez-vous que chaque billet contient un tableau `tags` dans son frontmatter. Même si vous n'avez qu'une seule balise, elle doit toujours être écrite sous forme de tableau, par exemple `tags: ["blogging"]`.
Revisitez chacune de vos pages Markdown existantes et assurez-vous que chaque billet contient un tableau `tags` dans son frontmatter. Même si vous n'avez qu'une seule étiquette, elle doit toujours être écrite sous forme de tableau, par exemple `tags: ["blogging"]`.

2. Créez un tableau de toutes vos balises existantes
2. Créez un tableau de toutes vos étiquettes existantes

Ajoutez le code suivant pour obtenir une liste de toutes les balises utilisées dans vos billets de blog.

Expand All @@ -194,7 +194,7 @@ Même si cela semble difficile, vous pouvez essayer de suivre les étapes pour c

Il est normal que cela ne soit pas quelque chose que vous auriez écrit vous-même pour le moment !

Elle parcourt chaque billet Markdown, un par un, et combine chaque tableau de balises en un seul tableau plus grand. Ensuite, elle crée un nouvel ensemble (`Set`) à partir de toutes les balises individuelles trouvées (pour ignorer les valeurs répétées). Enfin, elle transforme cet ensemble en un tableau (sans duplications) que vous pouvez utiliser pour afficher une liste de balises sur votre page.
Elle parcourt chaque billet Markdown, un par un, et combine chaque tableau d'étiquettes en un seul tableau plus grand. Ensuite, elle crée un nouvel ensemble (`Set`) à partir de toutes les étiquettes individuelles trouvées (pour ignorer les valeurs répétées). Enfin, elle transforme cet ensemble en un tableau (sans duplications) que vous pouvez utiliser pour afficher une liste d'étiquettes sur votre page.
</details>

Vous avez maintenant un tableau `uniqueTags` avec les éléments `"astro"`, `"succès"`, `"communauté"`, `"blogging"`, `"obstables"`, `"apprentissage en public"`.
Expand All @@ -219,7 +219,7 @@ Même si cela semble difficile, vous pouvez essayer de suivre les étapes pour c
};
});
```
4. Une fonction `getStaticPaths` doit toujours renvoyer une liste d'objets contenant `params` (comment appeler chaque route de page) et éventuellement des `props` (données que vous souhaitez transmettre à ces pages). Plus tôt, vous avez défini chaque nom de balise que vous saviez être utilisé dans votre blog et avez transmis la liste complète des billets comme props à chaque page.
4. Une fonction `getStaticPaths` doit toujours renvoyer une liste d'objets contenant `params` (comment appeler chaque route de page) et éventuellement des `props` (les données que vous souhaitez transmettre à ces pages). Plus tôt, vous avez défini chaque nom d'étiquette que vous saviez être utilisé dans votre blog et avez transmis la liste complète des billets comme props à chaque page.

Maintenant, vous générez cette liste d'objets automatiquement en utilisant votre tableau `uniqueTags` pour définir chaque paramètre.
Expand Down Expand Up @@ -266,16 +266,16 @@ const { tag } = Astro.params;
const { posts } = Astro.props;
---
<BaseLayout pageTitle={tag}>
<p>Articles marqués avec {tag}</p>
<p>Articles étiquetés avec {tag}</p>
<ul>
{posts.map((post) => <BlogPost url={post.url} title={post.frontmatter.title}/>)}
</ul>
</BaseLayout>
```
Maintenant, vous devriez être en mesure de visiter n'importe laquelle de vos pages de balises dans votre aperçu de navigateur.
Maintenant, vous devriez être en mesure de visiter n'importe laquelle de vos pages d'étiquettes dans votre aperçu de navigateur.
Accédez à `http://localhost:4321/tags/communauté` et vous devriez voir une liste uniquement de vos billets de blog avec la balise `communauté`. De même, `http://localhost:4321/tags/learning%20in%20public` devrait afficher une liste des billets de blog marqués `apprentissage en public`.
Accédez à `http://localhost:4321/tags/communauté` et vous devriez voir une liste uniquement de vos billets de blog avec l'étiquette `communauté`. De même, `http://localhost:4321/tags/learning%20in%20public` devrait afficher une liste des billets de blog étiquetés avec `apprentissage en public`.
Dans la prochaine section, vous créerez des liens de navigation vers ces pages.
Expand Down
10 changes: 5 additions & 5 deletions src/content/docs/fr/tutorial/5-astro-api/3.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ Vous avez déjà affiché des éléments dans une liste à partir d'un tableau e
---
import BaseLayout from '../../layouts/BaseLayout.astro';
const tags = ['astro', 'blogging', 'apprentissage en public', 'succès', 'échecs', 'communauté']
const pageTitle = "Index des balises";
const pageTitle = "Index des étiquettes";
---
<BaseLayout pageTitle={pageTitle}>
<ul>
Expand Down Expand Up @@ -133,7 +133,7 @@ Heureusement, vous savez déjà comment récupérer les données de tous vos fic
```
</Steps>

## Créez votre liste de balises
## Créez votre liste d'étiquettes

Au lieu de créer des éléments dans une liste non ordonnée cette fois-ci, créez un `<p>` pour chaque élément, à l'intérieur d'un `<div>`. Le modèle devrait vous sembler familier !

Expand Down Expand Up @@ -199,7 +199,7 @@ Au lieu de créer des éléments dans une liste non ordonnée cette fois-ci, cr
</style>
```

3. Vérifiez l'aperçu dans le navigateur à `http://localhost:4321/tags` pour vérifier que vous avez de nouveaux styles et que chacune des balises de la page a un lien fonctionnel vers sa propre page de balise individuelle.
3. Vérifiez l'aperçu dans le navigateur à `http://localhost:4321/tags` pour vérifier que vous avez de nouveaux styles et que chacune des étiquettes de la page a un lien fonctionnel vers sa propre page d'étiquette individuelle.
</Steps>

### Validation du code
Expand All @@ -211,7 +211,7 @@ Voici à quoi devrait ressembler votre nouvelle page :
import BaseLayout from '../../layouts/BaseLayout.astro';
const allPosts = await Astro.glob('../posts/*.md');
const tags = [...new Set(allPosts.map((post) => post.frontmatter.tags).flat())];
const pageTitle = "Index des balises";
const pageTitle = "Index des étiquettes";
---
<BaseLayout pageTitle={pageTitle}>
<div class="tags">
Expand Down Expand Up @@ -327,7 +327,7 @@ Comment les autres propriétés (par exemple, le titre, l'auteur, etc.) sont-ell
<details>
<summary>Donnez-moi un autre indice !</summary>

Pour utiliser les propriétés (valeurs passées) d'un article de blog en Markdown dans votre mise en page, comme les balises, vous devez préfixer la valeur avec un certain mot.
Pour utiliser les propriétés (valeurs passées) d'un article de blog en Markdown dans votre mise en page, comme les étiquettes, vous devez préfixer la valeur avec un certain mot.

<details>
<summary>Affichez-moi le code !</summary>
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/tutorial/5-astro-api/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Maintenant que vous avez quelques billets de blog, utilisons l'API d'Astro pour

## Où allons-nous ?

Dans cette unité, vous allez donner un coup de fouet à votre blog avec une page d'index, des pages de balises et un flux RSS.
Dans cette unité, vous allez donner un coup de fouet à votre blog avec une page d'index, des pages d'étiquettes et un flux RSS.

En chemin, vous apprendrez à utiliser :
- `Astro.glob()` pour accéder aux données à partir des fichiers de votre projet
Expand Down

0 comments on commit da13ca6

Please sign in to comment.