Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
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
70 changes: 51 additions & 19 deletions src/content/docs/fr/guides/integrations-guide/alpinejs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -90,37 +90,69 @@ export default defineConfig({
});
```

## Utilisation
## Options de Configuration

Une fois l'intégration installée, vous pouvez utiliser les directives et la syntaxe [Alpine.js](https://alpinejs.dev/) dans n'importe quel composant Astro. Le script Alpine.js est automatiquement ajouté et activé sur chaque page de votre site web.
### `entrypoint`

Consultez notre [Documentation d'intégration Astro][astro-integration] pour plus d'informations sur les intégrations.
Vous pouvez étendre Alpine en mettant l'option `entrypoint` à un spécificateur d'importation relatif à la racine (par exemple `entrypoint : "/src/entrypoint"`).

## Limites
L'exportation par défaut de ce fichier doit être une fonction qui accepte une instance Alpine avant de démarrer. Cela permet d'utiliser des directives personnalisées, des plugins et d'autres personnalisations pour des cas d'utilisation avancés.

L'intégration d'Alpine.js ne vous permet pas de contrôler la manière dont le script est chargé ou initialisé. Si vous avez besoin de ce contrôle, envisagez [d'installer et d'utiliser Alpine.js manuellement](https://alpinejs.dev/essentials/installation). Astro prend en charge toutes les instructions d'installation manuelle d'Alpine.js officiellement documentées, en utilisant les balises `<script>` à l'intérieur d'un composant Astro.
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
import alpine from '@astrojs/alpinejs';

**Il n'est actuellement pas possible d'[étendre Alpine.js](https://alpinejs.dev/advanced/extending) en utilisant ce composant.** Si vous avez besoin de cette fonctionnalité, envisagez de suivre [le manuel d'installation d'Alpine.js](https://alpinejs.dev/essentials/installation) au lieu d'utiliser une balise de script Astro :
export default defineConfig({
// ...
integrations: [alpine({ entrypoint: '/src/entrypoint' })],
});
```

```astro title="src/pages/index.astro"
---
---
```js title="src/entrypoint.ts"
import type { Alpine } from 'alpinejs'
import intersect from '@alpinejs/intersect'

<!-- Exemple : Charger AlpineJS sur une seule page. -->
<script>
import Alpine from 'alpinejs';
export default (Alpine: Alpine) => {
Alpine.plugin(intersect)
}
```

## Utilisation

Une fois l'intégration installée, vous pouvez utiliser les directives et la syntaxe [Alpine.js](https://alpinejs.dev/) dans n'importe quel composant Astro. Le script Alpine.js est automatiquement ajouté et activé sur chaque page de votre site web. Ajoutez les scripts du plugin à la page `<head>`.

// Optionnel: Étendre Alpine.js
// Alpine.directive('foo', ...)
L'exemple suivant ajoute le plugin [Alpine's Collapse](https://alpinejs.dev/plugins/collapse) pour développer et réduire le texte d'un paragraphe.

window.Alpine = Alpine;
Alpine.start();
</script>
```astro title="src/pages/index.astro" ins={6} ins="x-collapse"
---
---
<html>
<head>
<!-- ... -->
<script defer src="https://cdn.jsdelivr.net/npm/@alpinejs/collapse@3.x.x/dist/cdn.min.js"></script>
</head>
<body>
<!-- ... -->
<div x-data="{ expanded: false }">
<button @click="expanded = ! expanded">Toggle Content</button>

<p id="foo" x-show="expanded" x-collapse>
Lorem ipsum
</p>
</div>
</body>
</html>
```

## Configuration
## Intellisense pour TypeScript

L'intégration d'Alpine.js ne prend pas en charge les configurations personnalisées pour le moment.
L'intégration `@astrojs/alpine` ajoute `Alpine` à l'objet global de la fenêtre. Pour l'autocomplétion de l'IDE, ajoutez ce qui suit à votre `src/env.d.ts` :

```ts title="src/env.d.ts"
interface Window {
Alpine: import('alpinejs').Alpine;
}
```

## Exemples

Expand Down
8 changes: 3 additions & 5 deletions src/content/docs/fr/guides/integrations-guide/tailwind.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ Si vous n'aimez pas ces paramètres prédéfinis, vous pouvez [personnaliser le

Tailwind est également un excellent choix pour ajouter des styles aux composants React, Preact ou Solid, qui ne supportent pas la balise `<style>` dans le fichier du composant.

:::note
Il est généralement déconseillé d'utiliser à la fois Tailwind et une autre méthode de style (par exemple Styled Components) dans le même fichier.
:::
Note: Il est généralement déconseillé d'utiliser à la fois Tailwind et une autre méthode de style (par exemple Styled Components) dans le même fichier.

## Installation

Expand Down Expand Up @@ -152,7 +150,7 @@ export default defineConfig({
integrations: [
tailwind({
// Exemple : Fournir un chemin personnalisé vers un fichier de configuration Tailwind
configFile: './custom-config.cjs',
configFile: './custom-config.mjs',
}),
],
});
Expand Down Expand Up @@ -228,7 +226,7 @@ error The `text-special` class does not exist. If `text-special` is a custom c

[Au lieu d'utiliser les directives `@layer` dans une feuille de style globale](https://tailwindcss.com/docs/functions-and-directives#using-apply-with-per-component-css), définissez vos propres styles en ajoutant un plugin à votre configuration Tailwind pour résoudre ce problème :

```js title="tailwind.config.cjs"
```js title="tailwind.config.mjs"
export default {
// ...
plugins: [
Expand Down
18 changes: 9 additions & 9 deletions src/content/docs/fr/guides/prefetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Les temps de chargement des pages jouent un rôle important dans la convivialit

Vous pouvez activer le prefetching avec la configuration `prefetch` :

```js title="astro.config.js" ins={4}
```js title="astro.config.mjs" ins={4}
import { defineConfig } from 'astro/config';

export default defineConfig({
Expand Down Expand Up @@ -53,9 +53,9 @@ Chaque stratégie est finement ajustée pour ne précharger que lorsque c'est n

### Stratégie de prefetch par défaut

La stratégie de prefetch par défaut lors de l'ajout de l'attribut `data-astro-prefetch` est `hover`. Pour la changer, vous pouvez configurer [`prefetch.defaultStrategy`](/fr/reference/configuration-reference/#prefetchdefaultstrategy) dans votre fichier `astro.config.js` :
La stratégie de prefetch par défaut lors de l'ajout de l'attribut `data-astro-prefetch` est `hover`. Pour la changer, vous pouvez configurer [`prefetch.defaultStrategy`](/fr/reference/configuration-reference/#prefetchdefaultstrategy) dans votre fichier `astro.config.mjs` :

```js title="astro.config.js" ins={4-6}
```js title="astro.config.mjs" ins={4-6}
import { defineConfig } from 'astro/config';

export default defineConfig({
Expand All @@ -69,7 +69,7 @@ export default defineConfig({

Si vous voulez récupérer tous les liens, y compris ceux qui n'ont pas l'attribut `data-astro-prefetch`, vous pouvez mettre [`prefetch.prefetchAll`](/fr/reference/configuration-reference/#prefetchprefetchall) à `true`:

```js title="astro.config.js" ins={4-6}
```js title="astro.config.mjs" ins={4-6}
import { defineConfig } from 'astro/config';

export default defineConfig({
Expand Down Expand Up @@ -130,9 +130,9 @@ MVeillez à n'importer `prefetch()` que dans les scripts côté client, car il s

Lorsque vous utilisez [les transitions de vue](/fr/guides/view-transitions/) sur une page, le prefetch est également activé par défaut. Il définit une configuration par défaut de `{ prefetchAll : true }` qui active le [prefetch pour tous les liens](#prefetch-de-tous-les-liens-par-défaut) sur la page.

Vous pouvez personnaliser la configuration de prefetch dans `astro.config.js` pour remplacer la configuration par défaut. Par exemple :
Vous pouvez personnaliser la configuration de prefetch dans `astro.config.mjs` pour remplacer la configuration par défaut. Par exemple :

```js title="astro.config.js"
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';

export default defineConfig({
Expand All @@ -156,9 +156,9 @@ export default defineConfig({

L'intégration `@astrojs/prefetch` a été dépréciée dans la version 3.5.0 et sera finalement entièrement supprimée. Utilisez les instructions suivantes pour migrer vers le prefetching intégré d'Astro qui remplace cette intégration.

1. Supprimez l'intégration `@astrojs/prefetch` et activez la configuration `prefetch` dans `astro.config.js` :
1. Supprimez l'intégration `@astrojs/prefetch` et activez la configuration `prefetch` dans `astro.config.mjs` :

```js title="astro.config.js" ins={6} del={2,5}
```js title="astro.config.mjs" ins={6} del={2,5}
import { defineConfig } from 'astro/config';
import prefetch from '@astrojs/prefetch';

Expand Down Expand Up @@ -190,4 +190,4 @@ L'intégration `@astrojs/prefetch` a été dépréciée dans la version 3.5.0 et
<a href="/about" data-astro-prefetch="hover">
```

- L'option `throttles` de `@astrojs/prefetch` n'est plus nécessaire car la nouvelle fonctionnalité prefetch va automatiquement planifier et prefetch de manière optimale.
- L'option `throttles` de `@astrojs/prefetch` n'est plus nécessaire car la nouvelle fonctionnalité prefetch va automatiquement planifier et prefetch de manière optimale.
8 changes: 4 additions & 4 deletions src/content/docs/fr/install/manual.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ import FileTree from '~/components/FileTree.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
import ReadMore from '~/components/ReadMore.astro'

Ce guide vous montrera comment installer et configurer manuellement un nouveau projet Astro si vous préférez ne pas utiliser [l'outil de ligne de commande automatique](/fr/install/auto/).
Ce guide vous montrera comment installer et configurer manuellement un nouveau projet Astro.

##### Vous préférez une méthode plus rapide pour commencer?

<Button href="/fr/install/auto/">Essayez l'assistant de CLI `create astro` →</Button>
:::tip[Vous préférez une méthode plus rapide pour commencer ?]
Suivez plutôt l'assistant [créer l'assistant CLI astr](/fr/install/auto/).
:::

#### Prérequis

Expand Down
2 changes: 2 additions & 0 deletions src/content/docs/fr/reference/error-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,8 +69,10 @@ La référence suivante est une liste complète des erreurs que vous pouvez renc
- [**InvalidGlob**](/fr/reference/errors/invalid-glob/)<br/>Pattern globale invalide.
- [**FailedToFindPageMapSSR**](/fr/reference/errors/failed-to-find-page-map-ssr/)<br/>Astro n'a pas pu trouver la bonne page à rendre
- [**MissingLocale**](/fr/reference/errors/missing-locale/)<br/>Le paramètre local fourni n'existe pas.
- [**MissingIndexForInternationalization**](/fr/reference/errors/missing-index-for-internationalization/)<br/>Page d'index non trouvée.
- [**CantRenderPage**](/fr/reference/errors/cant-render-page/)<br/>Astro ne peut pas rendre la route.
- [**UnhandledRejection**](/fr/reference/errors/unhandled-rejection/)<br/>Rejet non géré
- [**i18nNotEnabled**](/fr/reference/errors/i18n-not-enabled/)<br/>i18n non activé
## Erreurs de CSS

- [**UnknownCSSError**](/fr/reference/errors/unknown-csserror/)<br/>Erreur CSS inconnue.
Expand Down
3 changes: 1 addition & 2 deletions src/content/docs/fr/reference/errors/astro-glob-no-match.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,8 @@ title: Astro.glob() ne correspond à aucun fichier
i18nReady: true
githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/errors/errors-data.ts
---
import DontEditWarning from '~/components/DontEditWarning.astro'

> **AstroGlobNoMatch**: `Astro.glob(GLOB_STR)` did not return any matching files. Check the pattern for typos.
> **AstroGlobNoMatch**: `Astro.glob(GLOB_STR)` did not return any matching files.

## Qu'est-ce qui ne va pas ?
`Astro.glob()` n'a retourné aucun fichier correspondant. Il se peut qu'il y ait une faute de frappe dans le pattern glob.
Expand Down
30 changes: 30 additions & 0 deletions src/content/docs/fr/reference/errors/i18n-not-enabled.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: i18n non activé
i18nReady: true
githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/errors/errors-data.ts





---

> **i18nNotEnabled**: The `astro:i18n` module can not be used without enabling i18n in your Astro config.

## Qu'est-ce qui ne va pas ?
Le module `astro:i18n` ne peut pas être utilisé sans activer i18n dans votre configuration Astro. Pour activer i18n, ajoutez une locale par défaut et une liste de locales supportées à votre configuration Astro :
```js
import { defineConfig } from 'astro'
export default defineConfig({
i18n: {
defaultLocale: 'en',
locales: ['en', 'fr'],
},
})
```

Pour plus d'informations sur la prise en charge de l'internationalisation dans Astro, voir notre [Guide de l'internationalisation](/fr/guides/internationalization/).

**Voir aussi:**
- [Internationalization](/fr/guides/internationalization/)
- [Référence de configuration `i18n](/fr/reference/configuration-reference/#i18n)
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: Page Index non trouvée.
i18nReady: true
githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/errors/errors-data.ts





---

> **MissingIndexForInternationalization**: Could not find index page. A root index page is required in order to create a redirect to the index URL of the default locale. (`/DEFAULT_LOCALE`)
## Qu'est-ce qui ne va pas ?
Astro n'a pas pu trouver l'URL d'index de votre site web. Une page d'index est nécessaire pour qu'Astro puisse créer une redirection de la page d'index principale vers la page d'index localisée de la locale par défaut lors de l'utilisation de l'option [`i18n.routing.prefixDefaultLocale`](/fr/reference/configuration-reference/#i18nroutingprefixdefaultlocale).

**Voir aussi:**
- [Internationalization](/fr/guides/internationalization/#routing)
- [`i18n.routing` Configuration Reference](/fr/reference/configuration-reference/#i18nrouting)

3 changes: 3 additions & 0 deletions src/content/docs/fr/tutorial/5-astro-api/3.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ import MultipleChoice from '~/components/tutorial/MultipleChoice.astro';
import Option from '~/components/tutorial/Option.astro';
import PreCheck from '~/components/tutorial/PreCheck.astro';



Maintenant que vous avez des pages individuelles pour chaque étiquette, créons des liens vers elles.

<PreCheck>
Expand Down Expand Up @@ -104,6 +106,7 @@ Vous pourriez le faire, mais alors vous devriez revenir sur ce fichier et mettre

Heureusement, vous savez déjà comment récupérer les données de tous vos fichiers Markdown en une seule ligne de code, puis renvoyer une liste de toutes vos étiquettes.


1. Dans `src/pages/tags/index.astro`, ajoutez la ligne de code au script frontmatter qui donnera à votre page accès aux données de chaque fichier de blog `.md`.

<details>
Expand Down
21 changes: 18 additions & 3 deletions src/content/docs/fr/tutorial/6-islands/1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ import Spoiler from '~/components/Spoiler.astro';
import MultipleChoice from '~/components/tutorial/MultipleChoice.astro';
import Option from '~/components/tutorial/Option.astro';
import PreCheck from '~/components/tutorial/PreCheck.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';


Utilisez un composant Preact pour accueillir vos visiteurs avec un message de bienvenue sélectionné au hasard !
Expand All @@ -28,9 +29,23 @@ Utilisez un composant Preact pour accueillir vos visiteurs avec un message de bi

2. Ajoutez la possibilité d'utiliser des composants Preact dans votre projet Astro avec une seule commande :

```shell
npx astro add preact
```
<PackageManagerTabs>
<Fragment slot="npm">
```sh
npx astro add preact
```
</Fragment>
<Fragment slot="pnpm">
```sh
pnpm astro add preact
```
</Fragment>
<Fragment slot="yarn">
```sh
yarn astro add preact
```
</Fragment>
</PackageManagerTabs>

3. Suivez les instructions de la ligne de commande pour confirmer l'ajout de Preact à votre projet.

Expand Down
3 changes: 2 additions & 1 deletion src/content/docs/fr/tutorial/6-islands/2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ import MultipleChoice from '~/components/tutorial/MultipleChoice.astro';
import Option from '~/components/tutorial/Option.astro';
import PreCheck from '~/components/tutorial/PreCheck.astro';



Maintenant que vous savez comment créer des îles Astro pour des éléments interactifs, n'oubliez pas que vous pouvez aller assez loin avec seulement du JavaScript et du CSS !

Construisons une icône cliquable pour permettre à vos utilisateurs de basculer entre le mode clair ou sombre en utilisant une autre balise `<script>` pour l'interactivité... sans envoyer de JavaScript de framework au navigateur.
Expand Down Expand Up @@ -42,7 +44,6 @@ Construisons une icône cliquable pour permettre à vos utilisateurs de basculer
}
.sun { fill: black; }
.moon { fill: transparent; }


:global(.dark) .sun { fill: transparent; }
:global(.dark) .moon { fill: white; }
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/fr/tutorials/add-content-collections.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Tutoriel - Étendre avec les collections de contenu
description: >-
Convertir le code du didacticiel Construire un blog du routage basé sur les fichiers aux collections de contenu.
description: Convertir le code du didacticiel Construire un blog du routage basé sur les fichiers aux collections de contenu.

i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
Expand Down