diff --git a/src/content/docs/fr/guides/integrations-guide/mdx.mdx b/src/content/docs/fr/guides/integrations-guide/mdx.mdx index 4a2e903ecaf28..351c1cb59eaaf 100644 --- a/src/content/docs/fr/guides/integrations-guide/mdx.mdx +++ b/src/content/docs/fr/guides/integrations-guide/mdx.mdx @@ -8,6 +8,7 @@ i18nReady: true --- import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' import ReadMore from '~/components/ReadMore.astro' +import Since from '~/components/Since.astro' Cette **[intégration Astro][astro-integration]** permet d'utiliser les composants [MDX](https://mdxjs.com/) et de créer des pages sous forme de fichiers `.mdx`. @@ -135,8 +136,8 @@ MDX ne permet pas de fournir les plugins remark et rehype sous la forme d'une ch ### `extendMarkdownConfig` -* **Type:** `boolean` -* **Default:** `true` +* **Type :** `boolean` +* **Défaut :** `true` MDX étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#markdown-options). Pour remplacer certaines options, vous pouvez spécifier leur équivalent dans votre configuration MDX. @@ -196,7 +197,7 @@ Nous vous suggérons [d'utiliser AST Explorer](https://astexplorer.net/) pour jo ### `optimize` -* **Type:** `boolean | { customComponentNames?: string[] }` +* **Type :** `boolean | { ignoreElementNames?: string[] }` Il s'agit d'un paramètre de configuration facultatif qui permet d'optimiser la sortie MDX pour une construction et un rendu plus rapides grâce à un plugin rehype interne. Cela peut être utile si vous avez beaucoup de fichiers MDX et que vous constatez des lenteurs dans la construction. Cependant, cette option peut générer du HTML non échappé, assurez-vous donc que les parties interactives de votre site fonctionnent toujours correctement après l'avoir activée. @@ -216,13 +217,16 @@ export default defineConfig({ }); ``` -#### `customComponentNames` +#### `ignoreElementNames` -* **Type:** `string[]` +* **Type :** `string[]` -Une propriété optionnelle de `optimize` pour empêcher l'optimisateur MDX de gérer tout [composant personnalisé passé au contenu MDX importé via la propriété components](/fr/guides/markdown-content/#composants-personnalisés-avec-du-mdx-importé). +

+Précédemment connu sous le nom de `customComponentNames`. -Vous devrez exclure ces composants de l'optimisation, car l'optimisateur convertit trop rapidement le contenu en une chaîne statique, ce qui brisera les composants personnalisés qui ont besoin d'être rendus dynamiquement. +Une propriété optionnelle de `optimize` pour empêcher l'optimiseur MDX de gérer certains noms d'éléments, comme [les composants personnalisés passés au contenu MDX importé via la propriété components](/fr/guides/markdown-content/#custom-components-with-imported-mdx). + +Vous devrez exclure ces composants de l'optimisation, car l'optimiseur convertit trop rapidement le contenu en une chaîne statique, ce qui brisera les composants personnalisés qui ont besoin d'être rendus dynamiquement. Par exemple, la sortie MDX prévue pour ce qui suit est `...` à la place de chaque `"

...

"` : @@ -235,7 +239,7 @@ import Heading from '../Heading.astro'; ``` -Pour configurer l'optimisation à l'aide de la propriété `customComponentNames`, spécifiez un tableau de noms d'éléments HTML qui doivent être traités comme des composants personnalisés : +Pour configurer l'optimisation à l'aide de la propriété `ignoreElementNames`, spécifiez un tableau de noms d'éléments HTML qui doivent être traités comme des composants personnalisés : ```js title="astro.config.mjs" import { defineConfig } from 'astro/config'; @@ -246,9 +250,9 @@ export default defineConfig({ integrations: [ mdx({ optimize: { - // Empêcher l'optimisateur de traiter les éléments `h1`. + // Empêcher l'optimiseur de traiter les éléments `h1`. // Ceux-ci seront traités comme des composants personnalisés - customComponentNames: ['h1'], + ignoreElementNames: ['h1'], }, }), ], diff --git a/src/content/docs/fr/guides/integrations-guide/preact.mdx b/src/content/docs/fr/guides/integrations-guide/preact.mdx index 371cafc97d099..4d1662f167166 100644 --- a/src/content/docs/fr/guides/integrations-guide/preact.mdx +++ b/src/content/docs/fr/guides/integrations-guide/preact.mdx @@ -8,6 +8,7 @@ i18nReady: true --- import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' +import Since from '~/components/Since.astro'; Cette **[intégration Astro][astro-integration]** permet le rendu côté serveur et l'hydratation côté client pour vos composants [Preact](https://preactjs.com/). @@ -150,6 +151,22 @@ Consultez les documents [`pnpm` overrides](https://pnpm.io/package_json#pnpmover Actuellement, l'option `compat` ne fonctionne que pour les bibliothèques React qui exportent du code en tant qu'ESM. Si une erreur survient lors de la compilation, essayez d'ajouter la bibliothèque à `vite.ssr.noExternal : ['the-react-library']` dans votre fichier `astro.config.mjs`. ::: +### devtools + +

+ +Vous pouvez activer [Preact devtools](https://preactjs.github.io/preact-devtools/) durant le développement en passant un objet avec `devtools : true` à votre configuration d'intégration `preact()` : + +```js title="astro.config.mjs" +import { defineConfig } from 'astro/config'; +import preact from '@astrojs/preact'; + +export default defineConfig({ + // ... + integrations: [preact({ devtools: true })], +}); +``` + ## Options ### Combinaison de plusieurs frameworks JSX diff --git a/src/content/docs/fr/guides/integrations-guide/solid-js.mdx b/src/content/docs/fr/guides/integrations-guide/solid-js.mdx index ad168bc423ebc..46869595183b8 100644 --- a/src/content/docs/fr/guides/integrations-guide/solid-js.mdx +++ b/src/content/docs/fr/guides/integrations-guide/solid-js.mdx @@ -6,7 +6,8 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int category: renderer i18nReady: true --- -import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; +import Since from '~/components/Since.astro'; Cette **[intégration Astro][astro-integration]** permet le rendu côté serveur et l'hydratation côté client pour vos composants [SolidJS](https://www.solidjs.com/). @@ -98,6 +99,42 @@ Pour utiliser votre premier composant SolidJS dans Astro, consultez notre [docum * 💧 les options d'hydratation côté client, et * 🤝 les possibilités de mélanger et d'imbriquer les Frameworks. +## Configuration + +### devtools + +

+ +Vous pouvez activer [Solid DevTools](https://github.com/thetarnav/solid-devtools) durant le développement en passant un objet avec `devtools : true` à votre configuration d'intégration `solid()` et en ajoutant `solid-devtools` aux dépendances de votre projet : + + + + ```sh + npm install solid-devtools + ``` + + + ```sh + pnpm add solid-devtools + ``` + + + ```sh + yarn add solid-devtools + ``` + + + +```js title="astro.config.mjs" +import { defineConfig } from 'astro/config'; +import solid from '@astrojs/solid'; + +export default defineConfig({ + // ... + integrations: [solid({ devtools: true })], +}); +``` + ## Options ### Combinaison de plusieurs frameworks JSX diff --git a/src/content/docs/fr/guides/integrations-guide/vercel.mdx b/src/content/docs/fr/guides/integrations-guide/vercel.mdx index b67694226885c..d3d43d00472c6 100644 --- a/src/content/docs/fr/guides/integrations-guide/vercel.mdx +++ b/src/content/docs/fr/guides/integrations-guide/vercel.mdx @@ -353,6 +353,27 @@ export default defineConfig({ }); ``` +### `skewProtection` + +**Type :** `boolean`
+**Disponible pour :** Serverless + + +Utilisez cette propriété pour activer [Vercel Skew protection](https://vercel.com/docs/deployments/skew-protection) (disponible avec les comptes Vercel Pro et Enterprise). + +```js title="astro.config.mjs" ins={8} +import { defineConfig } from 'astro/config'; +import vercel from '@astrojs/vercel/serverless'; + +export default defineConfig({ +// ... + output: "server", + adapter: vercel({ + skewProtection: true + }), +}); +``` + ### Configuration du regroupement des fonctions L'adaptateur Vercel combine toutes vos routes en une seule fonction par défaut. diff --git a/src/content/docs/fr/guides/integrations-guide/vue.mdx b/src/content/docs/fr/guides/integrations-guide/vue.mdx index d89362adf0133..e2a04af6be392 100644 --- a/src/content/docs/fr/guides/integrations-guide/vue.mdx +++ b/src/content/docs/fr/guides/integrations-guide/vue.mdx @@ -7,6 +7,7 @@ category: renderer i18nReady: true --- import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; +import Since from '~/components/Since.astro'; Cette **[intégration Astro][astro-integration]** permet le rendu côté serveur et l'hydratation côté client pour vos composants [Vue 3](https://vuejs.org/). @@ -194,3 +195,19 @@ export default defineConfig({ ], }); ``` + +### devtools + +

+ +Vous pouvez activer [Vue DevTools](https://devtools-next.vuejs.org/) durant le développement en passant un objet avec `devtools : true` à votre configuration d'intégration `vue()` : + +```js title="astro.config.mjs" +import { defineConfig } from 'astro/config'; +import vue from '@astrojs/vue'; + +export default defineConfig({ + // ... + integrations: [vue({ devtools: true })], +}); +``` diff --git a/src/content/docs/fr/guides/testing.mdx b/src/content/docs/fr/guides/testing.mdx index 921d2cbe7c62a..5d54e82df997c 100644 --- a/src/content/docs/fr/guides/testing.mdx +++ b/src/content/docs/fr/guides/testing.mdx @@ -28,6 +28,19 @@ export default getViteConfig({ }); ``` +Par défaut, `getViteConfig()` essaiera de charger un fichier de configuration Astro dans votre projet et de l'appliquer à l'environnement de test. +À partir d'Astro 4.8, si vous avez besoin de personnaliser la configuration Astro pour vos tests, passez un second argument à `getViteConfig()` : + +```js +export default getViteConfig( + { test: { /* Options de configuration de Vitest */ } }, + { + site: 'https://example.com/', + trailingSlash: 'always', + }, +); +``` + Voir le [modèle de démarrage Astro + Vitest](https://github.com/withastro/astro/tree/latest/examples/with-vitest) sur GitHub. ## Cypress diff --git a/src/content/docs/fr/reference/error-reference.mdx b/src/content/docs/fr/reference/error-reference.mdx index 3bcdae42fce8f..7f44f8c531870 100644 --- a/src/content/docs/fr/reference/error-reference.mdx +++ b/src/content/docs/fr/reference/error-reference.mdx @@ -20,6 +20,7 @@ La référence suivante est une liste complète des erreurs que vous pouvez renc - [**UnknownCompilerError**](/fr/reference/errors/unknown-compiler-error/)
Erreur inconnue du compilateur. - [**StaticRedirectNotAvailable**](/fr/reference/errors/static-redirect-not-available/)
`Astro.redirect` n'est pas disponible en mode statique. - [**ClientAddressNotAvailable**](/fr/reference/errors/client-address-not-available/)
`Astro.clientAddress` n'est pas disponible dans l'adaptateur actuel. +- [**PrerenderClientAddressNotAvailable**](/fr/reference/errors/prerender-client-address-not-available/)
`Astro.clientAddress` ne peut pas être utilisé dans les itinéraires pré-tracés. - [**StaticClientAddressNotAvailable**](/fr/reference/errors/static-client-address-not-available/)
`Astro.clientAddress` n'est pas disponible en mode statique. - [**NoMatchingStaticPathFound**](/fr/reference/errors/no-matching-static-path-found/)
Aucun chemin statique n'a été trouvé pour le chemin demandé. - [**OnlyResponseCanBeReturned**](/fr/reference/errors/only-response-can-be-returned/)
Type non valide renvoyé par la page Astro. @@ -79,6 +80,8 @@ La référence suivante est une liste complète des erreurs que vous pouvez renc - [**CantRenderPage**](/fr/reference/errors/cant-render-page/)
Astro ne peut pas rendre la route. - [**UnhandledRejection**](/fr/reference/errors/unhandled-rejection/)
Rejet non géré - [**i18nNotEnabled**](/fr/reference/errors/i18n-not-enabled/)
i18n non activé +- [**RouteNotFound**](/fr/reference/errors/route-not-found/)
Route non trouvée. + ## Erreurs de CSS - [**UnknownCSSError**](/fr/reference/errors/unknown-csserror/)
Erreur CSS inconnue.