From 73629fb04d0863eb605c9eee0ee4e3e15ac101f3 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 3 Mar 2025 20:45:15 +0100 Subject: [PATCH 01/40] traduction du README --- README.md | 38 +++++++++++++++++--------------------- 1 file changed, 17 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index c735a61..c3e4463 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,3 @@ - -## This repo is a template for [Vite.js docs translation repositories](https://github.com/vitejs?q=docs). See [guide](/.github/CONTRIBUTING.md). - ----

Vite logo @@ -19,28 +15,28 @@ # Vite ⚡ -> Next Generation Frontend Tooling +> Outil Frontend de nouvelle génération -- 💡 Instant Server Start -- ⚡️ Lightning Fast HMR -- 🛠️ Rich Features -- 📦 Optimized Build -- 🔩 Universal Plugin Interface -- 🔑 Fully Typed APIs +- 💡 Démarrage de serveur instantané +- ⚡️ HMR ultra rapide +- 🛠️ Fonctionnalités riches +- 📦 Build optimisé +- 🔩 Interface de plugin universelle +- 🔑 APIs fortement typées -Vite (French word for "quick", pronounced [`/vit/`](https://cdn.jsdelivr.net/gh/vitejs/vite@main/docs/public/vite.mp3), like "veet") is a new breed of frontend build tooling that significantly improves the frontend development experience. It consists of two major parts: +Vite (Mot français pour "rapide", prononcé [`/vit/`](https://cdn.jsdelivr.net/gh/vitejs/vite@main/docs/public/vite.mp3)) est un nouveau genre d'outil de build frontend qui améliore significativement l'expérience développeur frontend. Il est constitué de deux parties principales: -- A dev server that serves your source files over [native ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules), with [rich built-in features](https://vite.dev/guide/features.html) and astonishingly fast [Hot Module Replacement (HMR)](https://vite.dev/guide/features.html#hot-module-replacement). +- Un serveur de développement qui sert vos ressources à travers des [modules natifs ES](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules), avec des [fonctionnalités incluses variées](https://vite.dev/guide/features.html) et un système de [Hot Module Replacement (HMR)](https://vite.dev/guide/features.html#hot-module-replacement) étonnamment rapide. -- A [build command](https://vite.dev/guide/build.html) that bundles your code with [Rollup](https://rollupjs.org), pre-configured to output highly optimized static assets for production. +- Une [commande de build](https://vite.dev/guide/build.html) qui bundle votre code avec [Rollup](https://rollupjs.org), préconfiguré pour sortir des assets hautement optimisés pour la production. -In addition, Vite is highly extensible via its [Plugin API](https://vite.dev/guide/api-plugin.html) and [JavaScript API](https://vite.dev/guide/api-javascript.html) with full typing support. +De plus, Vite est hautement extensible via son [API de Plugin](https://vite.dev/guide/api-plugin.html) et son [API JavaScript](https://vite.dev/guide/api-javascript.html) avec du support complet de typage. -[Read the Docs to Learn More](https://vite.dev). +[Lire la documentation pour en savoir plus](https://vite.dev). -## Packages +## Paquets -| Package | Version (click for changelogs) | +| Paquet | Version (cliquer pour le changelog ) | | ----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | | [vite](packages/vite) | [![vite version](https://img.shields.io/npm/v/vite.svg?label=%20)](packages/vite/CHANGELOG.md) | | [@vitejs/plugin-legacy](packages/plugin-legacy) | [![plugin-legacy version](https://img.shields.io/npm/v/@vitejs/plugin-legacy.svg?label=%20)](packages/plugin-legacy/CHANGELOG.md) | @@ -48,9 +44,9 @@ In addition, Vite is highly extensible via its [Plugin API](https://vite.dev/gui ## Contribution -See [Contributing Guide](CONTRIBUTING.md). +Voir le [Guide de contribution](CONTRIBUTING.md). -## License +## Licence [MIT](LICENSE). @@ -60,4 +56,4 @@ See [Contributing Guide](CONTRIBUTING.md). sponsors -

+

\ No newline at end of file From 46c91b8a305e54ee74eb1888ff9e68060f81eb3e Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 3 Mar 2025 21:06:29 +0100 Subject: [PATCH 02/40] traduction de la racine de docs --- docs/blog.md | 2 +- docs/index.md | 4 +-- docs/releases.md | 68 ++++++++++++++++++++++++------------------------ docs/team.md | 10 +++---- 4 files changed, 41 insertions(+), 43 deletions(-) diff --git a/docs/blog.md b/docs/blog.md index f3f8c62..c6afbaf 100644 --- a/docs/blog.md +++ b/docs/blog.md @@ -8,6 +8,6 @@ outline: false import BlogIndex from './.vitepress/theme/components/BlogIndex.vue' -# Latest From the Vite Blog +# Les dernières actualités de Vite diff --git a/docs/index.md b/docs/index.md index 3017511..89a3b91 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,13 +28,13 @@ import FeatureCI from './.vitepress/theme/components/landing/2. feature-section/
- + - + diff --git a/docs/releases.md b/docs/releases.md index 662a8e2..2771e30 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -1,61 +1,61 @@ # Releases -Vite releases follow [Semantic Versioning](https://semver.org/). You can see the latest stable version of Vite in the [Vite npm package page](https://www.npmjs.com/package/vite). +Vite suit le [Versioning sémantique](https://semver.org/). Vous pouvez voir la dernière version stable de Vite dans la [page du package npm de Vite](https://www.npmjs.com/package/vite). -A full changelog of past releases is [available on GitHub](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md). +Un journal complet des releases passées est [disponible sur GitHub](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md). -## Release Cycle +## Cycle de release -Vite does not have a fixed release cycle. +Vite n’a pas de cycle de release fixe. -- **Patch** releases are released as needed (usually every week). -- **Minor** releases always contain new features and are released as needed. Minor releases always have a beta pre-release phase (usually every two months). -- **Major** releases generally align with [Node.js EOL schedule](https://endoflife.date/nodejs), and will be announced ahead of time. These releases will go through long-term discussions with the ecosystem, and have alpha and beta pre-release phases (usually every year). +- Les releases de **Patch** sont publiés quand cela est nécessaire (généralement toutes les semaines). +- Les releases **Mineures** contiennent de nouvelles fonctionnalités et sont publiées quand cela est nécessaire. Les releases **Mineures** ont toujours une phase de prérelease bêta (généralement tous les deux mois). +- Les releases **Majeures** sont généralement alignées avec le [calendrier de fin de vie de Node.js](https://endoflife.date/nodejs) et seront annoncées à l’avance. Ces releases passeront par des discussions longues avec l’écosystème et auront une phase de prérelease alpha et bêta (généralement tous les ans). -The Vite versions ranges that are supported by the Vite team is automatically determined by: +Les plages de versions de Vite supportées par l’équipe Vite sont déterminées automatiquement par : -- **Current Minor** gets regular fixes. -- **Previous Major** (only for its latest minor) and **Previous Minor** receives important fixes and security patches. -- **Second-to-last Major** (only for its latest minor) and **Second-to-last Minor** receives security patches. -- All versions before these are no longer supported. +- **Mineur actuel** reçoit des correctifs réguliers. +- **Majeur précédent** (seulement pour sa dernière mineure) et **Mineur précédent** reçoivent des correctifs importants et des correctifs de sécurité. +- **Avant dernière Majeure** (seulement pour sa dernière mineure) et **Avant dernière Mineure** reçoivent des correctifs de sécurité. +- Toutes les versions avant ces dernières sont plus supportées. -As an example, if the Vite latest is at 5.3.10: +Par exemple, si la dernière version de Vite est 5.3.10 : -- Regular patches are released for `vite@5.3`. -- Important fixes and security patches are backported to `vite@4` and `vite@5.2`. -- Security patches are also backported to `vite@3`, and `vite@5.1`. -- `vite@2` and `vite@5.0` are no longer supported. Users should upgrade to receive updates. +- Les correctifs réguliers sont publiés pour`vite@5.3`. +- Les correctifs importants et les correctifs de sécurité sont apportés à `vite@4`et`vite@5.2`. +- Les correctifs de sécurité sont également apportés à`vite@3`, et`vite@5.1`. +- `vite@2`et `vite@5.0`ne sont plus supportés. Les utilisateurs doivent mettre à jour pour recevoir des mises à jour. -We recommend updating Vite regularly. Check out the [Migration Guides](https://vite.dev/guide/migration.html) when you update to each Major. The Vite team works closely with the main projects in the ecosystem to ensure the quality of new versions. We test new Vite versions before releasing them through the [vite-ecosystem-ci project](https://github.com/vitejs/vite-ecosystem-ci). Most projects using Vite should be able to quickly offer support or migrate to new versions as soon as they are released. +Nous recommandons de mettre à jour Vite régulièrement. Consultez les [guides de migration](https://vite.dev/guide/migration.html) lorsque vous mettez à jour vers chaque Majeur. L’équipe Vite travaille de près avec les principaux projets de l’écosystème pour garantir la qualité des nouvelles versions. Nous testons les nouvelles versions de Vite avant de les publier via le projet [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci). La plupart des projets utilisant Vite devraient être en mesure de proposer un support ou de migrer vers de nouvelles versions dès qu’elles sont publiées. -## Semantic Versioning Edge Cases +## Edge Cases du versionning sémantique -### TypeScript Definitions +### Définitions TypeScript -We may ship incompatible changes to TypeScript definitions between minor versions. This is because: +Nous pouvons publier des modifications incompatibles entre les versions mineures. Cela est dû au fait que : -- Sometimes TypeScript itself ships incompatible changes between minor versions, and we may have to adjust types to support newer versions of TypeScript. -- Occasionally we may need to adopt features that are only available in a newer version of TypeScript, raising the minimum required version of TypeScript. -- If you are using TypeScript, you can use a semver range that locks the current minor and manually upgrade when a new minor version of Vite is released. +- Parfois, TypeScript lui-même publie des modifications incompatibles entre les versions mineures, et nous devons ajuster les types pour supporter de nouvelles versions de TypeScript. +- Parfois, nous devons adopter des fonctionnalités qui ne sont disponibles que dans une nouvelle version de TypeScript, ce qui augmente la version minimale requise de TypeScript. +- Si vous utilisez TypeScript, vous pouvez utiliser une plage semver qui verrouille la dernière version mineure et mettre à jour manuellement lorsqu’une nouvelle version mineure de Vite est publiée. ### esbuild -[esbuild](https://esbuild.github.io/) is pre-1.0.0 and sometimes it has a breaking change we may need to include to have access to newer features and performance improvements. We may bump the esbuild's version in a Vite Minor. +[Esbuild](https://esbuild.github.io/) est pre-1.0.0 et parfois il a un changement cassant que nous devons inclure pour avoir accès aux nouvelles fonctionnalités et améliorations de performance. Nous pouvons augmenter la version d’esbuild dans une version mineure de Vite. -### Node.js non-LTS versions +### Versions de Node.js non LTS -Non-LTS Node.js versions (odd-numbered) are not tested as part of Vite's CI, but they should still work before their [EOL](https://endoflife.date/nodejs). +Les versions de Node.js non LTS (les numéros impairs) ne sont pas testées comme partie de Vite's CI, mais elles devraient encore fonctionner avant leur [fin de vie](https://endoflife.date/nodejs). -## Pre Releases +## Préreleases -Minor releases typically go through a non-fixed number of beta releases. Major releases will go through an alpha phase and a beta phase. +Les releases mineures passent généralement par un nombre non fixe de bêta. Les releases majeures passeront par une phase alpha et une phase bêta. -Pre-releases allow early adopters and maintainers from the Ecosystem to do integration and stability testing, and provide feedback. Do not use pre-releases in production. All pre-releases are considered unstable and may ship breaking changes in between. Always pin to exact versions when using pre-releases. +Les préreleases permettent aux utilisateurs et aux contributeurs de l’écosystème de faire des tests d’intégration et de stabilité, et de fournir des retours. Ne pas utiliser les préreleases en production. Toutes les préreleases sont considérées comme instables et peuvent contenir des changements cassants entre les versions. Toujours utiliser une version exacte lorsque vous utilisez les préreleases. -## Deprecations +## Dépréciations -We periodically deprecate features that have been superseded by better alternatives in Minor releases. Deprecated features will continue to work with a type or logged warning. They will be removed in the next major release after entering deprecated status. The [Migration Guide](https://vite.dev/guide/migration.html) for each major will list these removals and document an upgrade path for them. +Nous déprécions périodiquement des fonctionnalités qui ont été remplacées par des alternatives meilleures dans les releases mineures. Les fonctionnalités dépréciées continueront à fonctionner avec un avertissement de type ou un message de journalisation. Elles seront supprimées dans la prochaine version majeure après avoir été dépréciées. Le [Guide de migration](https://vite.dev/guide/migration.html) pour chaque majeur listera ces suppressions et documentera un chemin de migration pour chacune d’elles. -## Experimental Features +## Fonctionnalités expérimentales -Some features are marked as experimental when released in a stable version of Vite. Experimental features allow us to gather real-world experience to influence their final design. The goal is to let users provide feedback by testing them in production. Experimental features themselves are considered unstable, and should only be used in a controlled manner. These features may change between Minors, so users must pin their Vite version when they rely on them. We will create [a GitHub discussion](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=is%3Aopen+label%3Aexperimental+category%3AFeedback) for each experimental feature. +Certaines fonctionnalités sont marquées comme expérimentales lorsqu’elles sont publiées dans une version stable de Vite. Les fonctionnalités expérimentales permettent de collecter des retours d’utilisation dans le monde réel pour influencer leur conception finale. Le but est de permettre aux utilisateurs de fournir des retours en testant ces fonctionnalités en production. Les fonctionnalités expérimentales sont considérées comme instables et ne doivent être utilisées que dans un environnement contrôlé. Ces fonctionnalités peuvent changer entre les releases mineures, donc les utilisateurs doivent verrouiller la version de Vite lorsqu’ils en dépendent. Nous créerons une [discussion GitHub](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=is%3Aopen+label%3Aexperimental+category%3AFeedback) pour chaque fonctionnalité expérimentale. diff --git a/docs/team.md b/docs/team.md index fdd2cb8..0ef4bfd 100644 --- a/docs/team.md +++ b/docs/team.md @@ -1,7 +1,7 @@ --- layout: page -title: Meet the Team -description: The development of Vite is guided by an international team. +title: Rencontrer l'équipe +description: Le développement de Vite est mené par une équipe internationale. --- ``` -You can use any placeholder you prefer instead of ``, as long as it can be precisely replaced. +Vous pouvez utiliser n’importe quel espace réservé que vous préférez à la place de``, tant que cela peut être exactement remplacé. -## Conditional Logic +## Logique conditionnelle -If you need to perform conditional logic based on SSR vs. client, you can use +Si vous avez besoin de faire une logique conditionnelle basée sur SSR vs. client, vous pouvez utiliser ```js twoslash import 'vite/client' @@ -59,11 +59,11 @@ if (import.meta.env.SSR) { } ``` -This is statically replaced during build so it will allow tree-shaking of unused branches. +Cela est statiquement remplacé lors de la construction, ce qui permet le balayage de l’arbre pour les branches non utilisées. -## Setting Up the Dev Server +## Configuration du serveur de développement -When building an SSR app, you likely want to have full control over your main server and decouple Vite from the production environment. It is therefore recommended to use Vite in middleware mode. Here is an example with [express](https://expressjs.com/): +Lors de la construction d’une application SSR, vous souhaiterez probablement avoir un contrôle total sur votre serveur principal et découpler Vite de l’environnement de production. Il est donc recommandé d’utiliser Vite en mode middleware. Voici un exemple avec [express](https://expressjs.com/) : ```js{15-18} twoslash [server.js] import fs from 'node:fs' @@ -103,9 +103,9 @@ async function createServer() { createServer() ``` -Here `vite` is an instance of [ViteDevServer](./api-javascript#vitedevserver). `vite.middlewares` is a [Connect](https://github.com/senchalabs/connect) instance which can be used as a middleware in any connect-compatible Node.js framework. +Ici, `vite`est une instance de [ViteDevServer](./api-javascript#vitedevserver). `vite.middlewares`est une instance de [Connect](https://github.com/senchalabs/connect) qui peut être utilisée comme middleware dans n’importe quel framework Node.js compatible connect. -The next step is implementing the `*` handler to serve server-rendered HTML: +La prochaine étape est d’implémenter le gestionnaire `*`pour servir le HTML rendu côté serveur : ```js twoslash [server.js] // @noErrors @@ -158,7 +158,7 @@ app.use('*all', async (req, res, next) => { }) ``` -The `dev` script in `package.json` should also be changed to use the server script instead: +Le script `dev`dans `package.json`doit également être modifié pour utiliser le script serveur à la place : ```diff [package.json] "scripts": { @@ -167,14 +167,14 @@ The `dev` script in `package.json` should also be changed to use the server scri } ``` -## Building for Production +## Construction pour la production -To ship an SSR project for production, we need to: +Pour envoyer un projet SSR pour la production, nous avons besoin de : -1. Produce a client build as normal; -2. Produce an SSR build, which can be directly loaded via `import()` so that we don't have to go through Vite's `ssrLoadModule`; +1. Produire un build client normal ; +2. Produire un build SSR, qui peut être directement chargé via `import()`afin de ne pas passer par `ssrLoadModule`de Vite ; -Our scripts in `package.json` will look like this: +Nos scripts dans `package.json`ressembleront à ceci : ```json [package.json] { @@ -186,66 +186,64 @@ Our scripts in `package.json` will look like this: } ``` -Note the `--ssr` flag which indicates this is an SSR build. It should also specify the SSR entry. +Notez le drapeau `--ssr`qui indique que c’est un build SSR. Il doit également spécifier l’entrée SSR. -Then, in `server.js` we need to add some production specific logic by checking `process.env.NODE_ENV`: +Ensuite, dans `server.js`nous devons ajouter une logique spécifique à la production en vérifiant `process.env.NODE_ENV`: -- Instead of reading the root `index.html`, use the `dist/client/index.html` as the template, since it contains the correct asset links to the client build. +- Au lieu de lire la `index.html`racine, utilisez-le `dist/client/index.html`comme template, car il contient les liens de ressources corrects vers le build client. -- Instead of `await vite.ssrLoadModule('/src/entry-server.js')`, use `import('./dist/server/entry-server.js')` (this file is the result of the SSR build). +- Au lieu de`await vite.ssrLoadModule('/src/entry-server.js')`, utilisez `import('./dist/server/entry-server.js')`(ce fichier est le résultat du build SSR). -- Move the creation and all usage of the `vite` dev server behind dev-only conditional branches, then add static file serving middlewares to serve files from `dist/client`. +- Déplacez la création et toutes les utilisations de l’instance `vite`du serveur de développement derrière des branches conditionnelles dev-only, puis ajoutez des middlewares de serveur de fichiers statiques pour servir les fichiers de`dist/client`. -Refer to the [example projects](#example-projects) for a working setup. +Consultez les [exemples de projets](#exemples-de-projets) pour un exemple de configuration. -## Generating Preload Directives +## Génération de directives de préchargement -`vite build` supports the `--ssrManifest` flag which will generate `.vite/ssr-manifest.json` in build output directory: - -```diff +`vite build` Prend en charge le flag `--ssrManifest`qui générera `dist/client/.vite/ssr-manifest.json`pour le build client (oui, le manifeste SSR est généré à partir du build client, car nous voulons mapper les identifiants de module aux fichiers clients). Le manifeste contient des mappages des identifiants de module à leurs chunks et fichiers d’actifs associés. - "build:client": "vite build --outDir dist/client", + "build:client": "vite build --outDir dist/client --ssrManifest", ``` -The above script will now generate `dist/client/.vite/ssr-manifest.json` for the client build (Yes, the SSR manifest is generated from the client build because we want to map module IDs to client files). The manifest contains mappings of module IDs to their associated chunks and asset files. +Le script ci-dessus générera maintenant `dist/client/.vite/ssr-manifest.json` pour le build client (Oui, le manifeste SSR est généré à partir du build client car nous voulons mapper les identifiants de module aux fichiers clients). Le manifeste contient des mappages des identifiants de module à leurs chunks et fichiers d’actifs associés. -To leverage the manifest, frameworks need to provide a way to collect the module IDs of the components that were used during a server render call. +Pour tirer parti du manifeste, les frameworks doivent fournir une façon de collecter les identifiants de module des composants utilisés lors d’un appel de rendu côté serveur. -`@vitejs/plugin-vue` supports this out of the box and automatically registers used component module IDs on to the associated Vue SSR context: +`@vitejs/plugin-vue` prend en charge cela de manière intégrée et enregistre automatiquement les identifiants de module des composants utilisés lors d’un appel de rendu côté serveur sur le contexte SSR associé à Vue: ```js [src/entry-server.js] const ctx = {} const html = await vueServerRenderer.renderToString(app, ctx) -// ctx.modules is now a Set of module IDs that were used during the render +// ctx.modules est maintenant un Set d’identifiants de module qui ont été utilisés lors du rendu ``` -In the production branch of `server.js` we need to read and pass the manifest to the `render` function exported by `src/entry-server.js`. This would provide us with enough information to render preload directives for files used by async routes! See [demo source](https://github.com/vitejs/vite-plugin-vue/blob/main/playground/ssr-vue/src/entry-server.js) for a full example. You can also use this information for [103 Early Hints](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103). +Dans la branche de production de `server.js` nous devons lire et passer le manifeste à la fonction `render` exportée par `src/entry-server.js`. Cela nous fournira suffisamment d’informations pour rendre les directives de préchargement pour les fichiers utilisés par les routes asynchrones ! Voir [source de démo](https://github.com/vitejs/vite-plugin-vue/blob/main/playground/ssr-vue/src/entry-server.js) pour un exemple complet. Vous pouvez également utiliser ces informations pour le code de statut [103 Early Hints](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103). -## Pre-Rendering / SSG +## Pré-rendu / SSG -If the routes and the data needed for certain routes are known ahead of time, we can pre-render these routes into static HTML using the same logic as production SSR. This can also be considered a form of Static-Site Generation (SSG). See [demo pre-render script](https://github.com/vitejs/vite-plugin-vue/blob/main/playground/ssr-vue/prerender.js) for working example. +Si les routes et les données nécessaires pour certaines routes sont connues à l’avance, nous pouvons pré-rendre ces routes en HTML statique en utilisant la même logique que le SSR de production. Cela peut également être considéré comme une forme de génération de site statique (SSG). Voir [script de pré-rendu de démo](https://github.com/vitejs/vite-plugin-vue/blob/main/playground/ssr-vue/prerender.js) pour un exemple de travail. ## SSR Externals -Dependencies are "externalized" from Vite's SSR transform module system by default when running SSR. This speeds up both dev and build. +Les dépendances sont « externalisées » par défaut du système de transformation de module SSR de Vite lors de l’exécution du SSR. Cela accélère à la fois le développement et le build. -If a dependency needs to be transformed by Vite's pipeline, for example, because Vite features are used untranspiled in them, they can be added to [`ssr.noExternal`](../config/ssr-options.md#ssr-noexternal). +Si une dépendance doit être transformée par le pipeline de Vite, par exemple, parce que des fonctionnalités Vite sont utilisées non transpilées dans celles-ci, elles peuvent être ajoutées à [`ssr.noExternal`](../config/ssr-options.md#ssr-noexternal). -For linked dependencies, they are not externalized by default to take advantage of Vite's HMR. If this isn't desired, for example, to test dependencies as if they aren't linked, you can add it to [`ssr.external`](../config/ssr-options.md#ssr-external). +Pour les dépendances liées, elles ne sont pas externalisées par défaut pour tirer parti de Vite's HMR. Si cela n'est pas souhaité, par exemple, pour tester les dépendances comme si elles ne sont pas liées, vous pouvez l'ajouter à [`ssr.external`](../config/ssr-options.md#ssr-external). -:::warning Working with Aliases -If you have configured aliases that redirect one package to another, you may want to alias the actual `node_modules` packages instead to make it work for SSR externalized dependencies. Both [Yarn](https://classic.yarnpkg.com/en/docs/cli/add/#toc-yarn-add-alias) and [pnpm](https://pnpm.io/aliases/) support aliasing via the `npm:` prefix. +:::warning Travailler avec des alias +Si vous avez configuré des alias qui redirigent un package vers un autre, vous souhaiterez peut-être aliaser les packages `node_modules` réels au lieu de cela pour que cela fonctionne pour les dépendances externalisées SSR. Les deux [Yarn](https://classic.yarnpkg.com/en/docs/cli/add/#toc-yarn-add-alias) et [pnpm](https://pnpm.io/aliases/) prennent en charge l'aliasage via le préfixe `npm:`. ::: -## SSR-specific Plugin Logic +## Logique de plugin SSR spécifique -Some frameworks such as Vue or Svelte compile components into different formats based on client vs. SSR. To support conditional transforms, Vite passes an additional `ssr` property in the `options` object of the following plugin hooks: +Certains frameworks tels que Vue ou Svelte compilent les composants en différents formats en fonction du client vs. SSR. Pour prendre en charge les transformations conditionnelles, Vite passe une propriété supplémentaire `ssr` dans l'objet `options` des hooks de plugin suivants : - `resolveId` - `load` - `transform` -**Example:** +**Exemple:** ```js twoslash /** @type {() => import('vite').Plugin} */ @@ -262,31 +260,31 @@ export function mySSRPlugin() { } ``` -The options object in `load` and `transform` is optional, rollup is not currently using this object but may extend these hooks with additional metadata in the future. +L'objet `options` dans `load` et `transform` est optionnel, rollup n'utilise pas actuellement cet objet mais pourrait étendre ces hooks avec des métadonnées supplémentaires dans le futur. :::tip Note -Before Vite 2.7, this was informed to plugin hooks with a positional `ssr` param instead of using the `options` object. All major frameworks and plugins are updated but you may find outdated posts using the previous API. +Avant Vite 2.7, cela était informé aux hooks de plugin avec un paramètre positionnel `ssr` au lieu de l'objet `options`. Tous les principaux frameworks et plugins sont mis à jour mais vous pouvez trouver des articles obsolètes utilisant l'API précédente. ::: -## SSR Target +## Cible SSR -The default target for the SSR build is a node environment, but you can also run the server in a Web Worker. Packages entry resolution is different for each platform. You can configure the target to be Web Worker using the `ssr.target` set to `'webworker'`. +La cible par défaut pour le build SSR est un environnement node, mais vous pouvez également exécuter le serveur dans un Web Worker. La résolution des entrées des packages est différente pour chaque plateforme. Vous pouvez configurer la cible pour être un Web Worker en définissant `ssr.target` à `'webworker'`. -## SSR Bundle +## Bundle SSR -In some cases like `webworker` runtimes, you might want to bundle your SSR build into a single JavaScript file. You can enable this behavior by setting `ssr.noExternal` to `true`. This will do two things: +Dans certains cas comme les runtimes `webworker`, vous souhaiterez peut-être regrouper votre build SSR en un seul fichier JavaScript. Vous pouvez activer ce comportement en définissant `ssr.noExternal` à `true`. Cela fera deux choses : -- Treat all dependencies as `noExternal` -- Throw an error if any Node.js built-ins are imported +- Traiter toutes les dépendances comme `noExternal` +- Lancer une erreur si des built-ins Node.js sont importés -## SSR Resolve Conditions +## Conditions de résolution SSR -By default package entry resolution will use the conditions set in [`resolve.conditions`](../config/shared-options.md#resolve-conditions) for the SSR build. You can use [`ssr.resolve.conditions`](../config/ssr-options.md#ssr-resolve-conditions) and [`ssr.resolve.externalConditions`](../config/ssr-options.md#ssr-resolve-externalconditions) to customize this behavior. +La résolution des entrées des packages utilisera par défaut les conditions définies dans [`resolve.conditions`](../config/shared-options.md#resolve-conditions) pour le build SSR. Vous pouvez utiliser [`ssr.resolve.conditions`](../config/ssr-options.md#ssr-resolve-conditions) et [`ssr.resolve.externalConditions`](../config/ssr-options.md#ssr-resolve-externalconditions) pour personnaliser ce comportement. -## Vite CLI +## CLI Vite -The CLI commands `$ vite dev` and `$ vite preview` can also be used for SSR apps. You can add your SSR middlewares to the development server with [`configureServer`](/guide/api-plugin#configureserver) and to the preview server with [`configurePreviewServer`](/guide/api-plugin#configurepreviewserver). +Les commandes CLI `$ vite dev` et `$ vite preview` peuvent également être utilisées pour les applications SSR. Vous pouvez ajouter vos middlewares SSR au serveur de développement avec [`configureServer`](/guide/api-plugin#configureserver) et au serveur de prévisualisation avec [`configurePreviewServer`](/guide/api-plugin#configurepreviewserver). :::tip Note -Use a post hook so that your SSR middleware runs _after_ Vite's middlewares. +Utilisez un hook post pour que votre middleware SSR s'exécute _après_ les middlewares de Vite. ::: From 3941915a22c6e9a0e37f342ee4d4f1699aefb8ae Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Thu, 6 Mar 2025 20:47:33 +0100 Subject: [PATCH 07/40] traduction de l'article d'annonce de vite 2 --- docs/blog/announcing-vite2.md | 62 +++++++++++++++++------------------ 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/blog/announcing-vite2.md b/docs/blog/announcing-vite2.md index 47ee96d..1491676 100644 --- a/docs/blog/announcing-vite2.md +++ b/docs/blog/announcing-vite2.md @@ -1,7 +1,7 @@ --- -title: Announcing Vite 2.0 +title: Annonce de Vite 2.0 author: - - name: The Vite Team + - name: L'équipe Vite sidebar: false date: 2021-02-16 head: @@ -10,75 +10,75 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 2.0 + content: Annonce Vite 2.0 - - meta - property: og:url content: https://vite.dev/blog/announcing-vite2 - - meta - property: og:description - content: Vite 2 Release Announcement + content: Annonce de Vite 2 Release --- # Announcing Vite 2.0 -_February 16, 2021_ - Check out the [Vite 3.0 announcement](./announcing-vite3.md) +_16 Février, 2021_ - Voir l'annonce de [Vite 3.0](./announcing-vite3.md)

-Today we are excited to announce the official release of Vite 2.0! +Aujourd'hui, nous sommes heureux d'annoncer la sortie officielle de Vite 2.0 ! -Vite (French word for "fast", pronounced `/vit/`) is a new kind of build tool for frontend web development. Think a pre-configured dev server + bundler combo, but leaner and faster. It leverages browser's [native ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) support and tools written in compile-to-native languages like [esbuild](https://esbuild.github.io/) to deliver a snappy and modern development experience. +Vite (mot français pour "rapide", prononcé `/vit/`) est un nouvel outil de construction pour le développement web frontend. Pensez à un serveur de développement pré-configuré + combo de bundler, mais plus léger et plus rapide. Il exploite le support [native ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) du navigateur et des outils écrits dans des langages compilés en langage natif comme [esbuild](https://esbuild.github.io/) pour offrir une expérience de développement rapide et moderne. -To get a sense of how fast Vite is, check out [this video comparison](https://twitter.com/amasad/status/1355379680275128321) of booting up a React application on Repl.it using Vite vs. `create-react-app` (CRA). +Pour avoir une idée de la vitesse de Vite, consultez [cette vidéo de comparaison](https://twitter.com/amasad/status/1355379680275128321) de la mise en route d'une application React sur Repl.it en utilisant Vite par rappport à `create-react-app` (CRA). -If you've never heard of Vite before and would love to learn more about it, check out [the rationale behind the project](https://vite.dev/guide/why.html). If you are interested in how Vite differs from other similar tools, check out the [comparisons](https://v5.vite.dev/guide/comparisons.html). +Si vous n'avez jamais entendu parler de Vite avant et que vous souhaitez en savoir plus sur le projet, consultez [la raison derrière le projet](https://vite.dev/guide/why.html). Si vous êtes intéressé par la différence entre Vite et d'autres outils similaires, consultez les [comparaisons](https://v5.vite.dev/guide/comparisons.html). -## What's New in 2.0 +## Quoi de neuf dans 2.0 -Since we decided to completely refactor the internals before 1.0 got out of RC, this is in fact the first stable release of Vite. That said, Vite 2.0 brings about many big improvements over its previous incarnation: +Puisque nous avons décidé de refactorer complètement les composants internes avant que 1.0 ne soit sortie de RC, c'est en fait la première version stable de Vite. Cela dit, Vite 2.0 apporte de nombreuses améliorations par rapport à la précédente version : -### Framework Agnostic Core +### Cœur totalement indépendant des frameworks -The original idea of Vite started as a [hacky prototype that serves Vue single-file components over native ESM](https://github.com/vuejs/vue-dev-server). Vite 1 was a continuation of that idea with HMR implemented on top. +L'idée originale de Vite a commencé comme un [prototype bidon qui servait les composants de fichier unique Vue sur ESM natif](https://github.com/vuejs/vue-dev-server). Vite 1 était une continuation de cette idée avec HMR implémentée par-dessus. -Vite 2.0 takes what we learned along the way and is redesigned from scratch with a more robust internal architecture. It is now completely framework agnostic, and all framework-specific support is delegated to plugins. There are now [official templates for Vue, React, Preact, Lit Element](https://github.com/vitejs/vite/tree/main/packages/create-vite), and ongoing community efforts for Svelte integration. +Vite 2.0 prend ce que nous avons appris le long du chemin et est redéfini de zéro avec une architecture interne plus robuste. Il est maintenant complètement indépendant des frameworks, et tout le support des frameworks spécifiques est délégué aux plugins. Il existe maintenant des [templates officiels pour Vue, React, Preact, Lit Element](https://github.com/vitejs/vite/tree/main/packages/create-vite), et des efforts de la communauté en cours pour l'intégration de Svelte. -### New Plugin Format and API +### Nouveau format de plugin et API -Inspired by [WMR](https://github.com/preactjs/wmr), the new plugin system extends Rollup's plugin interface and is [compatible with many Rollup plugins](https://vite-rollup-plugins.patak.dev/) out of the box. Plugins can use Rollup-compatible hooks, with additional Vite-specific hooks and properties to adjust Vite-only behavior (e.g. differentiating dev vs. build or custom handling of HMR). +Insipiré par [WMR](https://github.com/preactjs/wmr), le nouveau système de plugin étend l'interface de plugin de Rollup et est [compatible avec de nombreux plugins Rollup](https://vite-rollup-plugins.patak.dev/) out of the box. Les plugins peuvent utiliser les hooks compatibles Rollup, avec des hooks supplémentaires Vite et des propriétés pour ajuster le comportement Vite uniquement (ex. différencier le développement du build ou le traitement personnalisé de HMR). -The [programmatic API](https://vite.dev/guide/api-javascript.html) has also been greatly improved to facilitate higher level tools / frameworks built on top of Vite. +L'[API programmatique](https://vite.dev/guide/api-javascript.html) a également été grandement améliorée pour faciliter les outils / frameworks de niveau supérieur construits sur Vite. ### esbuild Powered Dep Pre-Bundling -Since Vite is a native ESM dev server, it pre-bundles dependencies to reduce the number browser requests and handle CommonJS to ESM conversion. Previously Vite did this using Rollup, and in 2.0 it now uses `esbuild` which results in 10-100x faster dependency pre-bundling. As a reference, cold-booting a test app with heavy dependencies like React Material UI previously took 28 seconds on an M1-powered MacBook Pro and now takes ~1.5 seconds. Expect similar improvements if you are switching from a traditional bundler based setup. +Vite est un serveur de développement ESM natif, il pré-bundle donc les dépendances pour réduire le nombre de requêtes de navigateur et gérer la conversion de CommonJS en ESM. Précédemment, Vite faisait cela en utilisant Rollup, et dans 2.0, il utilise maintenant `esbuild` qui donne un gain de vitesse de10-100x pour le pré-bundle des dépendances. En guise de référence, le démarrage froid d'une application de test avec des dépendances lourdes comme React Material UI prendait 28 secondes sur un MacBook Pro M1 et maintenant prend environ 1.5 secondes. Vous pouvez vous attendre à des améliorations similaires si vous changez d'un environnement de build basé sur un bundler traditionnel. -### First-class CSS Support +### Support natif des CSS -Vite treats CSS as a first-class citizen of the module graph and supports the following out of the box: +Vite traite le CSS comme une entité de premier ordre du graphe des modules et prend en charge les éléments suivants de manière native : -- **Resolver enhancement**: `@import` and `url()` paths in CSS are enhanced with Vite's resolver to respect aliases and npm dependencies. -- **URL rebasing**: `url()` paths are automatically rebased regardless of where the file is imported from. -- **CSS code splitting**: a code-split JS chunk also emits a corresponding CSS file, which is automatically loaded in parallel with the JS chunk when requested. +- **Amélioration de la résolution** : `@import` et `url()` dans le CSS sont renforcés avec la résolution de Vite pour respecter les alias et les dépendances npm. +- **Réécriture des URL** : `url()` sont automatiquement réécrites indépendamment de l'endroit où le fichier est importé. +- **CSS code splitting** : un chunk JS code-splité émet également un fichier CSS correspondant, qui est automatiquement chargé en parallèle avec le chunk JS lorsqu'il est demandé. -### Server-Side Rendering (SSR) Support +### Support SSR (Rendu côté serveur) -Vite 2.0 ships with [experimental SSR support](https://vite.dev/guide/ssr.html). Vite provides APIs to efficiently load and update ESM-based source code in Node.js during development (almost like server-side HMR), and automatically externalizes CommonJS-compatible dependencies to improve development and SSR build speed. The production server can be completely decoupled from Vite, and the same setup can be easily adapted to perform pre-rendering / SSG. +Vite 2.0 embarque [un support SSR expérimental](https://vite.dev/guide/ssr.html). Vite fournit des API pour charger et mettre à jour le code source ESM basé sur Node.js pendant le développement (presque comme le HMR côté serveur), et automatiquement externalise les dépendances CommonJS compatibles pour améliorer la vitesse de développement et de build SSR. Le serveur de production peut être complètement découplé de Vite, et le même montage peut être facilement adapté pour effectuer un rendu préalable / SSG. -Vite SSR is provided as a low-level feature and we are expecting to see higher level frameworks leveraging it under the hood. +Le support SSR est fourni comme une fonctionnalité de bas niveau et nous attendons à voir des frameworks l'utiliser en arrière-plan. -### Opt-in Legacy Browser Support +### Support des navigateurs obsolètes -Vite targets modern browsers with native ESM support by default, but you can also opt-in to support legacy browsers via the official [@vitejs/plugin-legacy](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy). The plugin automatically generates dual modern/legacy bundles, and delivers the right bundle based on browser feature detection, ensuring more efficient code in modern browsers that support them. +Vite cible les navigateurs modernes avec le support ESM natif par défaut, mais vous pouvez également choisir par défaut le support des navigateurs obsolètes via le plugin officiel [@vitejs/plugin-legacy](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy). Le plugin génère automatiquement des bundles modernes/hérités, et livre le bon bundle en fonction de la détection des fonctionnalités du navigateur, garantissant un code plus efficace dans les navigateurs modernes qui le supportent. -## Give it a Try! +## Essayez-le ! -That was a lot of features, but getting started with Vite is simple! You can spin up a Vite-powered app literally in a minute, starting with the following command (make sure you have Node.js >=12): +Cela était beaucoup de fonctionnalités, mais le démarrage avec Vite est simple ! Vous pouvez lancer une application Vite en quelques secondes, en commençant par la commande suivante (assurez-vous que vous avez Node.js >=12) : ```bash npm init @vitejs/app ``` -Then, check out [the guide](https://vite.dev/guide/) to see what Vite provides out of the box. You can also check out the source code on [GitHub](https://github.com/vitejs/vite), follow updates on [Twitter](https://twitter.com/vite_js), or join discussions with other Vite users on our [Discord chat server](http://chat.vite.dev/). +Ensuite, consultez [le guide](https://vite.dev/guide/) pour voir ce que Vite fournit par défaut. Vous pouvez également consulter le code source sur [GitHub](https://github.com/vitejs/vite), suivre les mises à jour sur [Twitter](https://twitter.com/vite_js), ou rejoindre les discussions avec d'autres utilisateurs de Vite sur notre [serveur de chat Discord](http://chat.vite.dev/). From da4393abe0610198225091cbe45d168b7f83441e Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Thu, 6 Mar 2025 21:22:40 +0100 Subject: [PATCH 08/40] traduction de l'article d'annonce de vite 3 --- CONTRIBUTING.md | 12 +-- docs/blog/announcing-vite2.md | 4 +- docs/blog/announcing-vite3.md | 180 +++++++++++++++++----------------- 3 files changed, 98 insertions(+), 98 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 225bbb2..3f425fd 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,19 +2,19 @@ Nous sommes très heureux que vous souhaitiez contribuer à Vite ! Avant de soumettre votre contribution, veuillez lire le guide suivant. Nous vous suggérons également de lire la [Philosophie du projet](https://vitejs.dev/guide/philosophy) dans notre documentation. -Vous pouvez utiliser [StackBlitz Codeflow](https://stackblitz.com/codeflow) pour corriger les bugs ou implémenter des fonctionnalités. Vous verrez un bouton Codeflow sur les problèmes pour commencer une PR pour les corriger. Un bouton apparaîtra également sur les PR pour les revoir sans avoir besoin de vérifier la branche localement. Lorsque vous utilisez Codeflow, le dépôt Vite sera cloné pour vous dans un éditeur en ligne, avec le package Vite construit en mode watch prêt à tester vos modifications. Si vous souhaitez en savoir plus, consultez la [documentation Codeflow](https://developer.stackblitz.com/codeflow/what-is-codeflow). +Vous pouvez utiliser [StackBlitz Codeflow](https://stackblitz.com/codeflow) pour corriger les bugs ou implémenter des fonctionnalités. Vous verrez un bouton Codeflow sur les bugs pour commencer une PR pour les corriger. Un bouton apparaîtra également sur les PR pour les revoir sans avoir besoin de vérifier la branche localement. Lorsque vous utilisez Codeflow, le dépôt Vite sera cloné pour vous dans un éditeur en ligne, avec le package Vite construit en mode watch prêt à tester vos modifications. Si vous souhaitez en savoir plus, consultez la [documentation Codeflow](https://developer.stackblitz.com/codeflow/what-is-codeflow). [![Ouvrir dans Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/vitejs/vite) ## Configuration du dépôt -Pour développer localement, forkez le dépôt Vite et clonez-le dans votre machine locale. Le dépôt Vite est un monorepo utilisant pnpm workspaces. Le gestionnaire de paquets utilisé pour installer et lier les dépendances doit être [pnpm](https://pnpm.io/). +Pour développer en local, forkez le dépôt Vite et clonez-le sur votre machine locale. Le dépôt Vite est un monorepo utilisant pnpm workspaces. Le gestionnaire de paquets utilisé pour installer et lier les dépendances doit être [pnpm](https://pnpm.io/). Pour développer et tester le noyau `vite`: -1. Lancez `pnpm i`dans le dossier racine de Vite. +1. Executez `pnpm i`dans le dossier racine de Vite. -2. Lancez `pnpm run build`dans le dossier racine de Vite. +2. Executez `pnpm run build`dans le dossier racine de Vite. 3. Si vous développez Vite, vous pouvez aller dans `packages/vite`et lancer `pnpm run dev`pour reconstruire Vite automatiquement chaque fois que vous changez son code. @@ -35,7 +35,7 @@ git config --local blame.ignoreRevsFile .git-blame-ignore-revs Pour utiliser les points d’arrêt et explorer l’exécution du code, vous pouvez utiliser la fonctionnalité [« Run and Debug »](https://code.visualstudio.com/docs/editor/debugging) de VS Code. -1. Ajoutez une instruction `debugger`là où vous voulez arrêter l’exécution du code. +1. Ajoutez une instruction `debugger` à l'endroit où vous souhaitez arrêter l’exécution du code. 2. Cliquez sur l’icône « Run and Debug » dans la barre d’activité de l’éditeur, qui ouvre la vue [_Run and Debug_](https://code.visualstudio.com/docs/editor/debugging#_run-and-debug-view). @@ -47,7 +47,7 @@ Pour utiliser les points d’arrêt et explorer l’exécution du code, vous pou ### Débogage des erreurs dans les tests de Vitest en utilisant Playwright (Chromium) -Certaines erreurs sont masquées et cachées en raison des couches de réabstraction et de la nature sandboxée ajoutée par Vitest, Playwright et Chromium. Afin de voir ce qui se passe réellement et le contenu de la console de devtools, suivez cette configuration : +Certaines erreurs sont masquées et cachées en raison des couches d'abstraction et de la nature sandboxée ajoutée par Vitest, Playwright et Chromium. Afin de voir ce qui se passe réellement et le contenu de la console de devtools, suivez cette configuration : 1. Ajoutez une instruction `debugger`dans le hook `afterAll`de`playground/vitestSetup.ts`. Cela mettra en pause l’exécution avant que les tests ne quittent et l’instance de navigateur Playwright ne quitte. diff --git a/docs/blog/announcing-vite2.md b/docs/blog/announcing-vite2.md index 1491676..261c6c6 100644 --- a/docs/blog/announcing-vite2.md +++ b/docs/blog/announcing-vite2.md @@ -10,13 +10,13 @@ head: content: website - - meta - property: og:title - content: Annonce Vite 2.0 + content: Annonce de Vite 2.0 - - meta - property: og:url content: https://vite.dev/blog/announcing-vite2 - - meta - property: og:description - content: Annonce de Vite 2 Release + content: Annonce de la sortie de Vite 2 --- # Announcing Vite 2.0 diff --git a/docs/blog/announcing-vite3.md b/docs/blog/announcing-vite3.md index efb3be8..ed89edb 100644 --- a/docs/blog/announcing-vite3.md +++ b/docs/blog/announcing-vite3.md @@ -1,7 +1,7 @@ --- -title: Vite 3.0 is out! +title: Annonce de Vite 3.0 author: - name: The Vite Team + name: L'équipe Vite date: 2022-07-23 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 3 + content: Annonce de Vite 3 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite3.png @@ -19,41 +19,41 @@ head: content: https://vite.dev/blog/announcing-vite3 - - meta - property: og:description - content: Vite 3 Release Announcement + content: Annonce de la sortie de Vite 3 - - meta - name: twitter:card content: summary_large_image --- -# Vite 3.0 is out! +# Vite 3.0 est sorti ! -_July 23, 2022_ - Check out the [Vite 4.0 announcement](./announcing-vite4.md) +_23 Juillet, 2022_ - Consultez l'annonce de la sortie de [Vite 4.0](./announcing-vite4.md) -In February last year, [Evan You](https://twitter.com/youyuxi) released Vite 2. Since then, its adoption has grown non-stop, reaching more than 1 million npm downloads per week. A sprawling ecosystem rapidly formed after the release. Vite is powering a renewed innovation race in Web frameworks. [Nuxt 3](https://v3.nuxtjs.org/) uses Vite by default. [SvelteKit](https://kit.svelte.dev/), [Astro](https://astro.build/), [Hydrogen](https://hydrogen.shopify.dev/), and [SolidStart](https://docs.solidjs.com/quick-start) are all built with Vite. [Laravel has now decided to use Vite by default](https://laravel.com/docs/9.x/vite). [Vite Ruby](https://vite-ruby.netlify.app/) shows how Vite can improve Rails DX. [Vitest](https://vitest.dev) is making strides as a Vite-native alternative to Jest. Vite is behind [Cypress](https://docs.cypress.io/guides/component-testing/writing-your-first-component-test) and [Playwright](https://playwright.dev/docs/test-components)'s new Component Testing features, Storybook has [Vite as an official builder](https://github.com/storybookjs/builder-vite). And [the list goes on](https://patak.dev/vite/ecosystem.html). Maintainers from most of these projects got involved in improving the Vite core itself, working closely with the Vite [team](https://vite.dev/team) and other contributors. +En février dernier, [Evan You](https://twitter.com/youyuxi) a publié Vite 2. Depuis, son adoption a continué de croître sans cesse, atteignant plus d'1 million de téléchargements par semaine. Un écosystème étendu s'est rapidement formé après sa sortie. Vite est à l'origine d'une course à la réinvention dans le monde des frameworks Web. [Nuxt 3](https://v3.nuxtjs.org/) utilise Vite par défaut. [SvelteKit](https://kit.svelte.dev/), [Astro](https://astro.build/), [Hydrogen](https://hydrogen.shopify.dev/), et [SolidStart](https://docs.solidjs.com/quick-start) sont tous construits avec Vite. [Laravel a décidé d'utiliser Vite par défaut](https://laravel.com/docs/9.x/vite). [Vite Ruby](https://vite-ruby.netlify.app/) montre comment Vite peut améliorer l'expérience de développement de Rails. [Vitest](https://vitest.dev) progresse comme une alternative Vite-native à Jest. Vite est derrière les nouvelles fonctionnalités de [Cypress](https://docs.cypress.io/guides/component-testing/writing-your-first-component-test) et les nouvelles fonctionnalités de tests de composant de [Playwright](https://playwright.dev/docs/test-components), Storybook a [Vite comme constructeur officiel](https://github.com/storybookjs/builder-vite). Et [la liste continue](https://patak.dev/vite/ecosystem.html). Les responsables de la plupart de ces projets ont participé à l'amélioration du noyau Vite en travaillant de près avec le [team](https://vite.dev/team) et d'autres contributeurs. -![Vite 3 Announcement Cover Image](/og-image-announcing-vite3.png) +![Image de couverture de l'annonce de Vite 3](/og-image-announcing-vite3.png) -Today, 16 months from the v2 launch we are happy to announce the release of Vite 3. We decided to release a new Vite major at least every year to align with [Node.js's EOL](https://nodejs.org/en/about/releases/), and take the opportunity to review Vite's API regularly with a short migration path for projects in the ecosystem. +Aujourd'hui, 16 mois après le lancement de Vite 2, nous sommes heureux de publier Vite 3. Nous avons décidé de publier une nouvelle version majeure de Vite au moins tous les ans pour nous aligner avec [Node.js's EOL](https://nodejs.org/en/about/releases/), et prendre l'opportunité de réexaminer régulièrement l'API de Vite avec un chemin de migration court pour les projets de l'écosystème. -Quick links: +Liens rapides : - [Docs](/) -- [Migration Guide](https://v3.vite.dev/guide/migration.html) +- [Guide de migration](https://v3.vite.dev/guide/migration.html) - [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#300-2022-07-13) -If you are new to Vite, we recommend reading the [Why Vite Guide](https://vite.dev/guide/why.html). Then check out [the Getting Started](https://vite.dev/guide/) and [Features guide](https://vite.dev/guide/features) to see what Vite provides out of the box. As usual, contributions are welcome at [GitHub](https://github.com/vitejs/vite). More than [600 collaborators](https://github.com/vitejs/vite/graphs/contributors) have helped improve Vite so far. Follow the updates on [Twitter](https://twitter.com/vite_js), or join discussions with other Vite users on our [Discord chat server](http://chat.vite.dev/). +Si vous êtes nouveau dans Vite, nous vous recommandons de lire le [Guide pourquoi Vite](https://vite.dev/guide/why.html). Ensuite, consultez [le guide de démarrage](https://vite.dev/guide/) et le [Guide des fonctionnalités](https://vite.dev/guide/features) pour voir ce que Vite fournit par défaut. Comme d'habitude, les contributions sont bienvenues sur [GitHub](https://github.com/vitejs/vite). Plus de [600 contributeurs](https://github.com/vitejs/vite/graphs/contributors) ont contribué à améliorer Vite jusqu'à présent. Suivez les mises à jour sur [Twitter](https://twitter.com/vite_js), ou rejoignez les discussions avec d'autres utilisateurs de Vite sur notre [serveur de chat Discord](http://chat.vite.dev/). -## New Documentation +## Nouvelles documentations -Go to [vite.dev](https://vite.dev) to enjoy the new v3 docs. Vite is now using the new [VitePress](https://vitepress.vuejs.org) default theme, with a stunning dark mode between other features. +Consultez [vite.dev](https://vite.dev) pour profiter des nouvelles documentations de Vite 3. Vite utilise maintenant le nouveau [VitePress](https://vitepress.vuejs.org) thème par défaut, avec un mode sombre entre autres fonctionnalités. -[![Vite documentation frontpage](../images/v3-docs.png)](https://vite.dev) +[![Page d'accueil des documentations de Vite](../images/v3-docs.png)](https://vite.dev) -Several projects in the ecosystem have already migrated to it (see [Vitest](https://vitest.dev), [vite-plugin-pwa](https://vite-plugin-pwa.netlify.app/), and [VitePress](https://vitepress.vuejs.org/) itself). +Plusieurs projets de l'écosystème ont déjà migré vers le nouveau thème (voir [Vitest](https://vitest.dev), [vite-plugin-pwa](https://vite-plugin-pwa.netlify.app/), et [VitePress](https://vitepress.vuejs.org/) lui-même). -If you need to access the Vite 2 docs, they will remain online at [v2.vite.dev](https://v2.vite.dev). There is also a new [main.vite.dev](https://main.vite.dev) subdomain, where each commit to Vite’s main branch is auto deployed. This is useful when testing beta versions or contributing to the core’s development. +Si vous avez besoin d'accéder aux documentations de Vite 2, elles resteront en ligne sur [v2.vite.dev](https://v2.vite.dev). Il existe également un nouveau sous-domaine [main.vite.dev](https://main.vite.dev), où chaque commit à la branche principale de Vite est automatiquement déployé. Cela est utile lorsque vous testez des versions bêta ou contribuez au développement du noyau. -There is also now an official Spanish translation, that has been added to the previous Chinese and Japanese translations: +Il existe également une traduction officielle espagnole, qui a été ajoutée aux traductions précédentes en chinois et japonais : - [简体中文](https://cn.vite.dev/) - [日本語](https://ja.vite.dev/) @@ -61,7 +61,7 @@ There is also now an official Spanish translation, that has been added to the pr ## Create Vite Starter Templates -[create-vite](/guide/#trying-vite-online) templates have been a great tool to quickly test Vite with your favorite framework. In Vite 3, all of the templates got a new theme in line with the new docs. Open them online and start playing with Vite 3 now: +Les [templates de démarrage de create-vite](/guide/#trying-vite-online) ont été un outil formidable pour tester rapidement Vite avec votre framework préféré. Dans Vite 3, tous les templates ont reçu un nouveau thème en ligne avec les nouvelles documentations. Ouvrez-les en ligne et commencez à jouer avec Vite 3 maintenant :
Vite logo @@ -101,9 +101,9 @@ There is also now an official Spanish translation, that has been added to the pr } -The theme is now shared by all templates. This should help better convey the scope for these starters as minimal templates to get started with Vite. For more complete solutions including linting, testing setup, and other features, there are official Vite-powered templates for some frameworks like [create-vue](https://github.com/vuejs/create-vue) and [create-svelte](https://github.com/sveltejs/kit). There is a community-maintained list of templates at [Awesome Vite](https://github.com/vitejs/awesome-vite#templates). +Le thème est maintenant partagé par tous les templates. Cela devrait aider à mieux illustrer le champ d'application de ces templates en tant que templates minimaux pour commencer avec Vite. Pour des solutions plus complètes incluant le linting, le setup de tests, et d'autres fonctionnalités, il existe des templates officiels Vite pour certains frameworks comme [create-vue](https://github.com/vuejs/create-vue) et [create-svelte](https://github.com/sveltejs/kit). Il existe également une liste maintenue par la communauté de templates sur [Awesome Vite](https://github.com/vitejs/awesome-vite#templates). -## Dev Improvements +## Améliorations de l'environnement de développement ### Vite CLI @@ -114,20 +114,20 @@ The theme is now shared by all templates. This should help better convey the sco ➜ Network: use --host to expose -Apart from the CLI’s aesthetics improvements, you’ll notice that the default dev server port is now 5173 and the preview server listening at 4173. This change ensures Vite will avoid collisions with other tools. +Outre les améliorations esthétiques du CLI, vous remarquerez que le port du serveur de développement par défaut est maintenant 5173 et le serveur de prévisualisation écoute le port 4173. Ce changement garantit que Vite évitera les collisions avec d'autres outils. -### Improved WebSocket Connection Strategy +### Stratégie de connexion WebSocket améliorée -One of the pain points of Vite 2 was configuring the server when running behind a proxy. Vite 3 changes the default connection scheme so it works out of the box in most scenarios. All these setups are now tested as part of the Vite Ecosystem CI through [`vite-setup-catalogue`](https://github.com/sapphi-red/vite-setup-catalogue). +Un des points de frustration de Vite 2 était la configuration du serveur lors de l'exécution derrière un proxy. Vite 3 change la stratégie de connexion par défaut pour qu'elle fonctionne sans configuration dans la plupart des scénarios. Tous ces setups sont maintenant testés comme partie du Vite Ecosystem CI via [`vite-setup-catalogue`](https://github.com/sapphi-red/vite-setup-catalogue). -### Cold Start Improvements +### Améliorations de la vitesse de démarrage -Vite now avoids full reload during cold start when imports are injected by plugins while crawling the initial statically imported modules ([#8869](https://github.com/vitejs/vite/issues/8869)). +Vite évite maintenant le rechargement complet lors du démarrage froid lorsque les imports sont injectés par des plugins pendant le balayage des modules importés statiquement initialement ([#8869](https://github.com/vitejs/vite/issues/8869)).
- Click to learn more + Cliquer pour en savoir plus -In Vite 2.9, both the scanner and optimizer were run in the background. In the best scenario, where the scanner would find every dependency, no reload was needed in cold start. But if the scanner missed a dependency, a new optimization phase and then a reload were needed. Vite was able to avoid some of these reloads in v2.9, as we detected if the new optimized chunks were compatible with the ones the browser had. But if there was a common dep, the sub-chunks could change and a reload was required to avoid duplicated state. In Vite 3, the optimized deps aren't handed to the browser until the crawling of static imports is done. A quick optimization phase is issued if there is a missing dep (for example, injected by a plugin), and only then, the bundled deps are sent. So, a page reload is no longer needed for these cases. +Dans Vite 2.9, les deux scanners et optimisateurs étaient exécutés en arrière-plan. Dans le meilleur scénario, où le scanner trouverait chaque dépendance, aucun rechargement n'était nécessaire au démarrage froid. Mais si le scanner manquait une dépendance, un nouvel algorithme d'optimisation et un rechargement étaient nécessaires. Vite a été en mesure d'éviter certains de ces rechargements dans v2.9, car nous avons pu détecter si les nouveaux chunks optimisés étaient compatibles avec ceux que le navigateur avait. Mais si une dépendance commune manquait, les sous-chunks pourraient changer et un rechargement serait nécessaire pour éviter un état dupliqué. Dans Vite 3, les dépendances optimisées ne sont pas envoyées au navigateur avant le balayage des imports statiques. Une phase d'optimisation rapide est émise si une dépendance manque (par exemple, injectée par un plugin), et uniquement dans ce cas, les dépendances optimisées sont envoyées. Donc, un rechargement de page n'est plus nécessaire pour ces cas.
@@ -135,41 +135,41 @@ In Vite 2.9, both the scanner and optimizer were run in the background. In the b ### import.meta.glob -`import.meta.glob` support was rewritten. Read about the new features in the [Glob Import Guide](/guide/features.html#glob-import): +La prise en charge de `import.meta.glob` a été réécrite. Lisez les nouvelles fonctionnalités dans le [Guide des imports globaux](/guide/features.html#glob-import): -[Multiple Patterns](/guide/features.html#multiple-patterns) can be passed as an array +[Les patterns multiples](/guide/features.html#multiple-patterns) peuvent être passés comme un tableau ```js import.meta.glob(['./dir/*.js', './another/*.js']) ``` -[Negative Patterns](/guide/features.html#negative-patterns) are now supported (prefixed with `!`) to ignore some specific files +[Les patterns négatifs](/guide/features.html#negative-patterns) sont maintenant supportés (préfixés avec `!`) pour ignorer certains fichiers spécifiques ```js import.meta.glob(['./dir/*.js', '!**/bar.js']) ``` -[Named Imports](/guide/features.html#named-imports) can be specified to improve tree-shaking +[Les imports nommés](/guide/features.html#named-imports) peuvent être spécifiés pour améliorer le tree-shaking ```js import.meta.glob('./dir/*.js', { import: 'setup' }) ``` -[Custom Queries](/guide/features.html#custom-queries) can be passed to attach metadata +[Les requêtes personnalisées](/guide/features.html#custom-queries) peuvent être passées pour attacher des métadonnées ```js import.meta.glob('./dir/*.js', { query: { custom: 'data' } }) ``` -[Eager Imports](/guide/features.html#glob-import) is now passed as a flag +Les [Eager Imports](/guide/features.html#glob-import) sont maintenant passés comme un flag ```js import.meta.glob('./dir/*.js', { eager: true }) ``` -### Aligning WASM Import with Future Standards +### Alignement avec les standards futurs pour les imports WASM -The WebAssembly import API has been revised to avoid collisions with future standards and to make it more flexible: +L'API d'importation WASM a été revue pour éviter les collisions avec les standards futurs et pour la rendre plus flexible : ```js import init from './example.wasm?init' @@ -179,98 +179,98 @@ init().then((instance) => { }) ``` -Learn more in the [WebAssembly guide](/guide/features.html#webassembly) +En savoir plus dans le [Guide WASM](/guide/features.html#webassembly) -## Build Improvements +## Améliorations de la construction -### ESM SSR Build by Default +### ESM SSR Build par défaut -Most SSR frameworks in the ecosystem were already using ESM builds. So, Vite 3 makes ESM the default format for SSR builds. This allows us to streamline previous [SSR externalization heuristics](https://vite.dev/guide/ssr.html#ssr-externals), externalizing dependencies by default. +La plupart des frameworks SSR dans l'écosystème utilisaient déjà des builds ESM. Donc, Vite 3 fait de l'ESM le format par défaut pour les builds SSR. Cela permet de simplifier les heuristiques d'[externalisation SSR](https://vite.dev/guide/ssr.html#ssr-externals) précédentes, externalisant les dépendances par défaut. -### Improved Relative Base Support +### Améliorations de la prise en charge de la base relative -Vite 3 now properly supports relative base (using `base: ''`), allowing built assets to be deployed to different bases without re-building. This is useful when the base isn't known at build time, for example when deploying to content-addressable networks like [IPFS](https://ipfs.io/). +Vite 3 prend en charge correctement la base relative (en utilisant `base: ''`), permettant aux assets construits d'être déployés sur différentes bases sans re-construction. Cela est utile lorsque la base n'est pas connue au moment du build, par exemple lors du déploiement sur des réseaux de distribution de contenu comme [IPFS](https://ipfs.io/). -## Experimental Features +## Fonctionnalités expérimentales -### Built Asset Paths fine-grained Control (Experimental) +### Contrôle de chemin de fichier construit (Expérimental) -There are other deploy scenarios where this isn't enough. For example, if the generated hashed assets need to be deployed to a different CDN from the public files, then finer-grained control is required over path generation at build time. Vite 3 provides an experimental API to modify the built file paths. Check [Build Advanced Base Options](/guide/build.html#advanced-base-options) for more information. +Il existe d'autres scénarios de déploiement où cela ne suffit pas. Par exemple, si les assets générés avec hash nécessitent d'être déployés sur un autre CDN que les fichiers publics, alors un contrôle plus fin sur la génération de chemins est nécessaire au moment du build. Vite 3 fournit une API expérimentale pour modifier les chemins des fichiers construits. En savoir plus dans [Options avancées de base de construction](/guide/build.html#advanced-base-options). -### Esbuild Deps Optimization at Build Time (Experimental) +### Optimisation des dépendances à la construction avec esbuild (Expérimental) -One of the main differences between dev and build time is how Vite handles dependencies. During build time, [`@rollup/plugin-commonjs`](https://github.com/rollup/plugins/tree/master/packages/commonjs) is used to allow importing CJS only dependencies (like React). When using the dev server, esbuild is used instead to pre-bundle and optimize dependencies, and an inline interop scheme is applied while transforming user code importing CJS deps. During the development of Vite 3, we introduced the changes needed to also allow the use of [esbuild to optimize dependencies during build time](https://v3.vite.dev/guide/migration.html#using-esbuild-deps-optimization-at-build-time). [`@rollup/plugin-commonjs`](https://github.com/rollup/plugins/tree/master/packages/commonjs) can then be avoided, making dev and build time work in the same way. +Une des principales différences entre le développement et le build est la façon dont Vite gère les dépendances. Pendant la construction, [`@rollup/plugin-commonjs`](https://github.com/rollup/plugins/tree/master/packages/commonjs) est utilisé pour permettre l'importation de dépendances CJS uniquement (comme React). Lors de l'utilisation du serveur de développement, esbuild est utilisé à la place pour pré-bundler et optimiser les dépendances, et un schéma d'interopération en ligne est appliqué pendant la transformation du code utilisateur important des dépendances CJS. Pendant le développement de Vite 3, nous avons introduit les modifications nécessaires pour permettre également l'utilisation de [esbuild pour optimiser les dépendances pendant le build](https://v3.vite.dev/guide/migration.html#using-esbuild-deps-optimization-at-build-time). [`@rollup/plugin-commonjs`](https://github.com/rollup/plugins/tree/master/packages/commonjs) peut alors être évité, faisant en sorte que le développement et le build fonctionnent de la même manière. -Given that Rollup v3 will be out in the next months, and we're going to follow up with another Vite major, we've decided to make this mode optional to reduce v3 scope and give Vite and the ecosystem more time to work out possible issues with the new CJS interop approach during build time. Frameworks may switch to using esbuild deps optimization during build time by default at their own pace before Vite 4. +Étant donné que Rollup v3 sortira dans les prochains mois, et que nous allons suivre avec une autre version majeure de Vite, nous avons décidé de rendre ce mode optionnel pour réduire la portée de v3 et donner plus de temps à Vite et l'écosystème pour travailler sur les problèmes possibles avec la nouvelle approche d'interopération CJS pendant le build. Les frameworks peuvent basculer vers l'utilisation de l'optimisation des dépendances esbuild pendant le build par défaut à leur propre rythme avant la sortie de Vite 4. -### HMR Partial Accept (Experimental) +### HMR Partial Accept (Expérimental) -There is opt-in support for [HMR Partial Accept](https://github.com/vitejs/vite/pull/7324). This feature could unlock finer-grained HMR for framework components that export several bindings in the same module. You can learn more at [the discussion for this proposal](https://github.com/vitejs/vite/discussions/7309). +Il existe un support integré pour [HMR Partial Accept](https://github.com/vitejs/vite/pull/7324). Cette fonctionnalité pourrait débloquer un HMR plus fin pour les composants de framework qui exportent plusieurs liaisons dans le même module. En savoir plus sur [la discussion pour cette proposition](https://github.com/vitejs/vite/discussions/7309). -## Bundle Size Reduction +## Réduction de la taille du bundle -Vite cares about its publish and install footprint; a fast installation of a new app is a feature. Vite bundles most of its dependencies and tries to use modern lightweight alternatives where possible. Continuing with this ongoing goal, Vite 3 publish size is 30% smaller than v2. +Vite s'occupe de son empreinte de publication et d'installation ; une installation rapide d'une nouvelle application est une fonctionnalité. Vite regroupe la plupart de ses dépendances et essaie d'utiliser des alternatives modernes légères si possible. En poursuivant cet objectif, la taille de publication de Vite 3 est 30% plus petite que v2. -| | Publish Size | Install Size | +| | Taille de publication | Taille d'installation | | ----------- | :----------: | :----------: | | Vite 2.9.14 | 4.38MB | 19.1MB | | Vite 3.0.0 | 3.05MB | 17.8MB | -| Reduction | -30% | -7% | +| Réduction | -30% | -7% | -In part, this reduction was possible by making some dependencies that most users weren't needing optional. First, [Terser](https://github.com/terser/terser) is no longer installed by default. This dependency was no longer needed since we already made esbuild the default minifier for both JS and CSS in Vite 2. If you use `build.minify: 'terser'`, you'll need to install it (`npm add -D terser`). We also moved [node-forge](https://github.com/digitalbazaar/forge) out of the monorepo, implementing support for automatic https certificate generation as a new plugin: [`@vitejs/plugin-basic-ssl`](https://v3.vite.dev/guide/migration.html#automatic-https-certificate-generation). Since this feature only creates untrusted certificates that are not added to the local store, it didn't justify the added size. +En partie, cette réduction a été possible en rendant certaines dépendances optionnelles pour la plupart des utilisateurs. Premièrement, [Terser](https://github.com/terser/terser) n'est plus installé par défaut. Cette dépendance n'était plus nécessaire depuis que nous avons fait d'esbuild le minificateur par défaut pour les deux JS et CSS dans Vite 2. Si vous utilisez `build.minify: 'terser'`, vous devez l'installer (`npm add -D terser`). Nous avons également déplacé [node-forge](https://github.com/digitalbazaar/forge) hors du monorepo, en implémentant le support pour la génération automatique de certificats HTTPS en tant que nouveau plugin : [`@vitejs/plugin-basic-ssl`](https://v3.vite.dev/guide/migration.html#automatic-https-certificate-generation). Étant donné que cette fonctionnalité n'a créé que des certificats non fiables qui ne sont pas ajoutés au store local, elle n'a pas justifié la taille supplémentaire. -## Bug Fixing +## Correction des bugs -A triaging marathon was spearheaded by [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), that recently joined the Vite team. During the past three months, the Vite open issues were reduced from 770 to 400. And this dive was achieved while the newly open PRs were at an all-time high. At the same time, [@haoqunjiang](https://twitter.com/haoqunjiang) had also curated a comprehensive [overview of Vite issues](https://github.com/vitejs/vite/discussions/8232). +Un triage marathon a été lancé par [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), qui ont rejoint l'équipe Vite récemment. Durant les trois derniers mois, les problèmes ouverts de Vite ont été réduits de 770 à 400. Et cette réduction a été atteinte alors que le nombre de PRs ouvertes était à son maximum. À la même époque, [@haoqunjiang](https://twitter.com/haoqunjiang) avait également élaboré une vue d'ensemble complète des problèmes de Vite : [Vue d'ensemble des problèmes de Vite](https://github.com/vitejs/vite/discussions/8232). -[![Graph of open issues and pull requests in Vite](../images/v3-open-issues-and-PRs.png)](https://www.repotrends.com/vitejs/vite) +[![Graphique des issues et PRs ouverts dans Vite](../images/v3-open-issues-and-PRs.png)](https://www.repotrends.com/vitejs/vite) -[![Graph of new issues and pull requests in Vite](../images/v3-new-open-issues-and-PRs.png)](https://www.repotrends.com/vitejs/vite) +[![Graphique des nouvelles issues et PRs dans Vite](../images/v3-new-open-issues-and-PRs.png)](https://www.repotrends.com/vitejs/vite) -## Compatibility Notes +## Notes de compatibilité -- Vite no longer supports Node.js 12 / 13 / 15, which reached its EOL. Node.js 14.18+ / 16+ is now required. -- Vite is now published as ESM, with a CJS proxy to the ESM entry for compatibility. -- The Modern Browser Baseline now targets browsers which support the [native ES Modules](https://caniuse.com/es6-module), [native ESM dynamic import](https://caniuse.com/es6-module-dynamic-import), and [`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta) features. -- JS file extensions in SSR and library mode now use a valid extension (`js`, `mjs`, or `cjs`) for output JS entries and chunks based on their format and the package type. +- Vite ne supporte plus Node.js 12 / 13 / 15, qui a atteint son EOL. Node.js 14.18+ / 16+ est maintenant requis. +- Vite est maintenant publié en tant que ESM, avec un proxy CJS vers l'entrée ESM pour la compatibilité. +- La ligne de base des navigateurs modernes cible maintenant les navigateurs qui prennent en charge les [modules ES natifs](https://caniuse.com/es6-module), [native ESM dynamic import](https://caniuse.com/es6-module-dynamic-import), et les fonctionnalités [`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta). +- Les extensions de fichiers JS dans le mode SSR et en mode bibliothèque utilisent maintenant une extension valide (`js`, `mjs`, ou `cjs`) pour les entrées et les chunks de sortie JS en fonction de leur format et du type de package. -Learn more in the [Migration Guide](https://v3.vite.dev/guide/migration.html). +En savoir plus dans le [Guide de migration](https://v3.vite.dev/guide/migration.html). -## Upgrades to Vite Core +## Améliorations de Vite Core -While working towards Vite 3, we also improved the contributing experience for collaborators to [Vite Core](https://github.com/vitejs/vite). +Alors que nous travaillions vers Vite 3, nous avons également amélioré l'expérience de contribution pour les collaborateurs de [Vite Core](https://github.com/vitejs/vite). -- Unit and E2E tests have been migrated to [Vitest](https://vitest.dev), providing a faster and more stable DX. This move also works as dog fooding for an important infrastructure project in the ecosystem. -- VitePress build is now tested as part of CI. -- Vite upgraded to [pnpm 7](https://pnpm.io/), following the rest of the ecosystem. -- Playgrounds have been moved to [`/playgrounds`](https://github.com/vitejs/vite/tree/main/playground) out of packages directory. -- The packages and playgrounds are now `"type": "module"`. -- Plugins are now bundled using [unbuild](https://github.com/unjs/unbuild), and [plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) and [plugin-legacy](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy) were moved to TypeScript. +- Les tests unitaires et E2E ont été migrés vers [Vitest](https://vitest.dev), fournissant une expérience de développement plus rapide et plus stable. Cette migration fonctionne également comme un test pour un projet infrastructure important dans l'écosystème. +- Le build de VitePress est maintenant testé dans la CI. +- Vite a été mis à jour vers [pnpm 7](https://pnpm.io/), suivant le reste de l'écosystème. +- Les playgrounds ont été déplacés hors du répertoire des packages dans [`/playgrounds`](https://github.com/vitejs/vite/tree/main/playground). +- Les packages et les playgrounds sont maintenant `"type": "module"`. +- Les plugins sont maintenant regroupés en utilisant [unbuild](https://github.com/unjs/unbuild), [plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) et [plugin-legacy](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy) ont été déplacés vers TypeScript. -## The Ecosystem is Ready for v3 +## L'écosystème est prêt pour v3 -We have worked closely with projects in the ecosystem to ensure that frameworks powered by Vite are ready for Vite 3. [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) allows us to run the CI's from the leading players in the ecosystem against Vite's main branch and receive timely reports before introducing a regression. Today's release should soon be compatible with most projects using Vite. +Nous avons travaillé de près avec les projets de l'écosystème pour s'assurer que les frameworks alimentés par Vite sont prêts pour Vite 3. [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) nous permet de lancer les CI des principaux joueurs de l'écosystème contre le main branch de Vite et de recevoir des rapports en temps réel avant de présenter une régression. Aujourd'hui, cette sortie devrait être compatible avec la plupart des projets utilisant Vite. -## Acknowledgments +## Remerciements -Vite 3 is the result of the aggregate effort of members of the [Vite Team](/team) working together with ecosystem project maintainers and other collaborators to Vite core. +Vite 3 est le résultat du travail collectif des membres du [Vite Team](/team) travaillant ensemble avec les responsables de projets de l'écosystème et d'autres collaborateurs pour le noyau de Vite. -We want to thank everyone that have implemented features, and fixes, given feedback, and have been involved in Vite 3: +Nous voulons remercier toutes les personnes qui ont implémenté des fonctionnalités, corrigé des bugs, donné des retours, et ont été impliquées dans Vite 3 : -- Vite team members [@youyuxi](https://twitter.com/youyuxi), [@patak_dev](https://twitter.com/patak_dev), [@antfu7](https://twitter.com/antfu7), [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), [@haoqunjiang](https://twitter.com/haoqunjiang), [@poyoho](https://github.com/poyoho), [@Shini_92](https://twitter.com/Shini_92), and [@retropragma](https://twitter.com/retropragma). -- [@benmccann](https://github.com/benmccann), [@danielcroe](https://twitter.com/danielcroe), [@brillout](https://twitter.com/brillout), [@sheremet_va](https://twitter.com/sheremet_va), [@userquin](https://twitter.com/userquin), [@enzoinnocenzi](https://twitter.com/enzoinnocenzi), [@maximomussini](https://twitter.com/maximomussini), [@IanVanSchooten](https://twitter.com/IanVanSchooten), the [Astro team](https://astro.build/), and all other maintainers of frameworks and plugins in the ecosystem in that helped shape v3. -- [@dominikg](https://github.com/dominikg) for his work on vite-ecosystem-ci. -- [@ZoltanKochan](https://twitter.com/ZoltanKochan) for his work on [pnpm](https://pnpm.io/), and for his responsiveness when we needed support with it. -- [@rixo](https://github.com/rixo) for HMR Partial Accept support. -- [@KiaKing85](https://twitter.com/KiaKing85) for getting the theme ready for the Vite 3 release, and [@\_brc_dd](https://twitter.com/_brc_dd) for working on the VitePress internals. -- [@CodingWithCego](https://twitter.com/CodingWithCego) for the new Spanish translation, and [@ShenQingchuan](https://twitter.com/ShenQingchuan), [@hiro-lapis](https://github.com/hiro-lapis) and others in the Chinese and Japanese translations teams for keeping the translated docs up to date. +- Les membres de l'équipe Vite [@youyuxi](https://twitter.com/youyuxi), [@patak_dev](https://twitter.com/patak_dev), [@antfu7](https://twitter.com/antfu7), [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), [@haoqunjiang](https://twitter.com/haoqunjiang), [@poyoho](https://github.com/poyoho), [@Shini_92](https://twitter.com/Shini_92), et [@retropragma](https://twitter.com/retropragma). +- [@benmccann](https://github.com/benmccann), [@danielcroe](https://twitter.com/danielcroe), [@brillout](https://twitter.com/brillout), [@sheremet_va](https://twitter.com/sheremet_va), [@userquin](https://twitter.com/userquin), [@enzoinnocenzi](https://twitter.com/enzoinnocenzi), [@maximomussini](https://twitter.com/maximomussini), [@IanVanSchooten](https://twitter.com/IanVanSchooten), l'équipe [Astro](https://astro.build/), et tous les responsables de frameworks et de plugins dans l'écosystème qui ont contribué à la mise en place de v3. +- [@dominikg](https://github.com/dominikg) pour son travail sur vite-ecosystem-ci. +- [@ZoltanKochan](https://twitter.com/ZoltanKochan) pour son travail sur [pnpm](https://pnpm.io/), et pour sa réactivité lorsque nous avons eu besoin de son support. +- [@rixo](https://github.com/rixo) pour le support de HMR Partial Accept. +- [@KiaKing85](https://twitter.com/KiaKing85) pour avoir préparé le thème pour la sortie de Vite 3, et [@\_brc_dd](https://twitter.com/_brc_dd) pour travailler sur les internals de VitePress. +- [@CodingWithCego](https://twitter.com/CodingWithCego) pour la traduction espagnole, et [@ShenQingchuan](https://twitter.com/ShenQingchuan), [@hiro-lapis](https://github.com/hiro-lapis) et d'autres membres des équipes de traduction en chinois et japonais pour maintenir les documentations traduites à jour. -We also want to thank individuals and companies sponsoring the Vite team, and companies investing in Vite development: some of [@antfu7](https://twitter.com/antfu7)'s work on Vite and the ecosystem is part of his job at [Nuxt Labs](https://nuxtlabs.com/), and [StackBlitz](https://stackblitz.com/) hired [@patak_dev](https://twitter.com/patak_dev) to work full time on Vite. +Nous voulons également remercier les individus et les entreprises qui soutiennent l'équipe Vite, et les entreprises qui investissent dans le développement de Vite : une partie du travail de [@antfu7](https://twitter.com/antfu7) sur Vite et l'écosystème est son travail à [Nuxt Labs](https://nuxtlabs.com/), et [StackBlitz](https://stackblitz.com/) a embauché [@patak_dev](https://twitter.com/patak_dev) pour travailler à plein temps sur Vite. -## What's Next +## Qu'en est-il de la prochaine version majeure ? -We'll take the following months to ensure a smooth transition for all the projects built on top of Vite. So the first minors will be focused on continuing our triaging efforts with a focus on newly opened issues. +Nous allons prendre les prochains mois pour nous assurer que la transition sera fluide pour tous les projets construits sur Vite. Donc, les premières majeures seront concentrées sur la continuation de nos efforts de triage avec un focus sur les nouveaux problèmes ouverts. -The Rollup team is [working on its next major](https://twitter.com/lukastaegert/status/1544186847399743488), to be released in the following months. Once the Rollup plugins ecosystem has time to update, we'll follow up with a new Vite major. This will give us another opportunity to introduce more significant changes this year, which we could take to stabilize some of the experimental features introduced in this release. +L'équipe Rollup [travaille sur sa prochaine majeure](https://twitter.com/lukastaegert/status/1544186847399743488), qui sera publiée dans les prochains mois. Une fois que l'écosystème des plugins Rollup aura le temps de mettre à jour, nous ferons suivre avec une nouvelle majeure de Vite. Cela nous donnera une autre opportunité de présenter des changements plus significatifs cette année, ce que nous pourrions prendre pour stabiliser certaines fonctionnalités expérimentales introduites dans cette version. -If you are interested in helping improve Vite, the best way to get on board is to help with triaging issues. Join [our Discord](https://chat.vite.dev) and look for the `#contributing` channel. Or get involved in our `#docs`, `#help` others, or create plugins. We are just getting started. There are many open ideas to keep improving Vite's DX. +Si vous êtes intéressé pour améliorer Vite, la meilleure façon de vous impliquer est de contribuer au triage des problèmes. Rejoignez [notre serveur Discord](https://chat.vite.dev) et cherchez le canal `#contributing`. Ou participez à nos `#docs`, `#help` d'autres, ou créez des plugins. Nous sommes juste au début. Il y a beaucoup d'idées ouvertes pour améliorer l'expérience de développement de Vite. From fb10664766635e92c5ed95b96706beb6d1f71850 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Thu, 6 Mar 2025 21:27:12 +0100 Subject: [PATCH 09/40] traduction de l'article d'annonce de vite 4-3 --- docs/blog/announcing-vite4-3.md | 46 ++++++++++++++++----------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/blog/announcing-vite4-3.md b/docs/blog/announcing-vite4-3.md index b725308..6ce6c2e 100644 --- a/docs/blog/announcing-vite4-3.md +++ b/docs/blog/announcing-vite4-3.md @@ -1,7 +1,7 @@ --- -title: Vite 4.3 is out! +title: Vite 4.3 est sorti ! author: - name: The Vite Team + name: L'équipe Vite date: 2023-04-20 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 4.3 + content: Annonce de Vite 4.3 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite4-3.png @@ -19,52 +19,52 @@ head: content: https://vite.dev/blog/announcing-vite4-3 - - meta - property: og:description - content: Vite 4.3 Release Announcement + content: Annonce de la sortie de Vite 4.3 - - meta - name: twitter:card content: summary_large_image --- -# Vite 4.3 is out! +# Vite 4.3 est sorti ! -_April 20, 2023_ +_20 avril 2023_ -![Vite 4.3 Announcement Cover Image](/og-image-announcing-vite4-3.png) +![Image de couverture de l'annonce de Vite 4.3](/og-image-announcing-vite4-3.png) -Quick links: +Liens rapides : - Docs: [English](/), [简体中文](https://cn.vite.dev/), [日本語](https://ja.vite.dev/), [Español](https://es.vite.dev/), [Português](https://pt.vite.dev/) - [Vite 4.3 Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#430-2023-04-20) -## Performance Improvements +## Améliorations des performances -In this minor, we focused on improving the dev server performance. The resolve logic got streamlined, improving hot paths and implementing smarter caching for finding `package.json`, TS config files, and resolved URL in general. +Dans cette majeure, nous nous sommes concentrés sur l'amélioration des performances du serveur de développement. La logique de résolution a été simplifiée, améliorant les chemins de hot path et implémentant un cache plus intelligent pour trouver `package.json`, les fichiers de configuration TS et les URL résolues en général. -You can read a detailed walkthrough of the performance work done in this blog post by one of Vite Contributors: [How we made Vite 4.3 faaaaster 🚀](https://sun0day.github.io/blog/vite/why-vite4_3-is-faster.html). +Vous pouvez lire un guide détaillé de l'amélioration des performances dans cet article de blog par un contributeur de Vite : [Comment nous avons rendu Vite 4.3 plus rapide 🚀](https://sun0day.github.io/blog/vite/why-vite4_3-is-faster.html). -This sprint resulted in speed improvements across the board compared to Vite 4.2. +Ce sprint a abouti à des améliorations de performances sur tous les tableaux comparé à Vite 4.2. -These are the performance improvements as measured by [sapphi-red/performance-compare](https://github.com/sapphi-red/performance-compare), which tests an app with 1000 React Components cold and warm dev server startup time as well as HMR times for a root and a leaf component: +Ces sont les améliorations de performances mesurées par [sapphi-red/performance-compare](https://github.com/sapphi-red/performance-compare), qui teste une application avec 1000 composants React froids et chauds et les temps de démarrage du serveur de développement ainsi que les temps de HMR pour un composant racine et un composant feuille : -| **Vite (babel)** | Vite 4.2 | Vite 4.3 | Improvement | +| **Vite (babel)** | Vite 4.2 | Vite 4.3 | Amélioration | | :----------------- | --------: | -------: | ----------: | | **dev cold start** | 17249.0ms | 5132.4ms | -70.2% | | **dev warm start** | 6027.8ms | 4536.1ms | -24.7% | | **Root HMR** | 46.8ms | 26.7ms | -42.9% | | **Leaf HMR** | 27.0ms | 12.9ms | -52.2% | -| **Vite (swc)** | Vite 4.2 | Vite 4.3 | Improvement | +| **Vite (swc)** | Vite 4.2 | Vite 4.3 | Amélioration | | :----------------- | --------: | -------: | ----------: | | **dev cold start** | 13552.5ms | 3201.0ms | -76.4% | | **dev warm start** | 4625.5ms | 2834.4ms | -38.7% | | **Root HMR** | 30.5ms | 24.0ms | -21.3% | | **Leaf HMR** | 16.9ms | 10.0ms | -40.8% | -![Vite 4.3 vs 4.2 startup time comparison](/vite4-3-startup-time.png) +![Comparaison des temps de démarrage de Vite 4.3 vs 4.2](/vite4-3-startup-time.png) -![Vite 4.3 vs 4.2 HMR time comparison](/vite4-3-hmr-time.png) +![Comparaison des temps de HMR de Vite 4.3 vs 4.2](/vite4-3-hmr-time.png) -You can read more information about the benchmark [here](https://gist.github.com/sapphi-red/25be97327ee64a3c1dce793444afdf6e). Specs and Versions for this performance run: +Vous pouvez en savoir plus sur le benchmark [ici](https://gist.github.com/sapphi-red/25be97327ee64a3c1dce793444afdf6e). Spécifications et versions pour cette exécution de performance : - CPU: Ryzen 9 5900X, Memory: DDR4-3600 32GB, SSD: WD Blue SN550 NVME SSD - Windows 10 Pro 21H2 19044.2846 @@ -75,16 +75,16 @@ You can read more information about the benchmark [here](https://gist.github.com - Vite 4.2 (swc): Vite 4.2.1 + plugin-react-swc 3.2.0 - Vite 4.3 (swc): Vite 4.3.0 + plugin-react-swc 3.3.0 -Early adopters have also reported seeing 1.5x-2x dev startup time improvement on real apps while testing the Vite 4.3 beta. We'd love to know the results for your apps. +Les early adopters ont également signalé une amélioration des temps de démarrage du serveur de développement de 1.5x à 2x sur les applications réelles lors de la mise à jour vers la version bêta de Vite 4.3. Nous aimerions connaître les résultats pour vos applications. ## Profiling -We'll continue to work on Vite's performance. We're working on an official [Benchmark tool](https://github.com/vitejs/vite-benchmark) for Vite that let us get performance metrics for each Pull Request. +Nous continuerons à travailler sur les performances de Vite. Nous travaillons sur une [outil de benchmark officiel](https://github.com/vitejs/vite-benchmark) pour Vite qui nous permet de mesurer les performances pour chaque Pull Request. -And [vite-plugin-inspect](https://github.com/antfu/vite-plugin-inspect) now has more performance-related features to help you identify which plugins or middlewares are the bottleneck for your applications. +Et [vite-plugin-inspect](https://github.com/antfu/vite-plugin-inspect) a maintenant plus de fonctionnalités liées aux performances pour vous aider à identifier quels plugins ou middlewares sont le goulot d'étranglement pour vos applications. -Using `vite --profile` (and then pressing `p`) once the page loads will save a CPU profile of the dev server startup. You can open them in an app as [speedscope](https://www.speedscope.app/) to identify performance issues. And you can share your findings with the Vite Team in a [Discussion](https://github.com/vitejs/vite/discussions) or in [Vite's Discord](https://chat.vite.dev). +Utiliser `vite --profile` (et appuyer sur `p` une fois que la page est chargée) enregistrera un profil CPU du démarrage du serveur de développement. Vous pouvez les ouvrir dans une application comme [speedscope](https://www.speedscope.app/) pour identifier les problèmes de performances. Et vous pouvez partager vos retombées avec l'équipe Vite dans un [Discussion](https://github.com/vitejs/vite/discussions) ou dans [Vite's Discord](https://chat.vite.dev). ## Next Steps -We decided to do a single Vite Major this year aligning with the [EOL of Node.js 16](https://endoflife.date/nodejs) in September, dropping support for both Node.js 14 and 16 in it. If you would like to get involved, we started a [Vite 5 Discussion](https://github.com/vitejs/vite/discussions/12466) to gather early feedback. +Nous avons décidé de faire une seule majeure Vite cette année en alignant avec la [EOL de Node.js 16](https://endoflife.date/nodejs) en septembre, abandonnant le support pour les deux versions de Node.js 14 et 16. Si vous souhaitez participer, nous avons commencé un [Discussion sur Vite 5](https://github.com/vitejs/vite/discussions/12466) pour collecter des retombées. From 2e917dbc67c7f71b487193bdafa88dc41b9689cc Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 7 Mar 2025 21:20:30 +0100 Subject: [PATCH 10/40] traduction de l'article d'annonce de vite 4 --- docs/blog/announcing-vite4.md | 104 +++++++++++++++++----------------- 1 file changed, 52 insertions(+), 52 deletions(-) diff --git a/docs/blog/announcing-vite4.md b/docs/blog/announcing-vite4.md index f17bca9..4964d6c 100644 --- a/docs/blog/announcing-vite4.md +++ b/docs/blog/announcing-vite4.md @@ -1,7 +1,7 @@ --- -title: Vite 4.0 is out! +title: Vite 4.0 est sorti ! author: - name: The Vite Team + name: L'équipe Vite date: 2022-12-09 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 4 + content: Annonce de Vite 4 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite4.png @@ -19,122 +19,122 @@ head: content: https://vite.dev/blog/announcing-vite4 - - meta - property: og:description - content: Vite 4 Release Announcement + content: Annonce de la sortie de Vite 4 - - meta - name: twitter:card content: summary_large_image --- -# Vite 4.0 is out! +# Vite 4.0 est sorti ! -_December 9, 2022_ - Check out the [Vite 5.0 announcement](./announcing-vite5.md) +_9 décembre 2022_ - Voir l'annonce de la [sortie de Vite 5.0](./announcing-vite5.md) -Vite 3 [was released](./announcing-vite3.md) five months ago. npm downloads per week have gone from 1 million to 2.5 million since then. The ecosystem has matured too, and continues to grow. In this year's [Jamstack Conf survey](https://twitter.com/vite_js/status/1589665610119585793), usage among the community jumped from 14% to 32% while keeping a high 9.7 satisfaction score. We saw the stable releases of [Astro 1.0](https://astro.build/), [Nuxt 3](https://v3.nuxtjs.org/), and other Vite-powered frameworks that are innovating and collaborating: [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/). Storybook announced first-class support for Vite as one of its main features for [Storybook 7.0](https://storybook.js.org/blog/first-class-vite-support-in-storybook/). Deno now [supports Vite](https://www.youtube.com/watch?v=Zjojo9wdvmY). [Vitest](https://vitest.dev) adoption is exploding, it will soon represent half of Vite's npm downloads. Nx is also investing in the ecosystem, and [officially supports Vite](https://nx.dev/packages/vite). +Vite 3 [a été publié](./announcing-vite3.md) il y a cinq mois. Les téléchargements de npm par semaine sont passés de 1 million à 2,5 millions depuis. L'écosystème a également évolué, et continue de grandir. Dans le [sondage de Jamstack Conf](https://twitter.com/vite_js/status/1589665610119585793), l'utilisation par la communauté a grimpé de 14% à 32% tout en maintenant une note de satisfaction de 9,7. Nous avons vu les versions stables de [Astro 1.0](https://astro.build/), [Nuxt 3](https://v3.nuxtjs.org/), et d'autres frameworks Vite-alimentés qui innovent et collaborent : [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/). Storybook a annoncé le support officiel de Vite comme une de ses fonctionnalités principales pour [Storybook 7.0](https://storybook.js.org/blog/first-class-vite-support-in-storybook/). Deno [supporte maintenant Vite](https://www.youtube.com/watch?v=Zjojo9wdvmY). L'adoption de [Vitest](https://vitest.dev) explose, elle représentera bientôt la moitié des téléchargements de Vite sur npm. Nx investit également dans l'écosystème, et [officiellement supporte Vite](https://nx.dev/packages/vite). -[![Vite 4 Ecosystem](/ecosystem-vite4.png)](https://viteconf.org/2022/replay) +[![Écosystème Vite 4](/ecosystem-vite4.png)](https://viteconf.org/2022/replay) -As a showcase of the growth Vite and related projects have experienced, the Vite ecosystem gathered on October 11th at [ViteConf 2022](https://viteconf.org/2022/replay). We saw representatives from the main web framework and tools tell stories of innovation and collaboration. And in a symbolic move, the Rollup team choose that exact day to release [Rollup 3](https://rollupjs.org). +Pour illustrer la croissance que Vite et les projets associés ont expérimentée, l'écosystème Vite s'est réuni le 11 octobre à la [ViteConf 2022](https://viteconf.org/2022/replay). Nous avons vu des représentants des principaux frameworks web et outils raconter des histoires d'innovation et de collaboration. Et dans un mouvement symbolique, l'équipe de Rollup a choisi exactement ce jour pour publier [Rollup 3](https://rollupjs.org). -Today, the Vite [team](https://vite.dev/team) with the help of our ecosystem partners, is happy to announce the release of Vite 4, powered during build time by Rollup 3. We've worked with the ecosystem to ensure a smooth upgrade path for this new major. Vite is now using [Rollup 3](https://github.com/vitejs/vite/issues/9870), which allowed us to simplify Vite's internal asset handling and has many improvements. See the [Rollup 3 release notes here](https://github.com/rollup/rollup/releases/tag/v3.0.0). +Aujourd'hui, l'équipe Vite, avec l'aide de nos partenaires de l'écosystème, est heureuse d'annoncer la sortie de Vite 4, alimentée par Rollup 3 lors du build. Nous avons travaillé avec l'écosystème pour assurer une mise à niveau fluide pour cette nouvelle version majeure. Vite utilise maintenant [Rollup 3](https://github.com/vitejs/vite/issues/9870), ce qui nous a permis de simplifier le traitement des assets de Vite et a apporté de nombreuses améliorations. Voir les notes de la [sortie de Rollup 3 ici](https://github.com/rollup/rollup/releases/tag/v3.0.0). -![Vite 4 Announcement Cover Image](/og-image-announcing-vite4.png) +![Image de couverture de l'annonce de Vite 4](/og-image-announcing-vite4.png) -Quick links: +Liens rapides : - [Docs](/) -- [Migration Guide](https://v4.vite.dev/guide/migration.html) +- [Guide de migration](https://v4.vite.dev/guide/migration.html) - [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#400-2022-12-09) -Docs in other languages: +Docs dans d'autres langues : - [简体中文](https://cn.vite.dev/) - [日本語](https://ja.vite.dev/) - [Español](https://es.vite.dev/) -If you recently started using Vite, we suggest reading the [Why Vite Guide](https://vite.dev/guide/why.html) and checking out [the Getting Started](https://vite.dev/guide/) and [Features guide](https://vite.dev/guide/features). If you want to get involved, contributions are welcome at [GitHub](https://github.com/vitejs/vite). Almost [700 collaborators](https://github.com/vitejs/vite/graphs/contributors) have contributed to Vite. Follow the updates on [Twitter](https://twitter.com/vite_js) and [Mastodon](https://webtoo.ls/@vite), or join collaborate with others on our [Discord community](http://chat.vite.dev/). +Si vous avez commencé à utiliser Vite récemment, nous vous suggérons de lire le [Guide pourquoi Vite](https://vite.dev/guide/why.html) et de consulter le [guide de démarrage](https://vite.dev/guide/) et le [guide des fonctionnalités](https://vite.dev/guide/features). Si vous souhaitez participer, les contributions sont les bienvenues sur [GitHub](https://github.com/vitejs/vite). Environ [700 contributeurs](https://github.com/vitejs/vite/graphs/contributors) ont contribué à Vite. Suivez les mises à jour sur [Twitter](https://twitter.com/vite_js) et [Mastodon](https://webtoo.ls/@vite), ou rejoignez la communauté pour collaborer avec d'autres sur notre [communauté Discord](http://chat.vite.dev/). -## Start playing with Vite 4 +## Débuter avec Vite 4 -Use `pnpm create vite` to scaffold a Vite project with your preferred framework, or open a started template online to play with Vite 4 using [vite.new](https://vite.new). +Utilisez `pnpm create vite` pour créer un projet Vite avec votre framework préféré, ou ouvrez un modèle de démarrage en ligne pour jouer avec Vite 4 en utilisant [vite.new](https://vite.new). -You can also run `pnpm create vite-extra` to get access to templates from other frameworks and runtimes (Solid, Deno, SSR, and library starters). `create vite-extra` templates are also available when you run `create vite` under the `Others` option. +Vous pouvez également exécuter `pnpm create vite-extra` pour accéder aux modèles de démarrage de d'autres frameworks et runtimes (Solid, Deno, SSR, et modèles de bibliothèque). Les modèles `create vite-extra` sont également disponibles lorsque vous exécutez `create vite` sous l'option `Others`. -Note that Vite starter templates are intended to be used as a playground to test Vite with different frameworks. When building your next project, we recommend reaching out to the starters recommended by each framework. Some frameworks now redirect in `create vite` to their starters too (`create-vue` and `Nuxt 3` for Vue, and `SvelteKit` for Svelte). +Notez que les modèles de démarrage Vite sont conçus pour être utilisés comme un terrain de jeu pour tester Vite avec différents frameworks. Lorsque vous construisez votre prochain projet, nous vous recommandons de choisir les modèles de démarrage recommandés par chaque framework. Certains frameworks redirigent maintenant dans `create vite` vers leurs modèles (`create-vue` et `Nuxt 3` pour Vue, et `SvelteKit` pour Svelte). -## New React plugin using SWC during development +## Nouveau plugin React utilisant SWC lors du développement -[SWC](https://swc.rs/) is now a mature replacement for [Babel](https://babeljs.io/), especially in the context of React projects. SWC's React Fast Refresh implementation is a lot faster than Babel, and for some projects, it is now a better alternative. From Vite 4, two plugins are available for React projects with different tradeoffs. We believe that both approaches are worth supporting at this point, and we'll continue to explore improvements to both plugins in the future. +[SWC](https://swc.rs/) est maintenant un remplaçant mature pour [Babel](https://babeljs.io/), surtout dans le contexte des projets React. L'implémentation de Fast Refresh de SWC est beaucoup plus rapide que Babel, et pour certains projets, il est maintenant une meilleure alternative. Dans Vite 4, deux plugins sont disponibles pour les projets React avec différents compromis. Nous croyons que les deux approches sont devenues nécessaires à ce stade, et nous continuerons à explorer les améliorations de ces deux plugins dans le futur. ### @vitejs/plugin-react -[@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react) is a plugin that uses esbuild and Babel, achieving fast HMR with a small package footprint and the flexibility of being able to use the Babel transform pipeline. +[@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react) est un plugin qui utilise esbuild et Babel, atteignant un HMR rapide avec un faible encombrement de package et la flexibilité de pouvoir utiliser le pipeline de transformation de Babel. -### @vitejs/plugin-react-swc (new) +### @vitejs/plugin-react-swc (nouveau) -[@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) is a new plugin that uses esbuild during build, but replaces Babel with SWC during development. For big projects that don't require non-standard React extensions, cold start and Hot Module Replacement (HMR) can be significantly faster. +[@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) est un nouveau plugin qui utilise esbuild lors du build, mais remplace Babel par SWC lors du développement. Pour les gros projets qui n'ont pas besoin d'extensions React non standard, le démarrage froid et le remplacement de modules (HMR) peuvent être significativement plus rapides. -## Browser Compatibility +## Compatibilité avec les navigateurs -The modern browser build now targets `safari14` by default for wider ES2020 compatibility. This means that modern builds can now use [`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) and that the [nullish coalescing operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing) isn't transpiled anymore. If you need to support older browsers, you can add [`@vitejs/plugin-legacy`](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy) as usual. +Le build pour les navigateurs modernes cible maintenant `safari14` par défaut pour une compatibilité ES2020 plus large. Cela signifie que les builds modernes peuvent maintenant utiliser [`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) et que l'opérateur [nullish coalescing](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing) n'est plus transpilé. Si vous avez besoin de supporter des navigateurs plus anciens, vous pouvez ajouter [`@vitejs/plugin-legacy`](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy) comme d'habitude. -## Importing CSS as a String +## Importation de CSS en tant que chaîne -In Vite 3, importing the default export of a `.css` file could introduce a double loading of CSS. +Dans Vite 3, l'importation de l'exportation par défaut d'un fichier `.css` pouvait introduire un double chargement de CSS. ```ts import cssString from './global.css' ``` -This double loading could occur since a `.css` file will be emitted and it's likely that the CSS string will also be used by the application code — for example, injected by the framework runtime. From Vite 4, the `.css` default export [has been deprecated](https://github.com/vitejs/vite/issues/11094). The `?inline` query suffix modifier needs to be used in this case, as that doesn't emit the imported `.css` styles. +Cela pouvait survenir car un fichier `.css` était émis et il était probable que la chaîne CSS était également utilisée par le code de l'application — par exemple, injectée par le runtime du framework. Depuis Vite 4, l'exportation par défaut d'un fichier `.css` [a été dépréciée](https://github.com/vitejs/vite/issues/11094). Le suffixe de requête `?inline` doit être utilisé dans ce cas, car cela ne génère pas les styles importés `.css`. ```ts import stuff from './global.css?inline' ``` -Learn more in the [Migration Guide](https://v4.vite.dev/guide/migration.html). +En savoir plus dans le [Guide de migration](https://v4.vite.dev/guide/migration.html). -## Environment Variables +## Variables d'environnement -Vite now uses `dotenv` 16 and `dotenv-expand` 9 (previously `dotenv` 14 and `dotenv-expand` 5). If you have a value including `#` or `` ` ``, you will need to wrap them with quotes. +Vite utilise maintenant `dotenv` 16 et `dotenv-expand` 9 (précédemment `dotenv` 14 et `dotenv-expand` 5). Si vous avez une valeur incluant `#` ou `` ` ``, vous devrez l'entourer de guillemets. ```diff -VITE_APP=ab#cd`ef +VITE_APP="ab#cd`ef" ``` -For more details, see the [`dotenv`](https://github.com/motdotla/dotenv/blob/master/CHANGELOG.md) and [`dotenv-expand` changelog](https://github.com/motdotla/dotenv-expand/blob/master/CHANGELOG.md). +Pour plus de détails, voir le [changelog de `dotenv`](https://github.com/motdotla/dotenv/blob/master/CHANGELOG.md) et le [changelog de `dotenv-expand`](https://github.com/motdotla/dotenv-expand/blob/master/CHANGELOG.md). -## Other Features +## Autres fonctionnalités -- CLI Shortcuts (press `h` during dev to see them all) ([#11228](https://github.com/vitejs/vite/pull/11228)) -- Support for patch-package when pre bundling dependencies ([#10286](https://github.com/vitejs/vite/issues/10286)) -- Cleaner build logs output ([#10895](https://github.com/vitejs/vite/issues/10895)) and switch to `kB` to align with browser dev tools ([#10982](https://github.com/vitejs/vite/issues/10982)) -- Improved error messages during SSR ([#11156](https://github.com/vitejs/vite/issues/11156)) +- Raccourcis de CLI (appuyez sur `h` pendant le développement pour voir tous les raccourcis) ([#11228](https://github.com/vitejs/vite/pull/11228)) +- Support pour `patch-package` lors du pré-bundling des dépendances ([#10286](https://github.com/vitejs/vite/issues/10286)) +- Logs de build plus propre ([#10895](https://github.com/vitejs/vite/issues/10895)) et switch vers `kB` pour aligner avec les outils de développement du navigateur ([#10982](https://github.com/vitejs/vite/issues/10982)) +- Messages d'erreur améliorés lors du SSR ([#11156](https://github.com/vitejs/vite/issues/11156)) -## Reduced Package Size +## Taille du package réduite -Vite cares about its footprint, to speed up installation, especially in the use case of playgrounds for documentation and reproductions. And once more, this major brings improvements in Vite's package size. Vite 4 install size is 23% smaller compared to vite 3.2.5 (14.1 MB vs 18.3 MB). +Vite s'occupe de sa taille, pour accélérer l'installation, surtout dans le cas de terrains de jeu pour la documentation et la reproduction. Encore une fois, cette majeure apporte des améliorations dans la taille du package de Vite. La taille de l'installation de Vite 4 est 23% plus petite par rapport à vite 3.2.5 (14.1 MB vs 18.3 MB). -## Upgrades to Vite Core +## Améliorations de Vite Core -[Vite Core](https://github.com/vitejs/vite) and [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) continue to evolve to provide a better experience to maintainers and collaborators and to ensure that Vite development scales to cope with the growth in the ecosystem. +[Vite Core](https://github.com/vitejs/vite) et [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) continuent d'évoluer pour fournir une meilleure expérience aux mainteneurs et aux collaborateurs et pour garantir que le développement de Vite s'adapte à la croissance de l'écosystème. -### Framework plugins out of core +### Plugins de framework hors core -[`@vitejs/plugin-vue`](https://github.com/vitejs/vite-plugin-vue) and [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react) have been part of Vite core monorepo since the first versions of Vite. This helped us to get a close feedback loop when making changes as we were getting both Core and the plugins tested and released together. With [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) we can get this feedback with these plugins developed on independent repositories, so from Vite 4, [they have been moved out of the Vite core monorepo](https://github.com/vitejs/vite/pull/11158). This is meaningful for Vite's framework-agnostic story and will allow us to build independent teams to maintain each of the plugins. If you have bugs to report or features to request, please create issues on the new repositories moving forward: [`vitejs/vite-plugin-vue`](https://github.com/vitejs/vite-plugin-vue) and [`vitejs/vite-plugin-react`](https://github.com/vitejs/vite-plugin-react). +[`@vitejs/plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react) sont des plugins de base de Vite depuis les premières versions de Vite. Cela nous a permis de maintenir une boucle de feedback étroite lorsque nous faisions des changements, car nous obtenions à la fois le noyau et les plugins testés et publiés ensemble. Avec [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci), nous pouvons obtenir ce feedback avec ces plugins développés sur des dépôts indépendants, donc depuis Vite 4, [ils ont été déplacés hors du monorepo de Vite core](https://github.com/vitejs/vite/pull/11158). Cela est significatif pour l'histoire de Vite sans framework, et permettra de construire des équipes indépendantes pour maintenir chaque plugin. Si vous avez des bugs à signaler ou des fonctionnalités à demander, veuillez créer des problèmes sur les nouveaux dépôts : [`vitejs/vite-plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`vitejs/vite-plugin-react`](https://github.com/vitejs/vite-plugin-react). -### vite-ecosystem-ci improvements +### Améliorations de vite-ecosystem-ci -[vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) extends Vite's CI by providing on-demand status reports on the state of the CIs of [most major downstream projects](https://github.com/vitejs/vite-ecosystem-ci/tree/main/tests). We run vite-ecosystem-ci three times a week against Vite's main branch and receive timely reports before introducing a regression. Vite 4 will soon be compatible with most projects using Vite, which already prepared branches with the needed changes and will be releasing them in the next few days. We are also able to run vite-ecosystem-ci on-demand on PRs using `/ecosystem-ci run` in a comment, allowing us to know [the effect of changes](https://github.com/vitejs/vite/pull/11269#issuecomment-1343365064) before they hit main. +[vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci) étend la CI de Vite en fournissant des rapports de statut sur-demande sur l'état des CIs de [la plupart des principaux projets en aval](https://github.com/vitejs/vite-ecosystem-ci/tree/main/tests). Nous exécutons vite-ecosystem-ci trois fois par semaine contre le main de Vite et recevons des rapports ponctuels avant d'introduire une régression. Vite 4 sera compatible avec la plupart des projets utilisant Vite, qui ont déjà préparé les branches avec les modifications nécessaires et publieront des versions compatibles dans les jours à venir. Nous sommes également en mesure d'exécuter vite-ecosystem-ci sur-demande sur les PRs en utilisant `/ecosystem-ci run` dans un commentaire, ce qui nous permet de connaître [l'effet des changements](https://github.com/vitejs/vite/pull/11269#issuecomment-1343365064) avant qu'ils soient mergés dans le main. -## Acknowledgments +## Remerciements -Vite 4 wouldn't be possible without uncountable hours of work by Vite contributors, many of them maintainers of downstream projects and plugins, and the efforts of the [Vite Team](/team). All of us have worked together to improve Vite's DX once more, for every framework and app using it. We're grateful to be able to improve a common base for such a vibrant ecosystem. +Vite 4 ne serait pas possible sans un nombre d'heure de travail incalculable par les contributeurs de Vite, beaucoup d'entre eux étant mainteneurs de projets en aval et de plugins, et les efforts du [Vite Team](/team). Nous avons travaillé ensemble pour améliorer le DX de Vite une fois de plus, pour chaque framework et app utilisant Vite. Nous sommes reconnaissants d'être en mesure d'améliorer une base commune pour un tel écosystème. -We're also thankful to individuals and companies sponsoring the Vite team, and companies investing directly in Vite's future: [@antfu7](https://twitter.com/antfu7)'s work on Vite and the ecosystem is part of his job at [Nuxt Labs](https://nuxtlabs.com/), [Astro](https://astro.build) is funding [@bluwyoo](https://twitter.com/bluwyoo)'s' Vite core work, and [StackBlitz](https://stackblitz.com/) hires [@patak_dev](https://twitter.com/patak_dev) to work full time on Vite. +Nous sommes également reconnaissants aux individus et entreprises qui soutiennent l'équipe Vite, et les entreprises qui investissent directement dans le futur de Vite : le travail de [@antfu7](https://twitter.com/antfu7) sur Vite et l'écosystème est une partie de son travail à [Nuxt Labs](https://nuxtlabs.com/), [Astro](https://astro.build) finance le travail de [@bluwyoo](https://twitter.com/bluwyoo) sur le noyau de Vite, et [StackBlitz](https://stackblitz.com/) emploie [@patak_dev](https://twitter.com/patak_dev) pour travailler à plein temps sur Vite. -## Next steps +## Prochaines étapes -Our immediate focus would be on triaging newly opened issues to avoid disruption by possible regressions. If you would like to get involved and help us improve Vite, we suggest starting with issues triaging. Join [our Discord](https://chat.vite.dev) and reach out on the `#contributing` channel. Polish our `#docs` story, and `#help` others. We need to continue to build a helpful and welcoming community for the next wave of users, as Vite's adoption continues to grow. +Notre focus immédiat est de trier les nouveaux bugs ouverts pour éviter les régressions. Si vous souhaitez participer et nous aider à améliorer Vite, nous vous suggérons de commencer par le triage des bugs. Rejoignez [notre Discord](https://chat.vite.dev) et atteignez-nous sur le canal `#contributing`. Améliorez notre `#docs` et `#help`pour aider les autres. Nous devons continuer à construire une communauté utile et accueillante pour la prochaine vague d'utilisateurs, car l'adoption de Vite continue de croître. -There are a lot of open fronts to keep improving the DX of everyone that has chosen Vite to power their frameworks and develop their apps. Onwards! +Il y a beaucoup de fronts à améliorer pour améliorer le DX de tout ceux qui ont choisi Vite pour alimenter leurs frameworks et développer leurs apps. En avant! From 4778c8accc2e0c45ab6a1e5cb7602391dec64f19 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 7 Mar 2025 22:28:26 +0100 Subject: [PATCH 11/40] traduction de l'article d'annonce de vite 5 5-1 6 --- docs/blog/announcing-vite3.md | 6 +- docs/blog/announcing-vite4.md | 2 +- docs/blog/announcing-vite5-1.md | 118 ++++++++++++++++---------------- docs/blog/announcing-vite5.md | 94 ++++++++++++------------- docs/blog/announcing-vite6.md | 96 +++++++++++++------------- 5 files changed, 158 insertions(+), 158 deletions(-) diff --git a/docs/blog/announcing-vite3.md b/docs/blog/announcing-vite3.md index ed89edb..d468f27 100644 --- a/docs/blog/announcing-vite3.md +++ b/docs/blog/announcing-vite3.md @@ -221,7 +221,7 @@ En partie, cette réduction a été possible en rendant certaines dépendances o ## Correction des bugs -Un triage marathon a été lancé par [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), qui ont rejoint l'équipe Vite récemment. Durant les trois derniers mois, les problèmes ouverts de Vite ont été réduits de 770 à 400. Et cette réduction a été atteinte alors que le nombre de PRs ouvertes était à son maximum. À la même époque, [@haoqunjiang](https://twitter.com/haoqunjiang) avait également élaboré une vue d'ensemble complète des problèmes de Vite : [Vue d'ensemble des problèmes de Vite](https://github.com/vitejs/vite/discussions/8232). +Un triage marathon a été lancé par [@bluwyoo](https://twitter.com/bluwyoo), [@sapphi_red](https://twitter.com/sapphi_red), qui ont rejoint l'équipe Vite récemment. Durant les trois derniers mois, les tickets ouverts de Vite ont été réduits de 770 à 400. Et cette réduction a été atteinte alors que le nombre de PRs ouvertes était à son maximum. À la même époque, [@haoqunjiang](https://twitter.com/haoqunjiang) avait également élaboré une vue d'ensemble complète des tickets de Vite : [Vue d'ensemble des tickets de Vite](https://github.com/vitejs/vite/discussions/8232). [![Graphique des issues et PRs ouverts dans Vite](../images/v3-open-issues-and-PRs.png)](https://www.repotrends.com/vitejs/vite) @@ -269,8 +269,8 @@ Nous voulons également remercier les individus et les entreprises qui soutienne ## Qu'en est-il de la prochaine version majeure ? -Nous allons prendre les prochains mois pour nous assurer que la transition sera fluide pour tous les projets construits sur Vite. Donc, les premières majeures seront concentrées sur la continuation de nos efforts de triage avec un focus sur les nouveaux problèmes ouverts. +Nous allons prendre les prochains mois pour nous assurer que la transition sera fluide pour tous les projets construits sur Vite. Donc, les premières majeures seront concentrées sur la continuation de nos efforts de triage avec un focus sur les nouveaux tickets ouverts. L'équipe Rollup [travaille sur sa prochaine majeure](https://twitter.com/lukastaegert/status/1544186847399743488), qui sera publiée dans les prochains mois. Une fois que l'écosystème des plugins Rollup aura le temps de mettre à jour, nous ferons suivre avec une nouvelle majeure de Vite. Cela nous donnera une autre opportunité de présenter des changements plus significatifs cette année, ce que nous pourrions prendre pour stabiliser certaines fonctionnalités expérimentales introduites dans cette version. -Si vous êtes intéressé pour améliorer Vite, la meilleure façon de vous impliquer est de contribuer au triage des problèmes. Rejoignez [notre serveur Discord](https://chat.vite.dev) et cherchez le canal `#contributing`. Ou participez à nos `#docs`, `#help` d'autres, ou créez des plugins. Nous sommes juste au début. Il y a beaucoup d'idées ouvertes pour améliorer l'expérience de développement de Vite. +Si vous êtes intéressé pour améliorer Vite, la meilleure façon de vous impliquer est de contribuer au triage des tickets. Rejoignez [notre serveur Discord](https://chat.vite.dev) et cherchez le canal `#contributing`. Ou participez à nos `#docs`, `#help` d'autres, ou créez des plugins. Nous sommes juste au début. Il y a beaucoup d'idées ouvertes pour améliorer l'expérience de développement de Vite. diff --git a/docs/blog/announcing-vite4.md b/docs/blog/announcing-vite4.md index 4964d6c..ebc9a68 100644 --- a/docs/blog/announcing-vite4.md +++ b/docs/blog/announcing-vite4.md @@ -121,7 +121,7 @@ Vite s'occupe de sa taille, pour accélérer l'installation, surtout dans le cas ### Plugins de framework hors core -[`@vitejs/plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react) sont des plugins de base de Vite depuis les premières versions de Vite. Cela nous a permis de maintenir une boucle de feedback étroite lorsque nous faisions des changements, car nous obtenions à la fois le noyau et les plugins testés et publiés ensemble. Avec [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci), nous pouvons obtenir ce feedback avec ces plugins développés sur des dépôts indépendants, donc depuis Vite 4, [ils ont été déplacés hors du monorepo de Vite core](https://github.com/vitejs/vite/pull/11158). Cela est significatif pour l'histoire de Vite sans framework, et permettra de construire des équipes indépendantes pour maintenir chaque plugin. Si vous avez des bugs à signaler ou des fonctionnalités à demander, veuillez créer des problèmes sur les nouveaux dépôts : [`vitejs/vite-plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`vitejs/vite-plugin-react`](https://github.com/vitejs/vite-plugin-react). +[`@vitejs/plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react) sont des plugins de base de Vite depuis les premières versions de Vite. Cela nous a permis de maintenir une boucle de feedback étroite lorsque nous faisions des changements, car nous obtenions à la fois le noyau et les plugins testés et publiés ensemble. Avec [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci), nous pouvons obtenir ce feedback avec ces plugins développés sur des dépôts indépendants, donc depuis Vite 4, [ils ont été déplacés hors du monorepo de Vite core](https://github.com/vitejs/vite/pull/11158). Cela est significatif pour l'histoire de Vite sans framework, et permettra de construire des équipes indépendantes pour maintenir chaque plugin. Si vous avez des bugs à signaler ou des fonctionnalités à demander, veuillez créer des tickets sur les nouveaux dépôts : [`vitejs/vite-plugin-vue`](https://github.com/vitejs/vite-plugin-vue) et [`vitejs/vite-plugin-react`](https://github.com/vitejs/vite-plugin-react). ### Améliorations de vite-ecosystem-ci diff --git a/docs/blog/announcing-vite5-1.md b/docs/blog/announcing-vite5-1.md index bbb24a8..9c1566a 100644 --- a/docs/blog/announcing-vite5-1.md +++ b/docs/blog/announcing-vite5-1.md @@ -1,7 +1,7 @@ --- -title: Vite 5.1 is out! +title: Vite 5.1 est sorti ! author: - name: The Vite Team + name: L'équipe Vite date: 2024-02-08 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 5.1 + content: Annonce de Vite 5.1 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite5-1.png @@ -19,116 +19,116 @@ head: content: https://vite.dev/blog/announcing-vite5-1 - - meta - property: og:description - content: Vite 5.1 Release Announcement + content: Annonce de la sortie de Vite 5.1 - - meta - name: twitter:card content: summary_large_image --- -# Vite 5.1 is out! +# Vite 5.1 est sorti ! -_February 8, 2024_ +_8 février 2024_ -![Vite 5.1 Announcement Cover Image](/og-image-announcing-vite5-1.png) +![Image de couverture de l'annonce de Vite 5.1](/og-image-announcing-vite5-1.png) -Vite 5 [was released](./announcing-vite5.md) last November, and it represented another big leap for Vite and the ecosystem. A few weeks ago we celebrated 10 million weekly npm downloads and 900 contributors to the Vite repo. Today, we're excited to announce the release of Vite 5.1. +Vite 5 [a été publié](./announcing-vite5.md) en novembre dernier, et représentait un grand pas pour Vite et l'écosystème. Quelques semaines plus tard, nous célébrons les 10 millions de téléchargements hebdomadaires npm et 900 contributeurs au dépôt Vite. Aujourd'hui, nous sommes heureux d'annoncer la sortie de Vite 5.1. -Quick links: [Docs](/), [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#510-2024-02-08) +Liens rapides : [Docs](/), [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#510-2024-02-08) -Docs in other languages: [简体中文](https://cn.vite.dev/), [日本語](https://ja.vite.dev/), [Español](https://es.vite.dev/), [Português](https://pt.vite.dev/), [한국어](https://ko.vite.dev/), [Deutsch](https://de.vite.dev/) +Docs dans d'autres langues : [简体中文](https://cn.vite.dev/), [日本語](https://ja.vite.dev/), [Español](https://es.vite.dev/), [Português](https://pt.vite.dev/), [한국어](https://ko.vite.dev/), [Deutsch](https://de.vite.dev/) -Try Vite 5.1 online in StackBlitz: [vanilla](https://vite.new/vanilla-ts), [vue](https://vite.new/vue-ts), [react](https://vite.new/react-ts), [preact](https://vite.new/preact-ts), [lit](https://vite.new/lit-ts), [svelte](https://vite.new/svelte-ts), [solid](https://vite.new/solid-ts), [qwik](https://vite.new/qwik-ts). +Essayez Vite 5.1 en ligne dans StackBlitz : [vanilla](https://vite.new/vanilla-ts), [vue](https://vite.new/vue-ts), [react](https://vite.new/react-ts), [preact](https://vite.new/preact-ts), [lit](https://vite.new/lit-ts), [svelte](https://vite.new/svelte-ts), [solid](https://vite.new/solid-ts), [qwik](https://vite.new/qwik-ts). -If you're new to Vite, we suggest reading first the [Getting Started](/guide/) and [Features](/guide/features) guides. +Si vous êtes nouveau dans Vite, nous vous suggérons de lire d'abord les guides [Débuter](/guide/) et les [Fonctionnalités](/guide/features). -To stay up to date, follow us on [X](https://x.com/vite_js) or [Mastodon](https://webtoo.ls/@vite). +Pour rester à jour, suivez-nous sur [X](https://x.com/vite_js) ou [Mastodon](https://webtoo.ls/@vite). -## Vite Runtime API +## API de runtime de Vite -Vite 5.1 adds experimental support for a new Vite Runtime API. It allows running any code by processing it with Vite plugins first. It is different from `server.ssrLoadModule` because the runtime implementation is decoupled from the server. This lets library and framework authors implement their own layer of communication between the server and the runtime. This new API is intended to replace Vite's current SSR primitives once it is stable. +Vite 5.1 ajoute un support expérimental pour une nouvelle API de runtime de Vite. Elle permet d'exécuter du code en le traitant avec des plugins Vite. Elle est différente de `server.ssrLoadModule` car l'implémentation du runtime est découplée du serveur. Cela permet aux auteurs de bibliothèques et de frameworks d'implémenter leur propre couche de communication entre le serveur et le runtime. Cette nouvelle API est destinée à remplacer les primitives SSR actuelles de Vite une fois qu'elles seront stables. -The new API brings many benefits: +Cette nouvelle API apporte de nombreux avantages : -- Support for HMR during SSR. -- It is decoupled from the server, so there is no limit on how many clients can use a single server - every client has its own module cache (you can even communicate with it how you want - using message channel/fetch call/direct function call/websocket). -- It doesn't depend on any node/bun/deno built-in APIs, so it can run in any environment. -- It's easy to integrate with tools that have their own mechanism to run code (you can provide a runner to use `eval` instead of `new AsyncFunction` for example). +- Support pour HMR lors de SSR. +- Elle est découplée du serveur, donc il n'y a pas de limite sur le nombre de clients qui peuvent utiliser un serveur unique - chaque client a son propre cache de modules (vous pouvez même communiquer avec lui comme vous le souhaitez - en utilisant un canal de message/appel de fetch/appel de fonction directe/websocket). +- Elle ne dépend d'aucune API de node/bun/deno intégrée, donc elle peut s'exécuter dans n'importe quel environnement. +- Elle est facile à intégrer avec des outils qui ont leur propre mécanisme pour exécuter du code (vous pouvez fournir un runner pour utiliser `eval` à la place de `new AsyncFunction` par exemple). -The initial idea [was proposed by Pooya Parsa](https://github.com/nuxt/vite/pull/201) and implemented by [Anthony Fu](https://github.com/antfu) as the [vite-node](https://github.com/vitest-dev/vitest/tree/main/packages/vite-node#readme) package to [power Nuxt 3 Dev SSR](https://antfu.me/posts/dev-ssr-on-nuxt) and later also used as the base for [Vitest](https://vitest.dev). So the general idea of vite-node has been battle-tested for quite some time now. This is a new iteration of the API by [Vladimir Sheremet](https://github.com/sheremet-va), who had already re-implemented vite-node in Vitest and took the learnings to make the API even more powerful and flexible when adding it to Vite Core. The PR was one year in the makings, you can see the evolution and discussions with ecosystem maintainers [here](https://github.com/vitejs/vite/issues/12165). +L'idée initiale [a été proposée par Pooya Parsa](https://github.com/nuxt/vite/pull/201) et implémentée par [Anthony Fu](https://github.com/antfu) comme le package [vite-node](https://github.com/vitest-dev/vitest/tree/main/packages/vite-node#readme) pour [alimenter le SSR de Nuxt 3](https://antfu.me/posts/dev-ssr-on-nuxt) et a été également utilisée comme base pour [Vitest](https://vitest.dev). L'idée générale de vite-node a été testée pendant un certain temps maintenant. C'est une nouvelle itération de l'API par [Vladimir Sheremet](https://github.com/sheremet-va), qui avait déjà implémenté vite-node dans Vitest et a pris les enseignements pour rendre l'API encore plus puissante et flexible lorsqu'elle a été ajoutée au noyau de Vite. La PR a été en cours pendant un an, vous pouvez voir l'évolution et les discussions avec les mainteneurs de l'écosystème [ici](https://github.com/vitejs/vite/issues/12165). ::: info -The Vite Runtime API evolved into the Module Runner API, released in Vite 6 as part of the [Environment API](/guide/api-environment). +L'API de runtime de Vite a évolué en API de runner de module, publiée dans Vite 6 comme partie de l'API [Environment](/guide/api-environment). ::: -## Features +## Fonctionnalités -### Improved support for `.css?url` +### Amélioration du support pour `.css?url` -Import CSS files as URLs now works reliably and correctly. This was the last remaining hurdle in Remix's move to Vite. See ([#15259](https://github.com/vitejs/vite/issues/15259)). +Importer des fichiers CSS en tant que URL fonctionne maintenant de manière fiable et correcte. C'était la dernière étape pour Remix pour passer à Vite. Voir ([#15259](https://github.com/vitejs/vite/issues/15259)). -### `build.assetsInlineLimit` now supports a callback +### `build.assetsInlineLimit` supporte maintenant un callback -Users can now [provide a callback](/config/build-options.html#build-assetsinlinelimit) that returns a boolean to opt-in or opt-out of inlining for specific assets. If `undefined` is returned, the default logic applies. See ([#15366](https://github.com/vitejs/vite/issues/15366)). +Les utilisateurs peuvent maintenant [fournir un callback](/config/build-options.html#build-assetsinlinelimit) qui retourne un booléen pour l'opt-in ou l'opt-out de l'inlining pour des assets spécifiques. Si `undefined` est retourné, la logique par défaut s'applique. Voir ([#15366](https://github.com/vitejs/vite/issues/15366)). -### Improved HMR for circular import +### Amélioration du HMR pour les imports circulaires -In Vite 5.0, accepted modules within circular imports always triggered a full page reload even if they can be handled fine in the client. This is now relaxed to allow HMR to apply without a full page reload, but if any error happens during HMR, the page will be reloaded. See ([#15118](https://github.com/vitejs/vite/issues/15118)). +Dans Vite 5.0, les modules acceptés dans les imports circulaires ont toujours déclenché un rechargement de page complet même si elles peuvent être gérées correctement dans le client. Cela est maintenant allegé pour permettre le HMR sans rechargement de page, mais si une erreur se produit pendant le HMR, la page sera rechargée. Voir ([#15118](https://github.com/vitejs/vite/issues/15118)). -### Support `ssr.external: true` to externalize all SSR packages +### Support de `ssr.external: true` pour externaliser tous les packages SSR -Historically, Vite externalizes all packages except for linked packages. This new option can be used to force externalize all packages including linked packages too. This is handy in tests within monorepos where we want to emulate the usual case of all packages externalized, or when using `ssrLoadModule` to load an arbitrary file and we want to always external packages as we don't care about HMR. See ([#10939](https://github.com/vitejs/vite/issues/10939)). +Historiquement, Vite externalise tous les packages sauf les packages liés. Cette nouvelle option peut être utilisée pour forcer l'externalisation de tous les packages, y compris les packages liés. C'est pratique dans les tests dans des monorepos où nous voulons simuler le cas habituel de tous les packages externalisés, ou lorsque nous utilisons `ssrLoadModule` pour charger un fichier arbitraire et que nous voulons toujours externaliser les packages comme nous ne nous soucions pas de HMR. Voir ([#10939](https://github.com/vitejs/vite/issues/10939)). -### Expose `close` method in the preview server +### Exposition de la méthode `close` dans le serveur de prévisualisation -The preview server now exposes a `close` method, which will properly teardown the server including all opened socket connections. See ([#15630](https://github.com/vitejs/vite/issues/15630)). +Le serveur de prévisualisation expose maintenant une méthode `close`, qui nettoie correctement le serveur y compris toutes les connexions de socket ouvertes. Voir ([#15630](https://github.com/vitejs/vite/issues/15630)). -## Performance improvements +## Améliorations de performance -Vite keeps getting faster with each release, and Vite 5.1 is packed with performance improvements. We measured the loading time for 10K modules (25 level deep tree) using [vite-dev-server-perf](https://github.com/yyx990803/vite-dev-server-perf) for all minor versions from Vite 4.0. This is a good benchmark to measure the effect of Vite's bundle-less approach. Each module is a small TypeScript file with a counter and imports to other files in the tree, so this mostly measuring the time it takes to do the requests a separate modules. In Vite 4.0, loading 10K modules took 8 seconds on a M1 MAX. We had a breakthrough in [Vite 4.3 were we focused on performance](./announcing-vite4-3.md), and we were able to load them in 6.35 seconds. In Vite 5.1, we managed to do another performance leap. Vite is now serving the 10K modules in 5.35 seconds. +Vite continue d'être plus rapide avec chaque version, et Vite 5.1 est packagé avec des améliorations de performance. Nous avons mesuré le temps de chargement pour 10K modules (arbre de 25 niveaux) en utilisant [vite-dev-server-perf](https://github.com/yyx990803/vite-dev-server-perf) pour toutes les versions mineures de Vite 4.0. C'est un bon benchmark pour mesurer l'effet de l'approche sans bundle de Vite. Chaque module est un petit fichier TypeScript avec un compteur et des imports vers d'autres fichiers dans l'arbre, donc cela mesure principalement le temps qu'il faut pour faire les requêtes pour des modules séparés. Dans Vite 4.0, le chargement de 10K modules prenait 8 secondes sur un M1 MAX. Nous avons eu une rupture dans [Vite 4.3 où nous nous sommes concentrés sur les performances](./announcing-vite4-3.md), et nous avons été en mesure de les charger en 6.35 secondes. Dans Vite 5.1, nous avons réussi une autre amélioration des performances. Vite est maintenant en mesure de servir les 10K modules en 5.35 secondes. -![Vite 10K Modules Loading time progression](/vite5-1-10K-modules-loading-time.png) +![Progression du temps de chargement des 10K modules de Vite](/vite5-1-10K-modules-loading-time.png) -The results of this benchmark run on Headless Puppeteer and are a good way to compare versions. They don't represent the time as experienced by users though. When running the same 10K modules in an Incognito window is Chrome, we have: +Les résultats de cette exécution du benchmark sur Headless Puppeteer sont un bon moyen de comparer les versions. Ils ne représentent pas le temps comme expérimenté par les utilisateurs. Lorsque nous exécutons les mêmes 10K modules dans une fenêtre Incognito de Chrome, nous avons: | 10K Modules | Vite 5.0 | Vite 5.1 | | --------------------- | :------: | :------: | -| Loading time | 2892ms | 2765ms | -| Loading time (cached) | 2778ms | 2477ms | -| Full reload | 2003ms | 1878ms | -| Full reload (cached) | 1682ms | 1604ms | +| Temps de chargement | 2892ms | 2765ms | +| Temps de chargement (cache) | 2778ms | 2477ms | +| Rechargement complet | 2003ms | 1878ms | +| Rechargement complet (cache) | 1682ms | 1604ms | -### Run CSS preprocessors in threads +### Exécution des préprocesseurs CSS dans des threads -Vite now has opt-in support for running CSS preprocessors in threads. You can enable it using [`css.preprocessorMaxWorkers: true`](/config/shared-options.html#css-preprocessormaxworkers). For a Vuetify 2 project, dev startup time was reduced by 40% with this feature enabled. There is [performance comparison for others setups in the PR](https://github.com/vitejs/vite/pull/13584#issuecomment-1678827918). See ([#13584](https://github.com/vitejs/vite/issues/13584)). [Give Feedback](https://github.com/vitejs/vite/discussions/15835). +Vite a maintenant un support natif pour exécuter des préprocesseurs CSS dans des threads. Vous pouvez l'activer en utilisant [`css.preprocessorMaxWorkers: true`](/config/shared-options.html#css-preprocessormaxworkers). Pour un projet Vuetify 2, le temps de démarrage du dev a été réduit de 40% avec cette fonctionnalité activée. Il y a un [comparatif des performances pour d'autres configurations dans la PR](https://github.com/vitejs/vite/pull/13584#issuecomment-1678827918). Voir ([#13584](https://github.com/vitejs/vite/issues/13584)). [Faire un retour](https://github.com/vitejs/vite/discussions/15835). -### New options to improve server cold starts +### Nouvelles options pour améliorer les démarrages de serveur froids -You can set `optimizeDeps.holdUntilCrawlEnd: false` to switch to a new strategy for deps optimization that may help in big projects. We're considering switching to this strategy by default in the future. [Give Feedback](https://github.com/vitejs/vite/discussions/15834). ([#15244](https://github.com/vitejs/vite/issues/15244)) +Vous pouvez définir `optimizeDeps.holdUntilCrawlEnd: false` pour basculer vers une nouvelle stratégie pour l'optimisation des dépendances qui peut aider dans les gros projets. Nous envisageons de basculer vers cette stratégie par défaut dans le futur. [Faire un retour](https://github.com/vitejs/vite/discussions/15834). ([#15244](https://github.com/vitejs/vite/issues/15244)) -### Faster resolving with cached checks +### Résolution plus rapide avec les vérifications mises en cache -The `fs.cachedChecks` optimization is now enabled by default. In Windows, `tryFsResolve` was ~14x faster with it, and resolving ids overall got a ~5x speed up in the triangle benchmark. ([#15704](https://github.com/vitejs/vite/issues/15704)) +L'optimisation `fs.cachedChecks` est maintenant activée par défaut. Dans Windows, `tryFsResolve` était ~14x plus rapide avec elle, et la résolution des ids a obtenu un gain de ~5x dans le benchmark triangle. ([#15704](https://github.com/vitejs/vite/issues/15704)) -### Internal performance improvements +### Améliorations de performance internes -The dev server had several incremental performance gains. A new middleware to short-circuit on 304 ([#15586](https://github.com/vitejs/vite/issues/15586)). We avoided `parseRequest` in hot paths ([#15617](https://github.com/vitejs/vite/issues/15617)). Rollup is now properly lazy loaded ([#15621](https://github.com/vitejs/vite/issues/15621)) +Le serveur de développement a eu plusieurs gains de performance incrémentiels. Un nouveau middleware pour court-circuiter sur 304 ([#15586](https://github.com/vitejs/vite/issues/15586)). Nous avons évité `parseRequest` dans les hot paths ([#15617](https://github.com/vitejs/vite/issues/15617)). Rollup est maintenant correctement lazy loadé ([#15621](https://github.com/vitejs/vite/issues/15621)) -## Deprecations +## Dépréciations -We continue to reduce Vite's API surface where possible to make the project maintainable long term. +Nous continuons à réduire la surface d'API de Vite tant que possible pour rendre le projet maintenable à long terme. -### Deprecated `as` option in `import.meta.glob` +### Déprécié `as` option dans `import.meta.glob` -The standard moved to [Import Attributes](https://github.com/tc39/proposal-import-attributes), but we don't plan to replace `as` with a new option at this point. Instead, it is recommended that the user switches to `query`. See ([#14420](https://github.com/vitejs/vite/issues/14420)). +Le standard a migré vers [Import Attributes](https://github.com/tc39/proposal-import-attributes), mais nous n'envisageons pas de remplacer `as` avec une nouvelle option à ce stade. Au lieu de cela, il est recommandé que l'utilisateur bascule vers `query`. Voir ([#14420](https://github.com/vitejs/vite/issues/14420)). -### Removed experimental build-time pre-bundling +### Suppression du pré-bundling de build-time -Build-time pre-bundling, an experimental feature added in Vite 3, is removed. With Rollup 4 switching its parser to native, and Rolldown being worked on, both the performance and the dev-vs-build inconsistency story for this feature are no longer valid. We want to continue improving dev/build consistency, and have concluded that using Rolldown for "prebundling during dev" and "production builds" is the better bet moving forward. Rolldown may also implement caching in a way that is a lot more efficient during build than deps prebundling. See ([#15184](https://github.com/vitejs/vite/issues/15184)). +Build-time pre-bundling, une fonctionnalité expérimentale ajoutée dans Vite 3, est supprimée. Avec Rollup 4 qui bascule son analyseur vers natif, et Rollup qui est en cours de développement, les histoires de performance et de consistance entre le développement et la construction pour cette fonctionnalité ne sont plus valides. Nous voulons continuer à améliorer la consistance entre le développement et la construction, et avons conclu que l'utilisation de Rollup pour "pré-bundling pendant le développement" et "constructions de production" est la meilleure option pour l'avenir. Rollup peut également implémenter le caching de manière beaucoup plus efficace pendant la construction que le pré-bundling des dépendances. Voir ([#15184](https://github.com/vitejs/vite/issues/15184)). -## Get Involved +## Participer -We are grateful to the [900 contributors to Vite Core](https://github.com/vitejs/vite/graphs/contributors), and the maintainers of plugins, integrations, tools, and translations that keeps pushing the ecosystem forward. If you're enjoying Vite, we invite you to participate and help us. Check out our [Contributing Guide](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md), and jump into [triaging issues](https://github.com/vitejs/vite/issues), [reviewing PRs](https://github.com/vitejs/vite/pulls), answering questions at [GitHub Discussions](https://github.com/vitejs/vite/discussions) and helping others in the community in [Vite Land](https://chat.vite.dev). +Nous sommes reconnaissants aux [900 contributeurs à Vite Core](https://github.com/vitejs/vite/graphs/contributors), et aux mainteneurs de plugins, intégrations, outils, et traductions qui poussent l'écosystème vers l'avant. Si vous appréciez Vite, nous vous invitons à participer et nous aider. Consultez notre [Guide de contribution](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md), et jetez-vous dans [tri des tickets](https://github.com/vitejs/vite/issues), [revues de PRs](https://github.com/vitejs/vite/pulls), répondre aux questions sur [GitHub Discussions](https://github.com/vitejs/vite/discussions) et aider les autres dans la communauté dans [Vite Land](https://chat.vite.dev). -## Acknowledgments +## Remerciements -Vite 5.1 is possible thanks to our community of contributors, maintainers in the ecosystem, and the [Vite Team](/team). A shout out to the individuals and companies sponsoring Vite development. [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), and [Astro](https://astro.build) for hiring Vite team members. And also to the sponsors on [Vite's GitHub Sponsors](https://github.com/sponsors/vitejs), [Vite's Open Collective](https://opencollective.com/vite), and [Evan You's GitHub Sponsors](https://github.com/sponsors/yyx990803). +Vite 5.1 est possible grâce à notre communauté de contributeurs, mainteneurs dans l'écosystème, et l'équipe [Vite](/team). Un remerciement tout particulieraux individus et entreprises qui soutiennent le développement de Vite. [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), et [Astro](https://astro.build) ont embauché des membres de l'équipe Vite. Et aussi aux sponsors sur [GitHub Sponsors de Vite](https://github.com/sponsors/vitejs), [Open Collective de Vite](https://opencollective.com/vite), et [GitHub Sponsors d'Evan You](https://github.com/sponsors/yyx990803). diff --git a/docs/blog/announcing-vite5.md b/docs/blog/announcing-vite5.md index 0634638..f3bfae4 100644 --- a/docs/blog/announcing-vite5.md +++ b/docs/blog/announcing-vite5.md @@ -1,7 +1,7 @@ --- -title: Vite 5.0 is out! +title: Vite 5.0 est sorti ! author: - name: The Vite Team + name: L'équipe Vite date: 2023-11-16 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 5 + content: Annonce de Vite 5 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite5.png @@ -19,32 +19,32 @@ head: content: https://vite.dev/blog/announcing-vite5 - - meta - property: og:description - content: Vite 5 Release Announcement + content: Annonce de la sortie de Vite 5 - - meta - name: twitter:card content: summary_large_image --- -# Vite 5.0 is out! +# Vite 5.0 est sorti ! -_November 16, 2023_ +_16 novembre 2023_ -![Vite 5 Announcement Cover Image](/og-image-announcing-vite5.png) +![Image de couverture de l'annonce de Vite 5](/og-image-announcing-vite5.png) -Vite 4 [was released](./announcing-vite4.md) almost a year ago, and it served as a solid base for the ecosystem. npm downloads per week jumped from 2.5 million to 7.5 million, as projects keep building on a shared infrastructure. Frameworks continued to innovate, and on top of [Astro](https://astro.build/), [Nuxt](https://nuxt.com/), [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/), between others, we saw new frameworks joining and making the ecosystem stronger. [RedwoodJS](https://redwoodjs.com/) and [Remix](https://remix.run/) switching to Vite paves the way for further adoption in the React ecosystem. [Vitest](https://vitest.dev) kept growing at an even faster pace than Vite. Its team has been hard at work and will soon [release Vitest 1.0](https://github.com/vitest-dev/vitest/issues/3596). The story of Vite when used with other tools such as [Storybook](https://storybook.js.org), [Nx](https://nx.dev), and [Playwright](https://playwright.dev) kept improving, and the same goes for environments, with Vite dev working both in [Deno](https://deno.com) and [Bun](https://bun.sh). +Vite 4 [a été publié](./announcing-vite4.md) il y a un peu plus d'un an, et il a servi de base solide pour l'écosystème. Les téléchargements npm par semaine sont passés de 2,5 millions à 7,5 millions, car les projets continuent à construire sur une infrastructure partagée. Les frameworks ont continué à innover, et sur [Astro](https://astro.build/), [Nuxt](https://nuxt.com/), [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/), entre autres, nous avons vu de nouveaux frameworks rejoindre et renforcer l'écosystème. [RedwoodJS](https://redwoodjs.com/) et [Remix](https://remix.run/) ont changé pour utiliser Vite, ce qui ouvre la voie à une adoption plus large dans l'écosystème React. [Vitest](https://vitest.dev) a continué à grandir à un rythme encore plus rapide que Vite. Son équipe a travaillé dur et [prévoit publier Vitest 1.0](https://github.com/vitest-dev/vitest/issues/3596) dans les semaines à venir. Le récit de Vite lorsqu'il est utilisé avec d'autres outils tels que [Storybook](https://storybook.js.org), [Nx](https://nx.dev), et [Playwright](https://playwright.dev) a continué à s'améliorer, et le même principe s'applique aux environnements, avec Vite dev fonctionnant dans [Deno](https://deno.com) et [Bun](https://bun.sh). -We had the second edition of [ViteConf](https://viteconf.org/23/replay) a month ago, hosted by [StackBlitz](https://stackblitz.com). Like last year, most of the projects in the ecosystem got together to share ideas and connect to keep expanding the commons. We're also seeing new pieces complement the meta-framework tool belt like [Volar](https://volarjs.dev/) and [Nitro](https://nitro.unjs.io/). The Rollup team released [Rollup 4](https://rollupjs.org) that same day, a tradition Lukas started last year. +Nous avons eu la deuxième édition de [ViteConf](https://viteconf.org/23/replay) il y a un mois, hébergée par [StackBlitz](https://stackblitz.com). Comme l'an passé, la plupart des projets de l'écosystème se sont réunis pour partager des idées et se connecter pour maintenir et étendre les ressources communes. Nous voyons également de nouvelles pièces complémentaires pour renforcer l'offre de l'outil de framework comme [Volar](https://volarjs.dev/) et [Nitro](https://nitro.unjs.io/). L'équipe Rollup a publié [Rollup 4](https://rollupjs.org) le même jour, une tradition commencée par Lukas l'an passé. -Six months ago, Vite 4.3 [was released](./announcing-vite4.md). This release significantly improved the dev server performance. However, there is still ample room for improvement. At ViteConf, [Evan You unveiled Vite's long-term plan to work on Rolldown](https://www.youtube.com/watch?v=hrdwQHoAp0M), a Rust-port of Rollup with compatible APIs. Once it is ready, we intend to use it in Vite Core to take on the tasks of both Rollup and esbuild. This will mean a boost in build performance (and later on in dev performance too as we move perf-sensitive parts of Vite itself to Rust), and a big reduction of inconsistencies between dev and build. Rolldown is currently in early stages and the team is preparing to open source the codebase before the end of the year. Stay tuned! +Six mois après, Vite 4.3 [a été publié](./announcing-vite4.md). Cette version a significativement amélioré les performances du serveur de développement. Cependant, il existe encore un grand espace pour l'amélioration. À la ViteConf, [Evan You a présenté le plan de long terme de Vite pour travailler sur Rolldown](https://www.youtube.com/watch?v=hrdwQHoAp0M), une version Rust de Rollup avec des API compatibles. Une fois prêt, nous prévoyons l'utiliser dans le noyau de Vite pour prendre en charge les tâches de Rollup et esbuild. Cela signifiera un boost dans les performances de build (et plus tard dans les performances de développement, car nous déplacerons les parties sensibles aux performances de Vite vers Rust), et une grande réduction des incohérences entre le développement et la construction. Rolldown est actuellement dans les premières étapes et l'équipe prépare le code source à la fin de l'année. Restez connecté ! -Today, we mark another big milestone in Vite's path. The Vite [team](/team), [contributors](https://github.com/vitejs/vite/graphs/contributors), and ecosystem partners, are excited to announce the release of Vite 5. Vite is now using [Rollup 4](https://github.com/vitejs/vite/pull/14508), which already represents a big boost in build performance. And there are also new options to improve your dev server performance profile. +Aujourd'hui, nous marquons un autre grand point d'étape dans l'évolution de Vite. L'équipe [Vite](/team), les [contributeurs](https://github.com/vitejs/vite/graphs/contributors), et partenaires de l'écosystème, sont heureux de vous annoncer la sortie de Vite 5. Vite utilise maintenant [Rollup 4](https://github.com/vitejs/vite/pull/14508), ce qui représente un grand boost dans les performances de build. Et il y a également de nouvelles options pour améliorer le profil de performance de votre serveur de développement. -Vite 5 focuses on cleaning up the API (removing deprecated features) and streamlines several features closing long-standing issues, for example switching `define` to use proper AST replacements instead of regexes. We also continue to take steps to future-proof Vite (Node.js 18+ is now required, and [the CJS Node API has been deprecated](/guide/migration#deprecate-cjs-node-api)). +Vite 5 se concentre sur le nettoyage de l'API (suppression des fonctionnalités dépréciées) et simplifie plusieurs fonctionnalités en résolvant des problèmes longuement ouverts, par exemple en changeant `define` pour utiliser des remplacements AST appropriés plutôt que des regexes. Nous continuons également à prendre des mesures pour assurer la compatibilité future de Vite (Node.js 18+ est maintenant requis, et [l'API Node CJS a été dépréciée](/guide/migration#deprecate-cjs-node-api)). Quick links: - [Docs](/) -- [Migration Guide](/guide/migration) +- [Guide de migration](/guide/migration) - [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#500-2023-11-16) Docs in other languages: @@ -54,57 +54,57 @@ Docs in other languages: - [Español](https://es.vite.dev/) - [Português](https://pt.vite.dev/) - [한국어](https://ko.vite.dev/) -- [Deutsch](https://de.vite.dev/) (new translation!) +- [Deutsch](https://de.vite.dev/) (nouvelle traduction!) -If you're new to Vite, we suggest reading first the [Getting Started](/guide/) and [Features](/guide/features) guides. +Si vous êtes nouveau sur Vite, nous vous suggérons de lire d'abord le guide [Débuter](/guide/) et celui des [Fonctionnalités](/guide/features). -We appreciate the more than [850 contributors to Vite Core](https://github.com/vitejs/vite/graphs/contributors), and the maintainers and contributors of Vite plugins, integrations, tools, and translations that have helped us reach here. We encourage you to get involved and continue to improve Vite with us. You can learn more at our [Contributing Guide](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md). To get started, we recommend [triaging issues](https://github.com/vitejs/vite/issues), [reviewing PRs](https://github.com/vitejs/vite/pulls), sending failing tests PRs based on open issues, and helping others in [Discussions](https://github.com/vitejs/vite/discussions) and Vite Land's [help forum](https://discord.com/channels/804011606160703521/1019670660856942652). You'll learn a lot along the way and have a smooth path to further contributions to the project. If you have doubts, join us on our [Discord community](http://chat.vite.dev/) and say hi on the [#contributing channel](https://discord.com/channels/804011606160703521/804439875226173480). +Nous sommes reconnaissants aux plus de [850 contributeurs à Vite Core](https://github.com/vitejs/vite/graphs/contributors), et aux mainteneurs et contributeurs de plugins, intégrations, outils, et traductions qui nous ont permis d'arriver ici. Nous vous encourageons à participer et à continuer à améliorer Vite avec nous. Vous pouvez en savoir plus sur notre [Guide de contribution](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md). Pour commencer, nous vous suggérons de [trier les tickets](https://github.com/vitejs/vite/issues), de [revoir les PR](https://github.com/vitejs/vite/pulls), d'envoyer des PR de tests en échec basés sur les tickets ouverts, et d'aider les autres dans [Discussions](https://github.com/vitejs/vite/discussions) et le [forum d'aide de Vite Land](https://discord.com/channels/804011606160703521/1019670660856942652). Vous apprendrez beaucoup de choses et aurez un chemin facile pour contribuer au projet. Si vous avez des doutes, rejoignez notre [communauté Discord](http://chat.vite.dev/) et dites-nous bonjour sur le canal [#contributing](https://discord.com/channels/804011606160703521/804439875226173480). -To stay up to date, follow us on [X](https://twitter.com/vite_js) or [Mastodon](https://webtoo.ls/@vite). +Pour rester à jour, suivez-nous sur [X](https://twitter.com/vite_js) ou [Mastodon](https://webtoo.ls/@vite). -## Quick start with Vite 5 +## Démarrer avec Vite 5 -Use `pnpm create vite` to scaffold a Vite project with your preferred framework, or open a started template online to play with Vite 5 using [vite.new](https://vite.new). You can also run `pnpm create vite-extra` to get access to templates from other frameworks and runtimes (Solid, Deno, SSR, and library starters). `create vite-extra` templates are also available when you run `create vite` under the `Others` option. +Utilisez `pnpm create vite` pour créer un projet Vite avec votre framework préféré, ou ouvrez un template commencé en ligne de commande pour jouer avec Vite 5 en utilisant [vite.new](https://vite.new). Vous pouvez également exécuter `pnpm create vite-extra` pour accéder aux templates de d'autres frameworks et runtimes (Solid, Deno, SSR, et starters de bibliothèques). Les templates `create vite-extra` sont également disponibles lorsque vous exécutez `create vite` sous l'option `Others`. -Note that Vite starter templates are intended to be used as a playground to test Vite with different frameworks. When building your next project, we recommend reaching out to the starters recommended by each framework. Some frameworks now redirect in `create vite` to their starters too (`create-vue` and `Nuxt 3` for Vue, and `SvelteKit` for Svelte). +Notez que les templates de démarrage de Vite sont conçus pour être utilisés comme un terrain de jeu pour tester Vite avec différents frameworks. Lorsque vous construisez votre prochain projet, nous vous recommandons de vous tourner vers les starters recommandés par chaque framework. Certains frameworks redirigent maintenant dans `create vite` vers leurs starters (`create-vue` et `Nuxt 3` pour Vue, et `SvelteKit` pour Svelte). -## Node.js Support +## Support de Node.js -Vite no longer supports Node.js 14 / 16 / 17 / 19, which reached its EOL. Node.js 18 / 20+ is now required. +Vite ne supporte plus Node.js 14 / 16 / 17 / 19, qui a atteint sa date de fin de vie. Node.js 18 / 20+ est maintenant requis. -## Performance +## Performances -On top of Rollup 4's build performance improvements, there is a new guide to help you identify and fix common performance issues at [https://vite.dev/guide/performance](/guide/performance). +En plus des améliorations des performances de build de Rollup 4, il existe un guide pour vous aider à identifier et résoudre les problèmes de performances communs à [https://vite.dev/guide/performance](/guide/performance). -Vite 5 also introduces [server.warmup](/guide/performance.html#warm-up-frequently-used-files), a new feature to improve startup time. It lets you define a list of modules that should be pre-transformed as soon as the server starts. When using [`--open` or `server.open`](/config/server-options.html#server-open), Vite will also automatically warm up the entry point of your app or the provided URL to open. +Vite 5 introduit [server.warmup](/guide/performance.html#warm-up-frequently-used-files), une nouvelle fonctionnalité pour améliorer le temps de démarrage. Il vous permet de définir une liste de modules qui devraient être prétransformés dès que le serveur démarre. Lorsque vous utilisez [`--open` ou `server.open`](/config/server-options.html#server-open), Vite démarrera également automatiquement le point d'entrée de votre application ou l'URL fournie pour l'ouvrir. -## Main Changes +## Changements majeurs -- [Vite is now powered by Rollup 4](/guide/migration#rollup-4) -- [The CJS Node API has been deprecated](/guide/migration#deprecate-cjs-node-api) -- [Rework `define` and `import.meta.env.*` replacement strategy](/guide/migration#rework-define-and-import-meta-env-replacement-strategy) -- [SSR externalized modules value now matches production](/guide/migration#ssr-externalized-modules-value-now-matches-production) -- [`worker.plugins` is now a function](/guide/migration#worker-plugins-is-now-a-function) -- [Allow path containing `.` to fallback to index.html](/guide/migration#allow-path-containing-to-fallback-to-index-html) -- [Align dev and preview HTML serving behavior](/guide/migration#align-dev-and-preview-html-serving-behaviour) -- [Manifest files are now generated in `.vite` directory by default](/guide/migration#manifest-files-are-now-generated-in-vite-directory-by-default) -- [CLI shortcuts require an additional `Enter` press](/guide/migration#cli-shortcuts-require-an-additional-enter-press) -- [Update `experimentalDecorators` and `useDefineForClassFields` TypeScript behavior](/guide/migration#update-experimentaldecorators-and-usedefineforclassfields-typescript-behaviour) -- [Remove `--https` flag and `https: true`](/guide/migration#remove-https-flag-and-https-true) -- [Remove `resolvePackageEntry` and `resolvePackageData` APIs](/guide/migration#remove-resolvepackageentry-and-resolvepackagedata-apis) -- [Removes previously deprecated APIs](/guide/migration#removed-deprecated-apis) -- [Read more about advanced changes affecting plugin and tool authors](/guide/migration#advanced) +- [Vite est maintenant alimenté par Rollup 4](/guide/migration#rollup-4) +- [L'API Node CJS a été dépréciée](/guide/migration#deprecate-cjs-node-api) +- [Réécriture de `define` et de la stratégie de remplacement de `import.meta.env.*`](/guide/migration#rework-define-and-import-meta-env-replacement-strategy) +- [La valeur des modules externes SSR correspond maintenant à la production](/guide/migration#ssr-externalized-modules-value-now-matches-production) +- [`worker.plugins` est maintenant une fonction](/guide/migration#worker-plugins-is-now-a-function) +- [Autoriser les chemins contenant `.` à tomber sur index.html](/guide/migration#allow-path-containing-to-fallback-to-index-html) +- [Allignement du comportement de serveur de développement et de prévisualisation HTML](/guide/migration#align-dev-and-preview-html-serving-behaviour) +- [Les fichiers manifestes sont maintenant générés dans le répertoire `.vite` par défaut](/guide/migration#manifest-files-are-now-generated-in-vite-directory-by-default) +- [Les raccourcis CLI nécessitent une pression supplémentaire sur `Enter`](/guide/migration#cli-shortcuts-require-an-additional-enter-press) +- [Mise à jour le comportement de `experimentalDecorators` et `useDefineForClassFields` TypeScript](/guide/migration#update-experimentaldecorators-and-usedefineforclassfields-typescript-behaviour) +- [Suppression du drapeau `--https` et `https: true`](/guide/migration#remove-https-flag-and-https-true) +- [Suppression des APIs `resolvePackageEntry` et `resolvePackageData`](/guide/migration#remove-resolvepackageentry-and-resolvepackagedata-apis) +- [Suppression des APIs dépréciées](/guide/migration#removed-deprecated-apis) +- [Lire plus sur les changements avancés affectant les auteurs de plugins et d'outils](/guide/migration#advanced) -## Migrating to Vite 5 +## Migration vers Vite 5 -We have worked with ecosystem partners to ensure a smooth migration to this new major. Once again, [vite-ecosystem-ci](https://www.youtube.com/watch?v=7L4I4lDzO48) has been crucial to help us make bolder changes while avoiding regressions. We're thrilled to see other ecosystems adopt similar schemes to improve the collaboration between their projects and downstream maintainers. +Nous avons travaillé avec nos partenaires de l'écosystème pour garantir une migration fluide vers cette nouvelle version majeure. Une fois de plus, [vite-ecosystem-ci](https://www.youtube.com/watch?v=7L4I4lDzO48) a été crucial pour nous aider à apporter des changements plus audacieux tout en évitant les régressions. Nous sommes ravis de voir d'autres écosystèmes adopter des schémas similaires pour améliorer la collaboration entre leurs projets et les mainteneurs downstream. -For most projects, the update to Vite 5 should be straight forward. But we advise reviewing the [detailed Migration Guide](/guide/migration) before upgrading. +Pour la plupart des projets, la mise à jour vers Vite 5 devrait être directe. Mais nous vous conseillons de revoir le [guide de migration détaillé](/guide/migration) avant de mettre à jour. -A low level breakdown with the full list of changes to Vite core can be found at the [Vite 5 Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#500-2023-11-16). +Un résumé au niveau basique avec la liste complète des changements pour le noyau de Vite peut être trouvé dans le [changelog de Vite 5](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#500-2023-11-16). -## Acknowledgments +## Remerciements -Vite 5 is the result of long hours of work by our community of contributors, downstream maintainers, plugins authors, and the [Vite Team](/team). A big shout out to [Bjorn Lu](https://twitter.com/bluwyoo) for leading the release process for this major. +Vite 5 est le résultat de longues heures de travail par notre communauté de contributeurs, mainteneurs, auteurs de plugins, et l'équipe [Vite](/team). Un grand coup de main à [Bjorn Lu](https://twitter.com/bluwyoo) pour mener le processus de release pour cette version majeure. -We're also thankful to individuals and companies sponsoring Vite development. [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), and [Astro](https://astro.build) continue to invest in Vite by hiring Vite team members. A shout out to sponsors on [Vite's GitHub Sponsors](https://github.com/sponsors/vitejs), [Vite's Open Collective](https://opencollective.com/vite), and [Evan You's GitHub Sponsors](https://github.com/sponsors/yyx990803). A special mention to [Remix](https://remix.run/) for becoming a Gold sponsor and contributing back after switching to Vite. +Nous sommes également reconnaissants aux individus et entreprises qui soutiennent le développement de Vite. [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), et [Astro](https://astro.build) continuent à investir dans Vite en recrutant des membres de l'équipe Vite. Un grand coup de main aux sponsors sur [GitHub Sponsors de Vite](https://github.com/sponsors/vitejs), [Open Collective de Vite](https://opencollective.com/vite), et [GitHub Sponsors d'Evan You](https://github.com/sponsors/yyx990803). Un grand merci à [Remix](https://remix.run/) pour devenir un sponsor or et contribuer aux retours après avoir changé pour utiliser Vite. diff --git a/docs/blog/announcing-vite6.md b/docs/blog/announcing-vite6.md index 8984bbe..7170068 100644 --- a/docs/blog/announcing-vite6.md +++ b/docs/blog/announcing-vite6.md @@ -1,7 +1,7 @@ --- -title: Vite 6.0 is out! +title: Vite 6.0 est sorti ! author: - name: The Vite Team + name: L'équipe Vite date: 2024-11-26 sidebar: false head: @@ -10,7 +10,7 @@ head: content: website - - meta - property: og:title - content: Announcing Vite 6 + content: Annonce de Vite 6 - - meta - property: og:image content: https://vite.dev/og-image-announcing-vite6.png @@ -19,97 +19,97 @@ head: content: https://vite.dev/blog/announcing-vite6 - - meta - property: og:description - content: Vite 6 Release Announcement + content: Annonce de la sortie de Vite 6 - - meta - name: twitter:card content: summary_large_image --- -# Vite 6.0 is out! +# Vite 6.0 est sorti ! -_November 26, 2024_ +_26 novembre 2024_ -![Vite 6 Announcement Cover Image](/og-image-announcing-vite6.png) +![Image de couverture de l'annonce de Vite 6](/og-image-announcing-vite6.png) -Today, we're taking another big step in Vite's story. The Vite [team](/team), [contributors](https://github.com/vitejs/vite/graphs/contributors), and ecosystem partners are excited to announce the release of Vite 6. +Aujourd'hui, il s'agit d'un autre grand pas dans l'histoire de Vite. L'équipe [Vite](/team), les contributeurs et les partenaires de l'écosystème sont enthousiasmés d'annoncer la sortie de Vite 6. -It has been an eventful year. Vite adoption keeps growing, with npm downloads per week jumping from 7.5 million to 17 million since the release of Vite 5 a year ago. [Vitest](https://vitest.dev) is not only being favored more by users but is also starting to form an ecosystem of its own. For example, [Storybook](https://storybook.js.org) has new testing capabilities powered by Vitest. +Cette année a été pleine d'événements. L'adoption de Vite continue de croître, avec des téléchargements npm par semaine passant de 7,5 millions à 17 millions depuis la sortie de Vite 5 il y a un an. [Vitest](https://vitest.dev) n'est plus seulement privilégiée par les utilisateurs, mais commence également à former un écosystème propre. Par exemple, [Storybook](https://storybook.js.org) a de nouvelles capacités de test pilotées par Vitest. -New frameworks have also joined the Vite ecosystem, including [TanStack Start](https://tanstack.com/start), [One](https://onestack.dev/), [Ember](https://emberjs.com/), and others. Web frameworks are innovating at an increasingly faster pace. You can check out the improvements folks have been doing at [Astro](https://astro.build/), [Nuxt](https://nuxt.com/), [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/), [RedwoodJS](https://redwoodjs.com/), [React Router](https://reactrouter.com/), and the list goes on. +De nouveaux frameworks ont également rejoint l'écosystème Vite, y compris [TanStack Start](https://tanstack.com/start), [One](https://onestack.dev/), [Ember](https://emberjs.com/), et d'autres. Les frameworks web innovent de plus en plus rapidement. Vous pouvez consulter les améliorations que les gens ont faites à [Astro](https://astro.build/), [Nuxt](https://nuxt.com/), [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/), [RedwoodJS](https://redwoodjs.com/), [React Router](https://reactrouter.com/), et la liste continue. -Vite is used by OpenAI, Google, Apple, Microsoft, NASA, Shopify, Cloudflare, GitLab, Reddit, Linear, among many others. Two months ago, we started a list of [companies using Vite](https://github.com/vitejs/companies-using-vite). We're happy to see many developers sending us a PR to add their companies to the list. It's hard to believe how much the ecosystem we built together has grown since Vite gave its first steps. +Vite est utilisé par OpenAI, Google, Apple, Microsoft, NASA, Shopify, Cloudflare, GitLab, Reddit, Linear, et bien d'autres encore. Deux mois plus tard, nous avons commencé une liste d'[entreprises utilisant Vite](https://github.com/vitejs/companies-using-vite). Nous sommes heureux de voir beaucoup de développeurs nous envoyer une PR pour ajouter leurs entreprises à la liste. Il est difficile de croire à la quantité d'écosystème que nous avons construit ensemble depuis que Vite a pris ses premières étapes. -![Vite weekly npm downloads](/vite6-npm-weekly-downloads.png) +![Téléchargements npm par semaine de Vite](/vite6-npm-weekly-downloads.png) -## Speeding up the Vite ecosystem +## Accélérer l'écosystème de Vite -Last month, the community gathered for the third edition of [ViteConf](https://viteconf.org/24/replay), hosted once more by [StackBlitz](https://stackblitz.com). It was the biggest Vite conference, with a broad representation of builders from the ecosystem. Among other announcements, Evan You announced [VoidZero](https://staging.voidzero.dev/posts/announcing-voidzero-inc), a company dedicated to building an open-source, high-performance, and unified development toolchain for the JavaScript ecosystem. VoidZero is behind [Rolldown](https://rolldown.rs) and [Oxc](https://oxc.rs), and their team is making significant strides, getting them rapidly ready for being adopted by Vite. Watch Evan's keynote to learn more about the next steps for Vite's rust-powered future. +Le mois dernier, la communauté s'est réunie pour la troisième édition de la [ViteConf](https://viteconf.org/24/replay), hébergée une fois de plus par [StackBlitz](https://stackblitz.com). C'était la plus grande conférence Vite, avec une représentation étendue de constructeurs de l'écosystème. Parmi les autres annonces, Evan You a annoncé [VoidZero](https://staging.voidzero.dev/posts/announcing-voidzero-inc), une entreprise dédiée à la construction d'un outil de chaîne de développement open-source, haue-performance et unifié pour l'écosystème JavaScript. VoidZero est derrière [Rolldown](https://rolldown.rs) et [Oxc](https://oxc.rs), et leur équipe fait des progrès significatifs, les préparant rapidement pour être adoptés par Vite. Regardez la keynote d'Evan pour en savoir plus sur les étapes suivantes pour le futur de Vite, piloté par le rust. -[Stackblitz](https://stackblitz.com) unveiled [bolt.new](https://bolt.new), a Remix app that combines Claude and WebContainers and lets you prompt, edit, run, and deploy full-stack apps. Nate Weiner announced [One](https://onestack.dev/), a new Vite-powered React framework for web and native. Storybook showcased their latest Vitest-powered [testing features](https://youtu.be/8t5wxrFpCQY?si=PYZoWKf-45goQYDt). And so much more. We encourage you to watch [all 43 talks](https://www.youtube.com/playlist?list=PLqGQbXn_GDmnObDzgjUF4Krsfl6OUKxtp). The speakers made a significant effort to share with us what each project has been up to. +[Stackblitz](https://stackblitz.com) a révélé [bolt.new](https://bolt.new), une application Remix qui combine Claude et WebContainers et vous permet de prompt, modifier, exécuter et déployer des applications full-stack. Nate Weiner a annoncé [One](https://onestack.dev/), un nouveau framework React Vite pour le web et natif. Storybook a présenté leurs dernières fonctionnalités de test pilotées par Vitest [testing features](https://youtu.be/8t5wxrFpCQY?si=PYZoWKf-45goQYDt). Et bien plus encore. Nous vous encourageons à regarder [les 43 conférences](https://www.youtube.com/playlist?list=PLqGQbXn_GDmnObDzgjUF4Krsfl6OUKxtp). Les conférenciers ont fait un effort significatif pour nous partager ce que chaque projet etait en train de faire. -Vite also got a refreshed landing page and a clean domain. You should update your URLs to point to the new [vite.dev](https://vite.dev) domain moving forward. The new design and implementation was done by VoidZero, by the same folks that made their website. Shoutout to [Vicente Rodriguez](https://bento.me/rmoon) and [Simon Le Marchant](https://marchantweb.com/). +Vite a également mis à jour sa page d'accueil et cleané son domaine. Vous devriez mettre à jour vos URL pour pointer vers le nouveau domaine [vite.dev](https://vite.dev). Le nouveau design et l'implémentation a été fait par VoidZero, par les mêmes personnes qui ont fait leur site web. Remerciement spéciaux à [Vicente Rodriguez](https://bento.me/rmoon) et [Simon Le Marchant](https://marchantweb.com/). -## The next Vite major is here +## La prochaine version majeure de Vite est arrivée -Vite 6 is the most significant major release since Vite 2. We're eager to partner with the ecosystem to keep expanding our shared commons through new APIs and, as usual, a more polished base upon which to build. +Vite 6 est la plus importante version majeure depuis Vite 2. Nous sommes impatients de collaborer avec l'écosystème pour maintenir et étendre nos assets partagés via de nouvelles APIs, et comme d'habitude, une base plus claire sur laquelle construire. -Quick links: +Liens rapides : - [Docs](/) -- Translations: [简体中文](https://cn.vite.dev/), [日本語](https://ja.vite.dev/), [Español](https://es.vite.dev/), [Português](https://pt.vite.dev/), [한국어](https://ko.vite.dev/), [Deutsch](https://de.vite.dev/) -- [Migration Guide](/guide/migration) +- Traductions: [简体中文](https://cn.vite.dev/), [日本語](https://ja.vite.dev/), [Español](https://es.vite.dev/), [Português](https://pt.vite.dev/), [한국어](https://ko.vite.dev/), [Deutsch](https://de.vite.dev/) +- [Guide de migration](/guide/migration) - [GitHub Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#600-2024-11-26) -If you're new to Vite, we suggest reading the [Getting Started](/guide/) and [Features](/guide/features) guides first. +Si vous êtes nouveau sur Vite, nous vous suggérons de lire d'abord les guides [Débuter](/guide/) et [Fonctionnalités](/guide/features). -We want to thank the more than [1K contributors to Vite Core](https://github.com/vitejs/vite/graphs/contributors) and the maintainers and contributors of Vite plugins, integrations, tools, and translations that have helped us craft this new major. We invite you to get involved and help us improve Vite for the whole ecosystem. Learn more at our [Contributing Guide](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md). +Nous voulons remercier les plus de [1 000 contributeurs à Vite Core](https://github.com/vitejs/vite/graphs/contributors) et les mainteneurs et contributeurs de plugins, intégrations, outils, et traductions qui ont aidé à créer cette nouvelle version majeure. Nous vous invitons à participer et à nous aider à améliorer Vite pour l'écosystème entier. En savoir plus sur notre [Guide de contribution](https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md). -To get started, we suggest helping [triage issues](https://github.com/vitejs/vite/issues), [review PRs](https://github.com/vitejs/vite/pulls), send failing tests PRs based on open issues, and support others in [Discussions](https://github.com/vitejs/vite/discussions) and Vite Land's [help forum](https://discord.com/channels/804011606160703521/1019670660856942652). If you'd like to talk to us, join our [Discord community](http://chat.vite.dev/) and say hi on the [#contributing channel](https://discord.com/channels/804011606160703521/804439875226173480). +Pour commencer, nous vous suggérons de [trier les tickets](https://github.com/vitejs/vite/issues), de [revoir les PR](https://github.com/vitejs/vite/pulls), de renvoyer des PR de tests en échec basés sur les tickets ouverts, et de soutenir les autres dans [Discussions](https://github.com/vitejs/vite/discussions) et le [forum d'aide de Vite Land](https://discord.com/channels/804011606160703521/1019670660856942652). Si vous souhaitez nous parler, rejoignez notre [communauté Discord](http://chat.vite.dev/) et dites-nous bonjour sur le canal [#contributing](https://discord.com/channels/804011606160703521/804439875226173480). -For the latest news about the Vite ecosystem and Vite core, follow us on [Bluesky](https://bsky.app/profile/vite.dev), [X](https://twitter.com/vite_js), or [Mastodon](https://webtoo.ls/@vite). +Pour les dernières nouvelles sur l'écosystème Vite et le noyau Vite, suivez-nous sur [Bluesky](https://bsky.app/profile/vite.dev), [X](https://twitter.com/vite_js), ou [Mastodon](https://webtoo.ls/@vite). -## Getting started with Vite 6 +## Démarrer avec Vite 6 -You can use `pnpm create vite` to quickly scaffold a Vite app with your preferred framework or play online with Vite 6 using [vite.new](https://vite.new). You can also run `pnpm create vite-extra` to get access to templates from other frameworks and runtimes (Solid, Deno, SSR, and library starters). `create vite-extra` templates are also available when you run `create vite` under the `Others` option. +Vous pouvez utiliser `pnpm create vite` pour créer rapidement une application Vite avec votre framework préféré ou jouer en ligne avec Vite 6 en utilisant [vite.new](https://vite.new). Vous pouvez également exécuter `pnpm create vite-extra` pour accéder aux templates de d'autres frameworks et runtimes (Solid, Deno, SSR, et bibliothèques de starters). `create vite-extra` templates sont également disponibles lorsque vous exécutez `create vite` sous l'option `Others`. -The Vite starter templates are intended to be used as a playground to test Vite with different frameworks. When building your next project, you should reach out to the starter recommended by each framework. `create vite` also provides a shortcut to setup proper starters by some frameworks, like `create-vue`, `Nuxt 3`, `SvelteKit`, `Remix`, `Analog`, and `Angular`. +Les templates de démarrage de Vite sont conçus pour être utilisés comme un terrain de jeu pour tester Vite avec différents frameworks. Lorsque vous construisez votre prochain projet, vous devriez vous tourner vers le démarrage recommandé par chaque framework. `create vite` fournit également un raccourci pour configurer des démarrages appropriés par certains frameworks, comme `create-vue`, `Nuxt 3`, `SvelteKit`, `Remix`, `Analog`, et `Angular`. -## Node.js Support +## Support de Node.js -Vite 6 supports Node.js 18, 20, and 22+, similar to Vite 5. Node.js 21 support has been dropped. Vite drops Node.js support for older versions after their [EOL](https://endoflife.date/nodejs). The Node.js 18 EOL is at the end of April 2025, after which we may release a new major to bump the required Node.js version. +Vite 6 supporte Node.js 18, 20, et 22+, comme Vite 5. Le support de Node.js 21 a été supprimé. Vite cesse le support de Node.js pour les versions plus anciennes après leur [EOL](https://endoflife.date/nodejs). Le EOL de Node.js 18 est le 30 avril 2025, après quoi nous pourrons publier une nouvelle version majeure pour augmenter la version de Node.js requise. -## Experimental Environment API +## API d'environnement expérimental -Vite is getting more flexible with the new Environment API. These new APIs will allow framework authors to offer a dev experience closer to production and for the Ecosystem to share new building blocks. Nothing changes if you're building a SPA; when you use Vite with a single client environment, everything works as before. And even for custom SSR apps, Vite 6 is backward compatible. The primary target audience for Environment API is framework authors. +Vite est devenu plus flexible avec la nouvelle API d'environnement. Ces nouvelles APIs permettront aux auteurs de frameworks d'offrir une expérience de développement plus proche de la production et pour l'écosystème partager de nouveaux blocs de construction. Rien ne change si vous construisez une SPA ; lorsque vous utilisez Vite avec un seul environnement client, tout fonctionne comme avant. Et même pour les applications SSR personnalisées, Vite 6 est compatible avec les versions précédentes. Le public principal pour l'API d'environnement est l'auteur de framework. -For end users who are curious, [Sapphi](https://github.com/sapphi-red) wrote a great [Introduction to Environment API](https://green.sapphi.red/blog/increasing-vites-potential-with-the-environment-api) guide. It is a great place to start and understand why we're trying to make Vite even more flexible. +Pour les utilisateurs finaux qui sont curieux, [Sapphi](https://github.com/sapphi-red) a écrit un guide [Introduction à l'API d'environnement](https://green.sapphi.red/blog/increasing-vites-potential-with-the-environment-api). C'est un excellent point de départ pour comprendre pourquoi nous essayons de rendre Vite encore plus flexible. -If you are a framework author or Vite plugin maintainer and would like to leverage the new APIs, you can learn more at the [Environment API Guides](https://main.vite.dev/guide/api-environment). +Si vous êtes un auteur de framework ou un mainteneur de plugin Vite et souhaitez tirer parti des nouvelles APIs, vous pouvez en savoir plus sur les [Guides API d'environnement](https://main.vite.dev/guide/api-environment). -We want to thank everyone involved in defining and implementing the new APIs. The story begins with Vite 2 adopting the unbundled SSR dev scheme pioneered by [Rich Harris](https://github.com/Rich-Harris) and the [SvelteKit](https://svelte.dev/docs/kit) team. Vite's SSR transform then unlocked [Anthony Fu](https://github.com/antfu/) and [Pooya Parsa](https://github.com/pi0) to create vite-node and improve [Nuxt's Dev SSR story](https://antfu.me/posts/dev-ssr-on-nuxt). Anthony went to use vite-node to power [Vitest](https://vitest.dev), and [Vladimir Sheremet](https://github.com/sheremet-va) kept improving it as part of his work maintaining Vitest. At the beginning of 2023, Vladimir started working to upstream vite-node to Vite Core, and we released it as Runtime API in Vite 5.1 a year later. Feedback from ecosystem partners (special shout-out to the Cloudflare team) pushed us to do a more ambitious rework of Vite's environments. You can learn more about the story at [Patak's ViteConf 24 talk](https://www.youtube.com/watch?v=WImor3HDyqU?si=EZ-rFJn4pDW3tUvp). +Nous voulons remercier toutes les personnes impliquées dans la définition et l'implémentation des nouvelles APIs. L'histoire commence avec Vite 2 qui adopte le schéma de développement SSR non lié initié par [Rich Harris](https://github.com/Rich-Harris) et l'équipe [SvelteKit](https://svelte.dev/docs/kit). Le transformateur SSR de Vite a ensuite amené [Anthony Fu](https://github.com/antfu/) et [Pooya Parsa](https://github.com/pi0) pour créer vite-node et améliorer l'histoire de SSR de développement [Nuxt](https://antfu.me/posts/dev-ssr-on-nuxt). Anthony a utilisé vite-node pour alimenter [Vitest](https://vitest.dev), et [Vladimir Sheremet](https://github.com/sheremet-va) a continué à l'améliorer dans le cadre de son travail de maintenance de Vitest. Au début de 2023, Vladimir a commencé à travailler pour monter vite-node vers le noyau de Vite, et nous l'avons publié comme API de runtime dans Vite 5.1 un an plus tard. Les retours de l'écosystème (un grand merci à l'équipe de Cloudflare) nous ont poussé à faire un re-travail plus ambitieux des environnements de Vite. Vous pouvez en savoir plus sur l'histoire à la [conférence de ViteConf 24 de Patak](https://www.youtube.com/watch?v=WImor3HDyqU?si=EZ-rFJn4pDW3tUvp). -Everyone on the Vite team participated in defining the new API, which was co-designed with feedback from many projects in the Ecosystem. Thanks to everyone involved! We encourage you to get involved if you're building a framework, plugin, or tool on top of Vite. The new APIs are experimental. We will work with the Ecosystem to review how the new APIs will be used and stabilize them for the next major. If you'd like to ask questions or give feedback, there is an [open GitHub discussion here](https://github.com/vitejs/vite/discussions/16358). +Chaque personne de l'équipe Vite a participé à la définition de la nouvelle API, qui a été co-conçue avec des retours de nombreux projets de l'écosystème. Merci à toutes les personnes impliquées ! Nous vous encourgeons à participer si vous construisez un framework, un plugin ou un outil sur Vite. Les nouvelles APIs sont expérimentales. Nous travaillerons avec l'écosystème pour examiner comment les nouvelles APIs seront utilisées pour les stabiliser sur la prochaine version majeure. Si vous souhaitez poser des questions ou donner des retours, il y a un [discussion GitHub ouvert ici](https://github.com/vitejs/vite/discussions/16358). -## Main Changes +## Changements principaux -- [Default value for `resolve.conditions`](/guide/migration#default-value-for-resolve-conditions) +- [Valeur par défaut pour `resolve.conditions`](/guide/migration#default-value-for-resolve-conditions) - [JSON stringify](/guide/migration#json-stringify) -- [Extended support of asset references in HTML elements](/guide/migration#extended-support-of-asset-references-in-html-elements) +- [Support étendu des références d'assets dans les éléments HTML](/guide/migration#extended-support-of-asset-references-in-html-elements) - [postcss-load-config](/guide/migration#postcss-load-config) -- [Sass now uses modern API by default](/guide/migration#sass-now-uses-modern-api-by-default) -- [Customize CSS output file name in library mode](/guide/migration#customize-css-output-file-name-in-library-mode) -- [And more changes that should only affect a few users](/guide/migration#advanced) +- [Sass utilise maintenant l'API moderne par défaut](/guide/migration#sass-now-uses-modern-api-by-default) +- [Personnalisation du nom de fichier de sortie CSS dans le mode bibliothèque](/guide/migration#customize-css-output-file-name-in-library-mode) +- [Et plus de changements qui ne devraient affecter qu'un petit nombre d'utilisateurs](/guide/migration#advanced) -There is also a new [Breaking Changes](/changes/) page that lists all planned, considering, and past changes in Vite. +Il y a également une nouvelle page [Changements cassants](/changes/) qui liste tous les changements planifiés, considérés et passés dans Vite. -## Migrating to Vite 6 +## Migration vers Vite 6 -For most projects, the update to Vite 6 should be straightforward, but we advise reviewing the [detailed Migration Guide](/guide/migration) before upgrading. +Pour la plupart des projets, la mise à jour vers Vite 6 devrait être simple, mais nous vous conseillons de consulter le [guide de migration détaillé](/guide/migration) avant de mettre à jour. -The complete list of changes is at the [Vite 6 Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#500-2024-11-26). +La liste complète des changements est à la page [Changelog de Vite 6](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md#500-2024-11-26). -## Acknowledgments +## Remerciements -Vite 6 results from long work hours by our community of contributors, downstream maintainers, plugin authors, and the [Vite Team](/team). We appreciate the individuals and companies sponsoring Vite development. Vite is brought to you by [VoidZero](https://voidzero.dev), in partnership with [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), and [Astro](https://astro.build). A shout-out to sponsors on [Vite's GitHub Sponsors](https://github.com/sponsors/vitejs) and [Vite's Open Collective](https://opencollective.com/vite). +Vite 6 résulte de longues heures de travail par notre communauté de contributeurs, mainteneurs, auteurs de plugins, et l'équipe [Vite](/team). Nous apprécions les individus et les entreprises qui soutiennent le développement de Vite. Vite est porté par [VoidZero](https://voidzero.dev), en partenariat avec [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), et [Astro](https://astro.build). Un grand merci aux sponsors sur [GitHub Sponsors de Vite](https://github.com/sponsors/vitejs) et [Open Collective de Vite](https://opencollective.com/vite). From 201e183c2cf8eb106aea3e2779584bfabae2c8c4 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 7 Mar 2025 22:39:39 +0100 Subject: [PATCH 12/40] traduction de philosophie --- docs/guide/philosophy.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/docs/guide/philosophy.md b/docs/guide/philosophy.md index ccceeb7..bf81418 100644 --- a/docs/guide/philosophy.md +++ b/docs/guide/philosophy.md @@ -1,27 +1,28 @@ -# Project Philosophy +# Philosophie du projet -## Lean Extendable Core +## Noyau léger et extensible -Vite doesn't intend to cover every use case for every user. Vite aims to support the most common patterns to build Web apps out-of-the-box, but [Vite core](https://github.com/vitejs/vite) must remain lean with a small API surface to keep the project maintainable long-term. This goal is possible thanks to [Vite's rollup-based plugin system](./api-plugin.md). Features that can be implemented as external plugins will generally not be added to Vite core. [vite-plugin-pwa](https://vite-pwa-org.netlify.app/) is a great example of what can be achieved out of Vite core, and there are a lot of [well maintained plugins](https://github.com/vitejs/awesome-vite#plugins) to cover your needs. Vite works closely with the Rollup project to ensure that plugins can be used in both plain-rollup and Vite projects as much as possible, trying to push needed extensions to the Plugin API upstream when possible. -## Pushing the Modern Web +Vite ne vise pas à couvrir tous les cas d'utilisation pour tous les utilisateurs. Vite vise à soutenir les patrons les plus courants pour construire des applications Web out of the box, mais [le noyau de Vite](https://github.com/vitejs/vite) doit rester léger avec une API restreinte pour maintenir le projet pendant une longue durée. Cet objectif est possible grâce au [système de plugin basé sur Rollup de Vite](./api-plugin.md). Les fonctionnalités qui peuvent être implémentées en tant que plugins externes ne seront généralement pas ajoutées au noyau de Vite. [vite-plugin-pwa](https://vite-pwa-org.netlify.app/) est un excellent exemple de ce que peut être atteint hors du noyau de Vite, et il existe un grand nombre de [plugins maintenus](https://github.com/vitejs/awesome-vite#plugins) pour couvrir vos besoins. Vite travaille de près avec le projet Rollup pour s'assurer que les plugins peuvent être utilisés dans les projets Rollup et Vite autant que possible, essayant de pousser les extensions nécessaires à l'API Plugin vers le haut lorsque c'est possible. -Vite provides opinionated features that push writing modern code. For example: +## Poussant le Web Moderne -- The source code can only be written in ESM, where non-ESM dependencies need to be [pre-bundled as ESM](./dep-pre-bundling) in order to work. -- Web workers are encouraged to be written with the [`new Worker` syntax](./features#web-workers) to follow modern standards. -- Node.js modules cannot be used in the browser. +Vite fournit des fonctionnalités avec une conviction forte qui poussent à écrire du code moderne. Par exemple : -When adding new features, these patterns are followed to create a future-proof API, which may not always be compatible with other build tools. +- Le code source ne peut être écrit qu'en ESM, où les dépendances non-ESM doivent être [pré-bundlées en ESM](./dep-pre-bundling) pour fonctionner. +- Les workers web sont encouragés à être écrits avec la syntaxe [`new Worker`](./features#web-workers) pour suivre les normes modernes. +- Les modules Node.js ne peuvent pas être utilisés dans le navigateur. -## A Pragmatic Approach to Performance +Lorsque de nouvelles fonctionnalités sont ajoutées, ces patterns sont suivis pour créer une API futur-proof, qui peut ne pas toujours être compatible avec les autres outils de build. -Vite has been focused on performance since its [origins](./why.md). Its dev server architecture allows HMR that stays fast as projects scale. Vite uses native tools like [esbuild](https://esbuild.github.io/) and [SWC](https://github.com/vitejs/vite-plugin-react-swc) to implement intensive tasks but keeps the rest of the code in JS to balance speed with flexibility. When needed, framework plugins will tap into [Babel](https://babeljs.io/) to compile user code. And during build time Vite currently uses [Rollup](https://rollupjs.org/) where bundling size and having access to a wide ecosystem of plugins are more important than raw speed. Vite will continue to evolve internally, using new libraries as they appear to improve DX while keeping its API stable. +## Une approche pragmatique pour les performances -## Building Frameworks on Top of Vite +Vite s'est concentré sur les performances depuis ses [origines](./why.md). Son architecture de serveur de développement permet un HMR qui reste rapide même lorsque les projets grandissent. Vite utilise des outils natifs comme [esbuild](https://esbuild.github.io/) et [SWC](https://github.com/vitejs/vite-plugin-react-swc) pour implémenter des tâches intensives mais garde le reste du code en JS pour équilibrer la vitesse avec la flexibilité. Lorsque nécessaire, les plugins de framework tapent sur [Babel](https://babeljs.io/) pour compiler le code utilisateur. Et pendant le build, Vite utilise actuellement [Rollup](https://rollupjs.org/) où la taille du bundling et l'accès à un large écosystème de plugins sont plus importants que la vitesse brute. Vite continuera à évoluer en interne, utilisant de nouvelles bibliothèques lorsqu'elles apparaissent pour améliorer l'expérience de développement tout en maintenant son API stable. -Although Vite can be used by users directly, it shines as a tool to create frameworks. Vite core is framework agnostic, but there are polished plugins for each UI framework. Its [JS API](./api-javascript.md) allows App Framework authors to use Vite features to create tailored experiences for their users. Vite includes support for [SSR primitives](./ssr.md), usually present in higher-level tools but fundamental to building modern web frameworks. And Vite plugins complete the picture by offering a way to share between frameworks. Vite is also a great fit when paired with [Backend frameworks](./backend-integration.md) like [Ruby](https://vite-ruby.netlify.app/) and [Laravel](https://laravel.com/docs/10.x/vite). +## Construire des frameworks sur Vite -## An Active Ecosystem +Bien que Vite puisse être utilisé directement par les utilisateurs, il brille comme outil pour créer des frameworks. Le noyau de Vite est indépendant du framework, mais il existe des plugins élaborés pour chaque framework UI. Son [API JS](./api-javascript.md) permet aux auteurs de Framework d'utiliser les fonctionnalités de Vite pour créer des expériences adaptées à leurs utilisateurs. Vite inclut le support de [primitives SSR](./ssr.md), généralement présentes dans les outils de niveau supérieur mais fondamentales pour construire des frameworks web modernes. Les plugins Vite complètent la photo en offrant un moyen de partager entre frameworks. Vite est également un excellent fit lorsqu'il est pairé avec un [frameworks Backend](./backend-integration.md) comme [Ruby](https://vite-ruby.netlify.app/) et [Laravel](https://laravel.com/docs/10.x/vite). -Vite evolution is a cooperation between framework and plugin maintainers, users, and the Vite team. We encourage active participation in Vite's Core development once a project adopts Vite. We work closely with the main projects in the ecosystem to minimize regressions on each release, aided by tools like [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci). It allows us to run the CI of major projects using Vite on selected PRs and gives us a clear status of how the Ecosystem would react to a release. We strive to fix regressions before they hit users and allow projects to update to the next versions as soon as they are released. If you are working with Vite, we invite you to join [Vite's Discord](https://chat.vite.dev) and get involved in the project too. +## Un écosystème actif + +L'évolution de Vite est une coopération entre les auteurs de framework et les mainteneurs de plugins, les utilisateurs et l'équipe Vite. Nous encouragons une participation active au développement de Vite's Core une fois que le projet adopte Vite. Nous travaillons de près avec les principaux projets de l'écosystème pour minimiser les régressions sur chaque release, aidé par des outils comme [vite-ecosystem-ci](https://github.com/vitejs/vite-ecosystem-ci). Cela nous permet de lancer le CI de projets majeurs utilisant Vite sur les PRs sélectionnés et de donner un état clair de la façon dont l'écosystème réagirait à une release. Nous nous efforçons de corriger les régressions avant qu'elles atteignent les utilisateurs et permettent aux projets de mettre à jour à la prochaine version dès qu'elles sont disponibles. Si vous travaillez avec Vite, nous vous invitons à rejoindre le [Discord de Vite](https://chat.vite.dev) et participer au projet. From bdfa42db2880a31734a7c76dd5ef66fc3a143fbf Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 20:11:48 +0100 Subject: [PATCH 13/40] traduction de hotupdate --- docs/changes/hotupdate-hook.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/changes/hotupdate-hook.md b/docs/changes/hotupdate-hook.md index ce3283f..9098f79 100644 --- a/docs/changes/hotupdate-hook.md +++ b/docs/changes/hotupdate-hook.md @@ -1,20 +1,20 @@ -# HMR `hotUpdate` Plugin Hook +# HMR (hot module reloading) `hotUpdate` Plugin Hook -::: tip Feedback -Give us feedback at [Environment API feedback discussion](https://github.com/vitejs/vite/discussions/16358) +::: tip Retours +Donnez-nous vos retours dans les [discussions GitHub](https://github.com/vitejs/vite/discussions/16358) ::: -We're planning to deprecate the `handleHotUpdate` plugin hook in favor of [`hotUpdate` hook](/guide/api-environment#the-hotupdate-hook) to be [Environment API](/guide/api-environment.md) aware, and handle additional watch events with `create` and `delete`. +Nous prévoyons de déprécier le hook `handleHotUpdate` en faveur du nouveau hook [`hotUpdate`](/guide/api-environment#the-hotupdate-hook) pour être compatible avec l'[API Environnement](/guide/api-environment.md), et pour gérer les événements de surveillance supplémentaires avec `create` et `delete`. -Affected scope: `Vite Plugin Authors` +Portée affectée: `Auteurs de plugins Vite` -::: warning Future Deprecation -`hotUpdate` was first introduced in `v6.0`. The deprecation of `handleHotUpdate` is planned for `v7.0`. We don't yet recommend moving away from `handleHotUpdate` yet. If you want to experiment and give us feedback, you can use the `future.removePluginHookHandleHotUpdate` to `"warn"` in your vite config. +::: warning Dépréciation future +`hotUpdate` a été introduit dans `v6.0`. La dépréciation de `handleHotUpdate` est prévue pour `v7.0`. Nous ne recommandons pas encore de passer à `hotUpdate`. Si vous souhaitez expérimenter et donner vos retours, vous pouvez utiliser la configuration `future.removePluginHookHandleHotUpdate` pour `"warn"` dans votre configuration Vite. ::: ## Motivation -The [`handleHotUpdate` hook](/guide/api-plugin.md#handlehotupdate) allows to perform custom HMR update handling. A list of modules to be updated is passed in the `HmrContext` +Le hook [`handleHotUpdate`](/guide/api-plugin.md#handlehotupdate) permet de gérer les mises à jour HMR personnalisées. Une liste de modules à mettre à jour est passée dans le contexte `HmrContext` ```ts interface HmrContext { @@ -26,9 +26,9 @@ interface HmrContext { } ``` -This hook is called once for all environments, and the passed modules have mixed information from the Client and SSR environments only. Once frameworks move to custom environments, a new hook that is called for each of them is needed. +Ce hook est appelé une fois pour tous les environnements, et les modules passés ont des informations mélangées provenant des environnements Client et SSR. Une fois que les frameworks passeront à des environnements personnalisés, un nouveau hook appelé pour chacun d'entre eux est nécessaire. -The new `hotUpdate` hook works in the same way as `handleHotUpdate` but it is called for each environment and receives a new `HotUpdateOptions` instance: +Le nouveau hook `hotUpdate` fonctionne de la même manière que `handleHotUpdate` mais il est appelé pour chaque environnement et reçoit une nouvelle instance `HotUpdateOptions`: ```ts interface HotUpdateOptions { @@ -41,13 +41,13 @@ interface HotUpdateOptions { } ``` -The current dev environment can be accessed like in other Plugin hooks with `this.environment`. The `modules` list will now be module nodes from the current environment only. Each environment update can define different update strategies. +L'environnement de développement actuel peut être accédé comme dans les autres hooks de plugin avec `this.environment`. La liste `modules` ne contiendra maintenant que les modules de l'environnement actuel. Chaque environnement peut définir des stratégies de mise à jour différentes. -This hook is also now called for additional watch events and not only for `'update'`. Use `type` to differentiate between them. +Ce hook est maintenant appelé pour les événements de surveillance supplémentaires et non seulement pour `'update'`. Utilisez `type` pour les différencier. -## Migration Guide +## Guide de migration -Filter and narrow down the affected module list so that the HMR is more accurate. +Filtrez et réduisez la liste des modules affectés pour que le HMR soit plus précis. ```js handleHotUpdate({ modules }) { @@ -61,7 +61,7 @@ hotUpdate({ modules }) { } ``` -Return an empty array and perform a full reload: +Retourner un tableau vide et effectuer un rechargement complet: ```js handleHotUpdate({ server, modules, timestamp }) { @@ -97,7 +97,7 @@ hotUpdate({ modules, timestamp }) { } ``` -Return an empty array and perform complete custom HMR handling by sending custom events to the client: +Retourner un tableau vide et effectuer un traitement HMR personnalisé complet en envoyant des événements personnalisés au client: ```js handleHotUpdate({ server }) { @@ -109,7 +109,7 @@ handleHotUpdate({ server }) { return [] } -// Migrate to... +// Migrer vers... hotUpdate() { this.environment.hot.send({ From 36627239e69f98943385338a2082c7ee9cf2031a Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 20:13:26 +0100 Subject: [PATCH 14/40] traduction de ssr-using-modulerunner --- docs/changes/ssr-using-modulerunner.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/changes/ssr-using-modulerunner.md b/docs/changes/ssr-using-modulerunner.md index 2fd80eb..c16a548 100644 --- a/docs/changes/ssr-using-modulerunner.md +++ b/docs/changes/ssr-using-modulerunner.md @@ -1,21 +1,21 @@ -# SSR using `ModuleRunner` API +# SSR avec l'API `ModuleRunner` -::: tip Feedback -Give us feedback at [Environment API feedback discussion](https://github.com/vitejs/vite/discussions/16358) +::: tip Retours +Donnez-nous vos retours dans les [discussions GitHub](https://github.com/vitejs/vite/discussions/16358) ::: -`server.ssrLoadModule` has been replaced by importing from a [Module Runner](/guide/api-environment#modulerunner). +`server.ssrLoadModule` a été remplacé par l'importation depuis un [Module Runner](/guide/api-environment#modulerunner). -Affect scope: `Vite Plugin Authors` +Scopes affectés: `Auteurs de plugins Vite` -::: warning Future Deprecation -`ModuleRunner` was first introduce in `v6.0`. The deprecation of `server.ssrLoadModule` is planned for a future major. To identify your usage, set `future.removeSsrLoadModule` to `"warn"` in your vite config. +::: warning Dépréciation future +`ModuleRunner` a été introduit dans `v6.0`. La dépréciation de `server.ssrLoadModule` est prévue pour une future version majeure. Pour identifier votre utilisation, définissez `future.removeSsrLoadModule` sur `"warn"` dans votre configuration Vite. ::: ## Motivation -The `server.ssrLoadModule(url)` only allows importing modules in the `ssr` environment and can only execute the modules in the same process as the Vite dev server. For apps with custom environments, each is associated with a `ModuleRunner` that may be running in a separate thread or process. To import modules, we now have `moduleRunner.import(url)`. +La `server.ssrLoadModule(url)` ne permet que d'importer des modules dans l'environnement `ssr` et ne peut exécuter les modules que dans le même processus que le serveur de développement Vite. Pour les applications avec des environnements personnalisés, chaque environnement est associé à un `ModuleRunner` qui peut être en cours d'exécution dans un thread ou un processus distinct. Pour importer des modules, nous avons maintenant `moduleRunner.import(url)`. -## Migration Guide +## Guide de migration -Check out the [Environment API for Frameworks Guide](../guide/api-environment-frameworks.md). +Consultez le [Guide pour les Frameworks avec l'API Environnement](../guide/api-environment-frameworks.md). From a1cf5c950a03111fed09b398987cfcd5d719cbb7 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 20:15:30 +0100 Subject: [PATCH 15/40] traduction de environnement-in-hook --- docs/changes/this-environment-in-hooks.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/changes/this-environment-in-hooks.md b/docs/changes/this-environment-in-hooks.md index 2577ef3..e37a4e4 100644 --- a/docs/changes/this-environment-in-hooks.md +++ b/docs/changes/this-environment-in-hooks.md @@ -1,24 +1,24 @@ -# `this.environment` in Hooks +# `this.environment` dans les hooks -::: tip Feedback -Give us feedback at [Environment API feedback discussion](https://github.com/vitejs/vite/discussions/16358) +::: tip Retours +Donnez-nous vos retours dans les [discussions GitHub](https://github.com/vitejs/vite/discussions/16358) ::: -Before Vite 6, only two environments were available: `client` and `ssr`. A single `options.ssr` plugin hook argument in `resolveId`, `load` and `transform` allowed plugin authors to differentiate between these two environments when processing modules in plugin hooks. In Vite 6, a Vite application can define any number of named environments as needed. We're introducing `this.environment` in the plugin context to interact with the environment of the current module in hooks. +Avant Vite 6, seuls deux environnements étaient disponibles : `client` et `ssr`. Un seul argument `options.ssr` dans les hooks `resolveId`, `load` et `transform` permettait aux auteurs de plugins de différencier ces deux environnements lors du traitement des modules dans les hooks de plugin. Dans Vite 6, une application Vite peut définir autant d'environnements nommés que nécessaire. Nous introduisons `this.environment` dans le contexte du plugin pour interagir avec l'environnement du module actuel dans les hooks. -Affect scope: `Vite Plugin Authors` +Scopes affectés: `Auteurs de plugins Vite` -::: warning Future Deprecation -`this.environment` was introduced in `v6.0`. The deprecation of `options.ssr` is planned for `v7.0`. At that point we'll start recommending migrating your plugins to use the new API. To identify your usage, set `future.removePluginHookSsrArgument` to `"warn"` in your vite config. +::: warning Dépréciation future +`this.environment` a été introduit dans `v6.0`. La dépréciation de `options.ssr` est prévue pour `v7.0`. À ce stade, nous commencerons à recommander la migration de vos plugins vers la nouvelle API. Pour identifier votre utilisation, définissez `future.removePluginHookSsrArgument` sur `"warn"` dans votre configuration Vite. ::: ## Motivation -`this.environment` not only allow the plugin hook implementation to know the current environment name, it also gives access to the environment config options, module graph information, and transform pipeline (`environment.config`, `environment.moduleGraph`, `environment.transformRequest()`). Having the environment instance available in the context allows plugin authors to avoid the dependency of the whole dev server (typically cached at startup through the `configureServer` hook). +`this.environment` permet non seulement au code d'implémentation du hook de plugin de connaître le nom de l'environnement actuel, mais également d'accéder aux options de configuration de l'environnement, à l'information sur le graphique des modules et au pipeline de transformation (`environment.config`, `environment.moduleGraph`, `environment.transformRequest()`). Avoir l'instance d'environnement disponible dans le contexte permet aux auteurs de plugins de se passer de la dépendance du serveur de développement complet (typiquement mis en cache au démarrage via le hook `configureServer`). -## Migration Guide +## Guide de migration -For the existing plugin to do a quick migration, replace the `options.ssr` argument with `this.environment.name !== 'client'` in the `resolveId`, `load` and `transform` hooks: +Pour le plugin existant, effectuez une migration rapide en remplaçant l'argument `options.ssr` par `this.environment.name !== 'client'` dans les hooks `resolveId`, `load` et `transform`: ```ts import { Plugin } from 'vite' @@ -40,4 +40,4 @@ export function myPlugin(): Plugin { } ``` -For a more robust long term implementation, the plugin hook should handle for [multiple environments](/guide/api-environment.html#accessing-the-current-environment-in-hooks) using fine-grained environment options instead of relying on the environment name. +Pour une implémentation plus robuste à long terme, le hook de plugin devrait gérer les [environnements multiples](/guide/api-environment.html#accessing-the-current-environment-in-hooks) en utilisant des options d'environnement plus fines plutôt que de se baser sur le nom de l'environnement. From f4fafcc422f2f3d87ff57277bf90d34b8990b12b Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 20:25:35 +0100 Subject: [PATCH 16/40] traduction de shared-plugin --- docs/changes/shared-plugins-during-build.md | 24 ++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/changes/shared-plugins-during-build.md b/docs/changes/shared-plugins-during-build.md index 730b943..90ed894 100644 --- a/docs/changes/shared-plugins-during-build.md +++ b/docs/changes/shared-plugins-during-build.md @@ -1,24 +1,24 @@ -# Shared Plugins during Build +# Plugins partagés lors du build -::: tip Feedback -Give us feedback at [Environment API feedback discussion](https://github.com/vitejs/vite/discussions/16358) +::: tip Retours +Donnez-nous vos retours dans les [discussions GitHub](https://github.com/vitejs/vite/discussions/16358) ::: -See [Shared plugins during build](/guide/api-environment-plugins.md#shared-plugins-during-build). +Voir [Plugins partagés lors du build](/guide/api-environment-plugins.md#shared-plugins-during-build). -Affect scope: `Vite Plugin Authors` +Scopes affectés: `Auteurs de plugins Vite` -::: warning Future Default Change -`builder.sharedConfigBuild` was first introduce in `v6.0`. You can set it true to check how your plugins work with a shared config. We're looking for feedback about changing the default in a future major once the plugin ecosystem is ready. +::: warning Changement de valeur par défaut futur +`builder.sharedConfigBuild` a été introduit dans `v6.0`. Vous pouvez le définir sur `true` pour vérifier comment vos plugins fonctionnent avec une configuration partagée. Nous recherchons des retours sur le changement de valeur par défaut dans une future version majeure une fois que l'écosystème des plugins sera prêt. ::: ## Motivation -Align dev and build plugin pipelines. +Aligner les pipelines de plugins de développement et de build. -## Migration Guide +## Guide de migration -To be able to share plugins across environments, plugin state must be keyed by the current environment. A plugin of the following form will count the number of transformed modules across all environments. +Pour pouvoir partager des plugins entre environnements, l'état du plugin doit être associé par à l'environnement actuel par un système de clés. Un plugin de la forme suivante comptera le nombre de modules transformés dans tous les environnements. ```js function CountTransformedModulesPlugin() { @@ -38,7 +38,7 @@ function CountTransformedModulesPlugin() { } ``` -If we instead want to count the number of transformed modules for each environment, we need to keep a map: +Si nous voulons compter le nombre de modules transformés pour chaque environnement, nous devons conserver une map: ```js function PerEnvironmentCountTransformedModulesPlugin() { @@ -59,7 +59,7 @@ function PerEnvironmentCountTransformedModulesPlugin() { } ``` -To simplify this pattern, Vite exports a `perEnvironmentState` helper: +Pour simplifier ce pattern, Vite exporte un assistant `perEnvironmentState`: ```js function PerEnvironmentCountTransformedModulesPlugin() { From 971d46cb73beaed288fbe7c2c8691e484a553b94 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 20:28:13 +0100 Subject: [PATCH 17/40] traduction de per-environment-api --- docs/changes/per-environment-apis.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/changes/per-environment-apis.md b/docs/changes/per-environment-apis.md index 4ff2738..a850691 100644 --- a/docs/changes/per-environment-apis.md +++ b/docs/changes/per-environment-apis.md @@ -1,15 +1,15 @@ -# Move to per-environment APIs +# Déplacer vers les API par environnement -::: tip Feedback -Give us feedback at [Environment API feedback discussion](https://github.com/vitejs/vite/discussions/16358) +::: tip Retour +Donnez-nous votre retour sur le [Discussion sur les API Environnement](https://github.com/vitejs/vite/discussions/16358) ::: -Multiple APIs from `ViteDevServer` related to module graph and modules transforms have been moved to the `DevEnvironment` instances. +Plusieurs API de `ViteDevServer` liées au graphique de modules et aux transformations de modules ont été déplacées vers les instances `DevEnvironment`. -Affect scope: `Vite Plugin Authors` +Scopes affectés: `Vite Plugin Authors` -::: warning Future Deprecation -The `Environment` instance was first introduced at `v6.0`. The deprecation of `server.moduleGraph` and other methods that are now in environments is planned for `v7.0`. We don't recommend moving away from server methods yet. To identify your usage, set these in your vite config. +::: warning Dépréciation future +L'instance `Environment` a été introduite dans `v6.0`. La dépréciation de `server.moduleGraph` et d'autres méthodes qui sont maintenant dans les environnements est prévue pour `v7.0`. Nous ne recommandons pas de quitter les méthodes du serveur. Pour identifier votre utilisation, définissez ces options dans votre configuration Vite. ```ts future: { @@ -22,11 +22,11 @@ future: { ## Motivation -In Vite v5 and before, a single Vite dev server always had two environments (`client` and `ssr`). The `server.moduleGraph` had mixed modules from both of these environments. Nodes were connected through `clientImportedModules` and `ssrImportedModules` lists (but a single `importers` list was maintained for each). A transformed module was represented by an `id` and a `ssr` boolean. This boolean needed to be passed to APIs, for example `server.moduleGraph.getModuleByUrl(url, ssr)` and `server.transformRequest(url, { ssr })`. +Dans Vite v5 et avant, un seul serveur Vite avait toujours deux environnements (`client` et `ssr`). Le `server.moduleGraph` avait des modules mélangés de ces deux environnements. Les nœuds étaient connectés via les listes `clientImportedModules` et `ssrImportedModules` (mais un seul `importers` list était maintenue pour chaque). Un module transformé était représenté par un `id` et un booléen `ssr`. Ce booléen nécessitait d'être passé à des API, par exemple `server.moduleGraph.getModuleByUrl(url, ssr)` et `server.transformRequest(url, { ssr })`. -In Vite v6, it is now possible to create any number of custom environments (`client`, `ssr`, `edge`, etc). A single `ssr` boolean isn't enough anymore. Instead of changing the APIs to be of the form `server.transformRequest(url, { environment })`, we moved these methods to the environment instance allowing them to be called without a Vite dev server. +Dans Vite v6, il est maintenant possible de créer n'importe quel nombre d'environnements personnalisés (`client`, `ssr`, `edge`, etc). Un seul booléen `ssr` ne suffit plus. Au lieu de changer les API pour être de la forme `server.transformRequest(url, { environment })`, nous avons déplacé ces méthodes vers l'instance d'environnement, permettant de les appeler sans serveur Vite de développement. -## Migration Guide +## Guide de migration - `server.moduleGraph` -> [`environment.moduleGraph`](/guide/api-environment#separate-module-graphs) - `server.transformRequest(url, ssr)` -> `environment.transformRequest(url)` From fcb49304b247a5f59eb91b6333947fe35ed50b0b Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 21:26:03 +0100 Subject: [PATCH 18/40] traduction de changes --- docs/changes/index.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/changes/index.md b/docs/changes/index.md index 7607ae2..ec5be3f 100644 --- a/docs/changes/index.md +++ b/docs/changes/index.md @@ -1,18 +1,18 @@ # Breaking Changes -List of breaking changes in Vite including API deprecations, removals, and changes. Most of the changes below can be opt-in using the [`future` option](/config/shared-options.html#future) in your Vite config. +Liste des changements cassants dans Vite, y compris les dépréciations, suppressions et modifications des API. La plupart des modifications ci-dessous peuvent être incluses en utilisant l'option [`future`](/config/shared-options.html#future) dans votre configuration Vite. -## Planned +## Changements planifiés -These changes are planned for the next major version of Vite. The deprecation or usage warnings will guide you where possible, and we're reaching out to framework, plugin authors, and users to apply these changes. +Ces changements sont prévus pour la prochaine version majeure de Vite. Les avertissements de dépréciation ou de suppression vous guideront dans la mesure du possible, et nous nous adressons aux auteurs de framework, de plugins et aux utilisateurs pour appliquer ces modifications. -- _No planned changes yet_ +- _Aucun changement planifié pour le moment_ -## Considering +## Considérations -These changes are being considered and are often experimental APIs that intend to improve upon current usage patterns. As not all changes are listed here, please check out the [Experimental Label in Vite GitHub Discussions](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=label%3Aexperimental+category%3AFeedback) for the full list. +Ces changements sont en cours de considération et sont souvent des API expérimentales qui visent à améliorer les usages actuels. Comme tous les changements ne sont pas listés ici, veuillez consulter la [Label Expérimental dans les discussions GitHub de Vite](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=label%3Aexperimental+category%3AFeedback) pour la liste complète. -We don't recommend switching to these APIs yet. They are included in Vite to help us gather feedback. Please check these proposals and let us know how they work in your use case in each's linked GitHub Discussions. +Nous ne recommandons pas de basculer vers ces API. Elles sont incluses dans Vite pour nous aider à collecter des retours. Veuillez consulter ces propositions et nous informer de leur fonctionnement dans votre cas d'utilisation dans les discussions GitHub liées à chaque proposition. - [`this.environment` in Hooks](/changes/this-environment-in-hooks) - [HMR `hotUpdate` Plugin Hook](/changes/hotupdate-hook) @@ -20,8 +20,8 @@ We don't recommend switching to these APIs yet. They are included in Vite to hel - [SSR using `ModuleRunner` API](/changes/ssr-using-modulerunner) - [Shared plugins during build](/changes/shared-plugins-during-build) -## Past +## Changements passés -The changes below has been done or reverted. They are no longer relevant in the current major version. +Les changements ci-dessous ont été effectués ou annulés. Ils ne sont plus pertinents dans la version majeure actuelle. -- _No past changes yet_ +- _Aucun changement passé pour le moment_ From 90e94d413b47abd94f34bf1a5561891659b7890a Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 21:43:47 +0100 Subject: [PATCH 19/40] traduction de build-options --- docs/config/build-options.md | 116 +++++++++++++++++------------------ 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/docs/config/build-options.md b/docs/config/build-options.md index 7e22831..11d064e 100644 --- a/docs/config/build-options.md +++ b/docs/config/build-options.md @@ -1,39 +1,39 @@ -# Build Options +# Options de build -Unless noted, the options in this section are only applied to build. +Sauf indication contraire, les options de cette section ne s'appliquent qu'au buil. ## build.target - **Type:** `string | string[]` - **Default:** `'modules'` -- **Related:** [Browser Compatibility](/guide/build#browser-compatibility) +- **Related:** [Compatibilité avec les navigateurs](/guide/build#browser-compatibility) -Browser compatibility target for the final bundle. The default value is a Vite special value, `'modules'`, which targets browsers with [native ES Modules](https://caniuse.com/es6-module), [native ESM dynamic import](https://caniuse.com/es6-module-dynamic-import), and [`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta) support. Vite will replace `'modules'` to `['es2020', 'edge88', 'firefox78', 'chrome87', 'safari14']` +Cible de compatibilité avec les navigateurs pour le bundle final. La valeur par défaut est une valeur spéciale Vite, `'modules'`, qui cible les navigateurs avec les [Modules ES natifs](https://caniuse.com/es6-module), les [imports dynamiques ESM natifs](https://caniuse.com/es6-module-dynamic-import), et l'[`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta) support. Vite remplacera `'modules'` par `['es2020', 'edge88', 'firefox78', 'chrome87', 'safari14']` -Another special value is `'esnext'` - which assumes native dynamic imports support and will only perform minimal transpiling. +Une autre valeur spéciale est `'esnext'` - qui suppose un support natif pour les imports dynamiques et ne fera que des transpilations minimales. -The transform is performed with esbuild and the value should be a valid [esbuild target option](https://esbuild.github.io/api/#target). Custom targets can either be an ES version (e.g. `es2015`), a browser with version (e.g. `chrome58`), or an array of multiple target strings. +La transformation est effectuée avec esbuild et la valeur doit être une option de cible valide [esbuild](https://esbuild.github.io/api/#target). Les cibles personnalisées peuvent être une version ES (e.g. `es2015`), un navigateur avec une version (e.g. `chrome58`), ou un tableau de chaînes de cible. -Note the build will fail if the code contains features that cannot be safely transpiled by esbuild. See [esbuild docs](https://esbuild.github.io/content-types/#javascript) for more details. +Noter que le build échouera si le code contient des fonctionnalités qui ne peuvent pas être transpilées de manière sûre avec esbuild. Voir [docs esbuild](https://esbuild.github.io/content-types/#javascript) pour plus de détails. ## build.modulePreload - **Type:** `boolean | { polyfill?: boolean, resolveDependencies?: ResolveModulePreloadDependenciesFn }` - **Default:** `{ polyfill: true }` -By default, a [module preload polyfill](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) is automatically injected. The polyfill is auto injected into the proxy module of each `index.html` entry. If the build is configured to use a non-HTML custom entry via `build.rollupOptions.input`, then it is necessary to manually import the polyfill in your custom entry: +Par défaut, un [polyfill de préchargement de module](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) est injecté automatiquement. Le polyfill est injecté automatiquement dans le module proxy de chaque entrée `index.html`. Si le build est configuré pour utiliser une entrée personnalisée non-HTML via `build.rollupOptions.input`, il est nécessaire d'importer manuellement le polyfill dans votre entrée personnalisée : ```js import 'vite/modulepreload-polyfill' ``` -Note: the polyfill does **not** apply to [Library Mode](/guide/build#library-mode). If you need to support browsers without native dynamic import, you should probably avoid using it in your library. +Note: le polyfill ne s'applique **pas** à [Mode Bibliothèque](/guide/build#library-mode). Si vous avez besoin de supporter les navigateurs sans importation dynamique native, vous devriez probablement l'éviter dans votre bibliothèque. -The polyfill can be disabled using `{ polyfill: false }`. +Le polyfill peut être désactivé en utilisant `{ polyfill: false }`. -The list of chunks to preload for each dynamic import is computed by Vite. By default, an absolute path including the `base` will be used when loading these dependencies. If the `base` is relative (`''` or `'./'`), `import.meta.url` is used at runtime to avoid absolute paths that depend on the final deployed base. +La liste des chunks à précharger pour chaque importation dynamique est calculée par Vite. Par défaut, un chemin absolu incluant le `base` sera utilisé lors du chargement de ces dépendances. Si le `base` est relatif (`''` ou `'./'`), `import.meta.url` est utilisé à l'exécution pour éviter les chemins absolus qui dépendent de la base déployée finalement. -There is experimental support for fine grained control over the dependencies list and their paths using the `resolveDependencies` function. [Give Feedback](https://github.com/vitejs/vite/discussions/13841). It expects a function of type `ResolveModulePreloadDependenciesFn`: +Il existe un support expérimental pour un contrôle plus fin de la liste des dépendances et de leurs chemins en utilisant la fonction `resolveDependencies`. [Faire un retour](https://github.com/vitejs/vite/discussions/13841). Il attend une fonction de type `ResolveModulePreloadDependenciesFn`: ```ts type ResolveModulePreloadDependenciesFn = ( @@ -46,7 +46,7 @@ type ResolveModulePreloadDependenciesFn = ( ) => string[] ``` -The `resolveDependencies` function will be called for each dynamic import with a list of the chunks it depends on, and it will also be called for each chunk imported in entry HTML files. A new dependencies array can be returned with these filtered or more dependencies injected, and their paths modified. The `deps` paths are relative to the `build.outDir`. The return value should be a relative path to the `build.outDir`. +La fonction `resolveDependencies` sera appelée pour chaque importation dynamique avec une liste des chunks dont elle dépend, et elle sera également appelée pour chaque chunk importé dans les fichiers HTML d'entrée. Un nouveau tableau de dépendances peut être retourné avec ces dépendances filtrées ou plus de dépendances injectées, et leurs chemins modifiés. Les chemins `deps` sont relatifs à `build.outDir`. La valeur retournée doit être un chemin relatif à `build.outDir`. ```js twoslash /** @type {import('vite').UserConfig} */ @@ -64,43 +64,43 @@ modulePreload: { } ``` -The resolved dependency paths can be further modified using [`experimental.renderBuiltUrl`](../guide/build.md#advanced-base-options). +Les chemins des dépendances résolus peuvent être modifiés davantage en utilisant [`experimental.renderBuiltUrl`](../guide/build.md#advanced-base-options). ## build.polyfillModulePreload - **Type:** `boolean` - **Default:** `true` -- **Deprecated** use `build.modulePreload.polyfill` instead +- **Déprécié** utilisez `build.modulePreload.polyfill` à la place -Whether to automatically inject a [module preload polyfill](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill). +Détermine si un [polyfill de préchargement de module](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) doit être injecté automatiquement. ## build.outDir - **Type:** `string` - **Default:** `dist` -Specify the output directory (relative to [project root](/guide/#index-html-and-project-root)). +Spécifie le répertoire de sortie (relatif au [projet racine](/guide/#index-html-and-project-root)). ## build.assetsDir - **Type:** `string` - **Default:** `assets` -Specify the directory to nest generated assets under (relative to `build.outDir`. This is not used in [Library Mode](/guide/build#library-mode)). +Spécifie le répertoire à imbriquer sous les assets générés (relatif à `build.outDir`. Cette option n'est pas utilisée dans [Mode Bibliothèque](/guide/build#mode-bibliothèque)). ## build.assetsInlineLimit - **Type:** `number` | `((filePath: string, content: Buffer) => boolean | undefined)` - **Default:** `4096` (4 KiB) -Imported or referenced assets that are smaller than this threshold will be inlined as base64 URLs to avoid extra http requests. Set to `0` to disable inlining altogether. +Les assets importés ou référencés qui sont plus petits que ce seuil seront inlinés en tant que URL base64 pour éviter des requêtes HTTP supplémentaires. Définissez sur `0` pour désactiver l'inlining complètement. -If a callback is passed, a boolean can be returned to opt-in or opt-out. If nothing is returned the default logic applies. +Si une fonction est passée, un booléen peut être retourné pour opt-in ou opt-out. Si rien n'est retourné, la logique par défaut s'applique. -Git LFS placeholders are automatically excluded from inlining because they do not contain the content of the file they represent. +Les placeholders Git LFS sont automatiquement exclus de l'inlining car ils ne contiennent pas le contenu du fichier qu'ils représentent. ::: tip Note -If you specify `build.lib`, `build.assetsInlineLimit` will be ignored and assets will always be inlined, regardless of file size or being a Git LFS placeholder. +Si vous spécifiez `build.lib`, `build.assetsInlineLimit` sera ignoré et les assets seront toujours inlinés, quelle que soit la taille du fichier ou le fait qu'ils soient un placeholder Git LFS. ::: ## build.cssCodeSplit @@ -108,12 +108,12 @@ If you specify `build.lib`, `build.assetsInlineLimit` will be ignored and assets - **Type:** `boolean` - **Default:** `true` -Enable/disable CSS code splitting. When enabled, CSS imported in async JS chunks will be preserved as chunks and fetched together when the chunk is fetched. +Active/désactive le fractionnement CSS. Lorsque c'est activé, les CSS importés dans les chunks JS asynchrones seront conservés comme chunks et récupérés ensemble lorsque le chunk est récupéré. -If disabled, all CSS in the entire project will be extracted into a single CSS file. +Si désactivé, tous les CSS dans le projet entier seront extraits dans un seul fichier CSS. ::: tip Note -If you specify `build.lib`, `build.cssCodeSplit` will be `false` as default. +Si vous spécifiez `build.lib`, `build.cssCodeSplit` sera `false` par défaut. ::: ## build.cssTarget @@ -121,55 +121,55 @@ If you specify `build.lib`, `build.cssCodeSplit` will be `false` as default. - **Type:** `string | string[]` - **Default:** the same as [`build.target`](#build-target) -This option allows users to set a different browser target for CSS minification from the one used for JavaScript transpilation. +Cette option permet aux utilisateurs de définir une cible de navigateur différente pour la minification CSS par rapport à celle utilisée pour la transposition JavaScript. -It should only be used when you are targeting a non-mainstream browser. -One example is Android WeChat WebView, which supports most modern JavaScript features but not the [`#RGBA` hexadecimal color notation in CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#rgb_colors). -In this case, you need to set `build.cssTarget` to `chrome61` to prevent vite from transform `rgba()` colors into `#RGBA` hexadecimal notations. +Elle ne doit être utilisée que lorsque vous ciblez un navigateur non-principal. +Un exemple est le WebView Android WeChat, qui supporte la plupart des fonctionnalités JavaScript modernes mais pas la [notation hexadécimale `#RGBA` pour les couleurs CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#rgb_colors). +Dans ce cas, vous devez définir `build.cssTarget` à `chrome61` pour empêcher vite de transformer les couleurs `rgba()` en notation hexadécimale `#RGBA`. ## build.cssMinify - **Type:** `boolean | 'esbuild' | 'lightningcss'` - **Default:** the same as [`build.minify`](#build-minify) for client, `'esbuild'` for SSR -This option allows users to override CSS minification specifically instead of defaulting to `build.minify`, so you can configure minification for JS and CSS separately. Vite uses `esbuild` by default to minify CSS. Set the option to `'lightningcss'` to use [Lightning CSS](https://lightningcss.dev/minification.html) instead. If selected, it can be configured using [`css.lightningcss`](./shared-options.md#css-lightningcss). +Cette option permet aux utilisateurs de remplacer la minification CSS spécifiquement au lieu de définir `build.minify`, de sorte que vous pouvez configurer la minification pour JS et CSS séparément. Vite utilise `esbuild` par défaut pour minifier CSS. Définissez l'option sur `'lightningcss'` pour utiliser [Lightning CSS](https://lightningcss.dev/minification.html) à la place. Si sélectionné, il peut être configuré en utilisant [`css.lightningcss`](./shared-options.md#css-lightningcss). ## build.sourcemap - **Type:** `boolean | 'inline' | 'hidden'` - **Default:** `false` -Generate production source maps. If `true`, a separate sourcemap file will be created. If `'inline'`, the sourcemap will be appended to the resulting output file as a data URI. `'hidden'` works like `true` except that the corresponding sourcemap comments in the bundled files are suppressed. +Génère des sourcemap de production. Si `true`, un fichier de sourcemap distinct sera créé. Si `'inline'`, la sourcemap sera ajoutée au fichier de sortie final en tant que URI de données. `'hidden'` fonctionne comme `true` sauf que les commentaires de sourcemap correspondants dans les fichiers liés sont supprimés. ## build.rollupOptions - **Type:** [`RollupOptions`](https://rollupjs.org/configuration-options/) -Directly customize the underlying Rollup bundle. This is the same as options that can be exported from a Rollup config file and will be merged with Vite's internal Rollup options. See [Rollup options docs](https://rollupjs.org/configuration-options/) for more details. +Personnalise directement le bundle Rollup sous-jacent. C'est la même chose que les options qui peuvent être exportées d'un fichier de configuration Rollup et seront fusionnées avec les options Rollup internes de Vite. Voir [docs Rollup options](https://rollupjs.org/configuration-options/) pour plus de détails. ## build.commonjsOptions - **Type:** [`RollupCommonJSOptions`](https://github.com/rollup/plugins/tree/master/packages/commonjs#options) -Options to pass on to [@rollup/plugin-commonjs](https://github.com/rollup/plugins/tree/master/packages/commonjs). +Options à passer à [@rollup/plugin-commonjs](https://github.com/rollup/plugins/tree/master/packages/commonjs). ## build.dynamicImportVarsOptions - **Type:** [`RollupDynamicImportVarsOptions`](https://github.com/rollup/plugins/tree/master/packages/dynamic-import-vars#options) - **Related:** [Dynamic Import](/guide/features#dynamic-import) -Options to pass on to [@rollup/plugin-dynamic-import-vars](https://github.com/rollup/plugins/tree/master/packages/dynamic-import-vars). +Options à passer à [@rollup/plugin-dynamic-import-vars](https://github.com/rollup/plugins/tree/master/packages/dynamic-import-vars). ## build.lib - **Type:** `{ entry: string | string[] | { [entryAlias: string]: string }, name?: string, formats?: ('es' | 'cjs' | 'umd' | 'iife')[], fileName?: string | ((format: ModuleFormat, entryName: string) => string), cssFileName?: string }` - **Related:** [Library Mode](/guide/build#library-mode) -Build as a library. `entry` is required since the library cannot use HTML as entry. `name` is the exposed global variable and is required when `formats` includes `'umd'` or `'iife'`. Default `formats` are `['es', 'umd']`, or `['es', 'cjs']`, if multiple entries are used. +Construit comme une bibliothèque. `entry` est requis puisque la bibliothèque ne peut pas utiliser HTML comme entrée. `name` est la variable globale exposée et est requise lorsque `formats` inclut `'umd'` ou `'iife'`. Les `formats` par défaut sont `['es', 'umd']`, ou `['es', 'cjs']`, si plusieurs entrées sont utilisées. -`fileName` is the name of the package file output, which defaults to the `"name"` in `package.json`. It can also be defined as a function taking the `format` and `entryName` as arguments, and returning the file name. +`fileName` est le nom du fichier de sortie de la bibliothèque, qui par défaut est le `"name"` dans `package.json`. Il peut également être défini comme une fonction prenant le `format` et `entryName` comme arguments, et retournant le nom du fichier. -If your package imports CSS, `cssFileName` can be used to specify the name of the CSS file output. It defaults to the same value as `fileName` if it's set a string, otherwise it also falls back to the `"name"` in `package.json`. +Si votre package importe des CSS, `cssFileName` peut être utilisé pour spécifier le nom du fichier CSS de sortie. Il a par défaut la même valeur que `fileName` si c'est une chaîne, sinon il reprend `"name"` dans `package.json`. ```js twoslash [vite.config.js] import { defineConfig } from 'vite' @@ -191,9 +191,9 @@ export default defineConfig({ - **Default:** `false` - **Related:** [Backend Integration](/guide/backend-integration) -Whether to generate a manifest file that contains a mapping of non-hashed asset filenames to their hashed versions, which can then be used by a server framework to render the correct asset links. +Détermine si on génére un fichier manifeste qui contient une table de correspondance des noms de fichiers des assets (non hachés) vers leurs versions hachées, ce qui peut ensuite être utilisé par un framework de serveur pour rendre les liens corrects des assets. -When the value is a string, it will be used as the manifest file path relative to `build.outDir`. When set to `true`, the path would be `.vite/manifest.json`. +Lorsque la valeur est une chaîne, elle sera utilisée comme chemin vers le fichier manifeste par rapport à `build.outDir`. Lorsque défini sur `true`, le chemin sera `.vite/manifest.json`. ## build.ssrManifest @@ -201,9 +201,9 @@ When the value is a string, it will be used as the manifest file path relative t - **Default:** `false` - **Related:** [Server-Side Rendering](/guide/ssr) -Whether to generate a SSR manifest file for determining style links and asset preload directives in production. +Détermine si un manifeste SSR pour définir les liens de style et les directives de préchargement des assets en production. -When the value is a string, it will be used as the manifest file path relative to `build.outDir`. When set to `true`, the path would be `.vite/ssr-manifest.json`. +Lorsque la valeur est une chaîne, elle sera utilisée comme chemin vers le fichier manifeste par rapport à `build.outDir`. Lorsque défini sur `true`, le chemin sera `.vite/ssr-manifest.json`. ## build.ssr @@ -211,32 +211,32 @@ When the value is a string, it will be used as the manifest file path relative t - **Default:** `false` - **Related:** [Server-Side Rendering](/guide/ssr) -Produce SSR-oriented build. The value can be a string to directly specify the SSR entry, or `true`, which requires specifying the SSR entry via `rollupOptions.input`. +Produit un build orienté SSR. La valeur peut être une chaîne pour spécifier directement l'entrée SSR, ou `true`, qui nécessite de spécifier l'entrée SSR via `rollupOptions.input`. ## build.emitAssets - **Type:** `boolean` - **Default:** `false` -During non-client builds, static assets aren't emitted as it is assumed they would be emitted as part of the client build. This option allows frameworks to force emitting them in other environments build. It is responsibility of the framework to merge the assets with a post build step. +Lors de la construction non-client, les assets statiques ne sont pas émis car il est supposé qu'ils seraient émis comme partie du build client. Cette option permet aux frameworks de forcer leur émission dans d'autres environnements de construction. Il est de la responsabilité du framework de fusionner les assets avec une étape de post-construction. ## build.ssrEmitAssets - **Type:** `boolean` - **Default:** `false` -During the SSR build, static assets aren't emitted as it is assumed they would be emitted as part of the client build. This option allows frameworks to force emitting them in both the client and SSR build. It is responsibility of the framework to merge the assets with a post build step. This option will be replaced by `build.emitAssets` once Environment API is stable. +Lors de la construction SSR, les assets statiques ne sont pas émis car il est supposé qu'ils seraient émis comme partie du build client. Cette option permet aux frameworks de forcer leur émission dans les builds client et SSR. Il est de la responsabilité du framework de fusionner les assets avec une étape de post-construction. Cette option sera remplacée par `build.emitAssets` une fois que l'API Environment sera stable. ## build.minify - **Type:** `boolean | 'terser' | 'esbuild'` - **Default:** `'esbuild'` for client build, `false` for SSR build -Set to `false` to disable minification, or specify the minifier to use. The default is [esbuild](https://github.com/evanw/esbuild) which is 20 ~ 40x faster than terser and only 1 ~ 2% worse compression. [Benchmarks](https://github.com/privatenumber/minification-benchmarks) +Définissez sur `false` pour désactiver la minification, ou spécifiez le minificateur à utiliser. La valeur par défaut est [esbuild](https://github.com/evanw/esbuild) qui est 20 ~ 40x plus rapide que terser et seulement 1 ~ 2% moins compressé. [Benchmarks](https://github.com/privatenumber/minification-benchmarks) -Note the `build.minify` option does not minify whitespaces when using the `'es'` format in lib mode, as it removes pure annotations and breaks tree-shaking. +Notez que l'option `build.minify` ne minifie pas les espaces blancs lors de l'utilisation du format `'es'` dans le mode bibliothèque, car il supprime les annotations pures et casse le tree-shaking. -Terser must be installed when it is set to `'terser'`. +Terser doit être installé lorsque c'est défini sur `'terser'`. ```sh npm add -D terser @@ -246,55 +246,55 @@ npm add -D terser - **Type:** `TerserOptions` -Additional [minify options](https://terser.org/docs/api-reference#minify-options) to pass on to Terser. +Options supplémentaires [minify options](https://terser.org/docs/api-reference#minify-options) à passer à Terser. -In addition, you can also pass a `maxWorkers: number` option to specify the max number of workers to spawn. Defaults to the number of CPUs minus 1. +Vous pouvez également passer une option `maxWorkers: number` pour spécifier le nombre maximum de workers à lancer. Par défaut, le nombre de CPU moins 1. ## build.write - **Type:** `boolean` - **Default:** `true` -Set to `false` to disable writing the bundle to disk. This is mostly used in [programmatic `build()` calls](/guide/api-javascript#build) where further post processing of the bundle is needed before writing to disk. +Définissez sur `false` pour désactiver l'écriture du bundle sur le disque. Cette option est principalement utilisée dans les [appels programmatiques `build()`](/guide/api-javascript#build) où une post-traitement supplémentaire du bundle est nécessaire avant l'écriture sur le disque. ## build.emptyOutDir - **Type:** `boolean` - **Default:** `true` if `outDir` is inside `root` -By default, Vite will empty the `outDir` on build if it is inside project root. It will emit a warning if `outDir` is outside of root to avoid accidentally removing important files. You can explicitly set this option to suppress the warning. This is also available via command line as `--emptyOutDir`. +Par défaut, Vite videra le `outDir` lors de la construction si c'est à l'intérieur du projet racine. Il émettra un avertissement si `outDir` est en dehors de la racine pour éviter de supprimer accidentellement des fichiers importants. Vous pouvez explicitement définir cette option pour supprimer l'avertissement. Cette option est également disponible via la ligne de commande avec `--emptyOutDir`. ## build.copyPublicDir - **Type:** `boolean` - **Default:** `true` -By default, Vite will copy files from the `publicDir` into the `outDir` on build. Set to `false` to disable this. +Par défaut, Vite copiera les fichiers du `publicDir` dans le `outDir` lors de la construction. Définissez sur `false` pour désactiver cela. ## build.reportCompressedSize - **Type:** `boolean` - **Default:** `true` -Enable/disable gzip-compressed size reporting. Compressing large output files can be slow, so disabling this may increase build performance for large projects. +Active/désactive le rapport de taille compressée gzip. Compresser les gros fichiers de sortie peut être lent, donc désactiver cela peut augmenter les performances de build pour les gros projets. ## build.chunkSizeWarningLimit - **Type:** `number` - **Default:** `500` -Limit for chunk size warnings (in kB). It is compared against the uncompressed chunk size as the [JavaScript size itself is related to the execution time](https://v8.dev/blog/cost-of-javascript-2019). +Limite pour les avertissements de taille de chunk (en kB). Il est comparé à la taille du chunk non compressé car la [taille du JavaScript elle-même est liée au temps d'exécution](https://v8.dev/blog/cost-of-javascript-2019). ## build.watch - **Type:** [`WatcherOptions`](https://rollupjs.org/configuration-options/#watch)`| null` - **Default:** `null` -Set to `{}` to enable rollup watcher. This is mostly used in cases that involve build-only plugins or integrations processes. +Définissez sur `{}` pour activer le watcher Rollup. Cette option est principalement utilisée dans les cas impliquant des plugins ou des processus de build uniquement. -::: warning Using Vite on Windows Subsystem for Linux (WSL) 2 +::: warning Utilisation de Vite sur Windows Subsystem pour Linux (WSL) 2 -There are cases that file system watching does not work with WSL2. -See [`server.watch`](./server-options.md#server-watch) for more details. +Il existe des cas où le système de fichier ne fonctionne pas avec WSL2. +Voir [`server.watch`](./server-options.md#server-watch) pour plus de détails. ::: From dbb008573c7a44af2fc607f95b61a4016cd85c9f Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 21:45:34 +0100 Subject: [PATCH 20/40] traduction de worker-options --- docs/config/worker-options.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/config/worker-options.md b/docs/config/worker-options.md index 91edfe1..be175e6 100644 --- a/docs/config/worker-options.md +++ b/docs/config/worker-options.md @@ -1,23 +1,22 @@ -# Worker Options +# Options du Worker -Unless noted, the options in this section are applied to all dev, build, and preview. +Sauf mention contraire, les options de cette section s'appliquent à tous les dev, build et preview. ## worker.format - **Type:** `'es' | 'iife'` - **Default:** `'iife'` -Output format for worker bundle. +Format de sortie pour le bundle du worker. ## worker.plugins - **Type:** [`() => (Plugin | Plugin[])[]`](./shared-options#plugins) -Vite plugins that apply to the worker bundles. Note that [config.plugins](./shared-options#plugins) only applies to workers in dev, it should be configured here instead for build. -The function should return new plugin instances as they are used in parallel rollup worker builds. As such, modifying `config.worker` options in the `config` hook will be ignored. +Plugins Vite qui s'appliquent aux bundles du worker. Notez que [config.plugins](./shared-options#plugins) ne s'applique qu'aux workers en mode dev, il doit être configuré ici à la place pour le build. La fonction doit retourner des nouvelles instances de plugin comme elles sont utilisées dans les constructions parallèles du worker Rollup. Ainsi, modifier les options `config.worker` dans le hook `config` sera ignoré. ## worker.rollupOptions - **Type:** [`RollupOptions`](https://rollupjs.org/configuration-options/) -Rollup options to build worker bundle. +Options Rollup pour construire le bundle du worker. From c5437521957f6b4a9fa0ae534458e43350133a5b Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Mon, 17 Mar 2025 21:48:24 +0100 Subject: [PATCH 21/40] traduction de plugins --- docs/plugins/index.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/plugins/index.md b/docs/plugins/index.md index 76eef57..5bfd4d2 100644 --- a/docs/plugins/index.md +++ b/docs/plugins/index.md @@ -1,45 +1,45 @@ # Plugins :::tip NOTE -Vite aims to provide out-of-the-box support for common web development patterns. Before searching for a Vite or Compatible Rollup plugin, check out the [Features Guide](../guide/features.md). A lot of the cases where a plugin would be needed in a Rollup project are already covered in Vite. +Vite fournit un support intégré pour les cas de figure courants de développement web. Avant de rechercher un plugin Vite ou compatible avec Rollup, consultez le [Guide des fonctionnalités](../guide/features.md). La plupart des cas où un plugin serait nécessaire dans un projet Rollup sont déjà couverts dans Vite. ::: -Check out [Using Plugins](../guide/using-plugins) for information on how to use plugins. +Consultez le [Guide sur l'utilisation des plugins](../guide/using-plugins) pour plus d'informations sur l'utilisation des plugins. -## Official Plugins +## Plugins officiels ### [@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue) -- Provides Vue 3 Single File Components support. +- Fournit le support des composants de fichier unique Vue 3. ### [@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) -- Provides Vue 3 JSX support (via [dedicated Babel transform](https://github.com/vuejs/jsx-next)). +- Fournit le support des JSX Vue 3 (via [transformateur Babel dédié](https://github.com/vuejs/jsx-next)). ### [@vitejs/plugin-vue2](https://github.com/vitejs/vite-plugin-vue2) -- Provides Vue 2.7 Single File Components support. +- Fournit le support des composants de fichier unique Vue 2.7. ### [@vitejs/plugin-vue2-jsx](https://github.com/vitejs/vite-plugin-vue2-jsx) -- Provides Vue 2.7 JSX support (via [dedicated Babel transform](https://github.com/vuejs/jsx-vue2/)). +- Fournit le support des JSX Vue 2.7 (via [transformateur Babel dédié](https://github.com/vuejs/jsx-vue2/)). ### [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-react) -- Uses esbuild and Babel, achieving fast HMR with a small package footprint and the flexibility of being able to use the Babel transform pipeline. Without additional Babel plugins, only esbuild is used during builds. +- Utilise esbuild et Babel, atteignant un HMR rapide avec une faible empreinte de package et la flexibilité de pouvoir utiliser le pipeline de transformation Babel. Sans plugins Babel supplémentaires, seul esbuild est utilisé lors des builds. ### [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) -- Replaces Babel with SWC during development. During production builds, SWC+esbuild are used when using plugins, and esbuild only otherwise. For big projects that don't require non-standard React extensions, cold start and Hot Module Replacement (HMR) can be significantly faster. +- Remplace Babel par SWC lors du développement. Lors des builds en production, SWC+esbuild sont utilisés lorsque des plugins sont utilisés, et esbuild seulement sinon. Pour les gros projets qui n'ont pas besoin d'extensions React non standard, le démarrage froid et le Hot Module Replacement (HMR) peuvent être significativement plus rapides. ### [@vitejs/plugin-legacy](https://github.com/vitejs/vite/tree/main/packages/plugin-legacy) -- Provides legacy browsers support for the production build. +- Fournit le support des navigateurs obsolètes pour le build en production. -## Community Plugins +## Plugins de la communauté -Check out [awesome-vite](https://github.com/vitejs/awesome-vite#plugins) - you can also submit a PR to list your plugins there. +Consultez [awesome-vite](https://github.com/vitejs/awesome-vite#plugins) - vous pouvez également soumettre une PR pour lister vos plugins là-bas. -## Rollup Plugins +## Plugins Rollup -[Vite plugins](../guide/api-plugin) are an extension of Rollup's plugin interface. Check out the [Rollup Plugin Compatibility section](../guide/api-plugin#rollup-plugin-compatibility) for more information. +Les [plugins Vite](../guide/api-plugin) sont une extension de l'interface de plugin Rollup. Consultez la section [Compatibilité des plugins Rollup](../guide/api-plugin#compatibilité-des-plugins-rollup) pour plus d'informations. From 01346caf8153400da3ba077f3e802b50f7758107 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Tue, 25 Mar 2025 20:20:06 +0100 Subject: [PATCH 22/40] traduction de ssr-options --- docs/config/ssr-options.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/config/ssr-options.md b/docs/config/ssr-options.md index 0d64c4d..0b1ba1f 100644 --- a/docs/config/ssr-options.md +++ b/docs/config/ssr-options.md @@ -1,35 +1,35 @@ -# SSR Options +# Options SSR -Unless noted, the options in this section are applied to both dev and build. +Sauf mention contraire, les options de cette section s'appliquent à build et preview. ## ssr.external - **Type:** `string[] | true` - **Related:** [SSR Externals](/guide/ssr#ssr-externals) -Externalize the given dependencies and their transitive dependencies for SSR. By default, all dependencies are externalized except for linked dependencies (for HMR). If you prefer to externalize the linked dependency, you can pass its name to this option. +Externalise les dépendances données et leurs dépendances transitives pour SSR. Par défaut, toutes les dépendances sont externalisées sauf les dépendances liées (pour HMR). Si vous préférez externaliser la dépendance liée, vous pouvez passer son nom à cette option. -If `true`, all dependencies including linked dependencies are externalized. +Si `true`, toutes les dépendances, y compris les dépendances liées, sont externalisées. -Note that the explicitly listed dependencies (using `string[]` type) will always take priority if they're also listed in `ssr.noExternal` (using any type). +Note que les dépendances explicitement listées (en utilisant le type `string[]`) prendront toujours la priorité si elles sont également listées dans `ssr.noExternal` (en utilisant n'importe quel type). ## ssr.noExternal - **Type:** `string | RegExp | (string | RegExp)[] | true` - **Related:** [SSR Externals](/guide/ssr#ssr-externals) -Prevent listed dependencies from being externalized for SSR, which they will get bundled in build. By default, only linked dependencies are not externalized (for HMR). If you prefer to externalize the linked dependency, you can pass its name to the `ssr.external` option. +Empêche les dépendances listées d'être externalisées pour le SSR, qui seront bundlées dans build. Par défaut, seules les dépendances liées ne sont pas externalisées (pour HMR). Si vous préférez externaliser la dépendance liée, vous pouvez passer son nom à l'option `ssr.external`. -If `true`, no dependencies are externalized. However, dependencies explicitly listed in `ssr.external` (using `string[]` type) can take priority and still be externalized. If `ssr.target: 'node'` is set, Node.js built-ins will also be externalized by default. +Si `true`, aucune dépendance n'est externalisée. Cependant, les dépendances explicitement listées dans `ssr.external` (en utilisant le type `string[]`) peuvent prendre la priorité et être externalisées. Si `ssr.target: 'node'` est configuré, les dépendances intégrées de Node.js seront également externalisées par défaut. -Note that if both `ssr.noExternal: true` and `ssr.external: true` are configured, `ssr.noExternal` takes priority and no dependencies are externalized. +Note que si `ssr.noExternal: true` et `ssr.external: true` sont configurés, `ssr.noExternal` prendra la priorité et aucune dépendance ne sera externalisée. ## ssr.target - **Type:** `'node' | 'webworker'` - **Default:** `node` -Build target for the SSR server. +Cible de build pour le serveur SSR. ## ssr.resolve.conditions @@ -37,20 +37,20 @@ Build target for the SSR server. - **Default:** `['module', 'node', 'development|production']` (`defaultServerConditions`) (`['module', 'browser', 'development|production']` (`defaultClientConditions`) for `ssr.target === 'webworker'`) - **Related:** [Resolve Conditions](./shared-options.md#resolve-conditions) -These conditions are used in the plugin pipeline, and only affect non-externalized dependencies during the SSR build. Use `ssr.resolve.externalConditions` to affect externalized imports. +Ces conditions sont utilisées dans le pipeline de plugin, et ne s'appliquent qu'aux dépendances non externalisées lors du build SSR. Utilisez `ssr.resolve.externalConditions` pour affecter les imports externalisés. ## ssr.resolve.externalConditions - **Type:** `string[]` - **Default:** `['node']` -Conditions that are used during ssr import (including `ssrLoadModule`) of externalized direct dependencies (external dependencies imported by Vite). +Conditions utilisées lors de l'importation SSR (y compris `ssrLoadModule`) des dépendances directes externalisées (dépendances externalisées importées par Vite). :::tip -When using this option, make sure to run Node with [`--conditions` flag](https://nodejs.org/docs/latest/api/cli.html#-c-condition---conditionscondition) with the same values in both dev and build to get a consistent behavior. +Lorsque vous utilisez cette option, assurez-vous de lancer Node avec le [flag `--conditions`](https://nodejs.org/docs/latest/api/cli.html#-c-condition---conditionscondition) avec les mêmes valeurs dans les deux environnements de développement et de build pour obtenir un comportement cohérent. -For example, when setting `['node', 'custom']`, you should run `NODE_OPTIONS='--conditions custom' vite` in dev and `NODE_OPTIONS="--conditions custom" node ./dist/server.js` after build. +Par exemple, lorsque vous définissez `['node', 'custom']`, vous devez lancer `NODE_OPTIONS='--conditions custom' vite` dans l'environnement de développement et `NODE_OPTIONS="--conditions custom" node ./dist/server.js` après le build. ::: @@ -59,4 +59,4 @@ For example, when setting `['node', 'custom']`, you should run `NODE_OPTIONS='-- - **Type:** `string[]` - **Default:** `['module', 'jsnext:main', 'jsnext']` -List of fields in `package.json` to try when resolving a package's entry point. Note this takes lower precedence than conditional exports resolved from the `exports` field: if an entry point is successfully resolved from `exports`, the main field will be ignored. This setting only affect non-externalized dependencies. +Liste des champs dans `package.json` à essayer lors de la résolution du point d'entrée d'un package. Notez que cela prend une priorité inférieure aux exports conditionnels résolus à partir du champ `exports` : si un point d'entrée est résolu avec succès à partir de `exports`, le champ principal sera ignoré. Cette configuration ne s'applique qu'aux dépendances non externalisées. From e94598851000e7d1525e7954a7629a875718c62d Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 15:29:07 +0200 Subject: [PATCH 23/40] traduction de shared options --- docs/config/shared-options.md | 88 +++++++++++++++++------------------ 1 file changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/config/shared-options.md b/docs/config/shared-options.md index 592818c..f202d11 100644 --- a/docs/config/shared-options.md +++ b/docs/config/shared-options.md @@ -1,15 +1,15 @@ -# Shared Options +# Options partagées -Unless noted, the options in this section are applied to all dev, build, and preview. +Sauf mention contraire, les options de cette section s'appliquent à tous les dev, build et preview. ## root - **Type:** `string` - **Default:** `process.cwd()` -Project root directory (where `index.html` is located). Can be an absolute path, or a path relative to the current working directory. +Répertoire racine du projet (où `index.html` est situé). Peut être un chemin absolu, ou un chemin relatif au répertoire de travail actuel. -See [Project Root](/guide/#index-html-and-project-root) for more details. +Voir [Racine du projet](/guide/#index-html-and-project-root) pour plus de détails. ## base @@ -17,30 +17,30 @@ See [Project Root](/guide/#index-html-and-project-root) for more details. - **Default:** `/` - **Related:** [`server.origin`](/config/server-options.md#server-origin) -Base public path when served in development or production. Valid values include: +Chemin public de base lorsque le serveur est mode de développement ou de production. Les valeurs valides incluent : -- Absolute URL pathname, e.g. `/foo/` -- Full URL, e.g. `https://bar.com/foo/` (The origin part won't be used in development so the value is the same as `/foo/`) -- Empty string or `./` (for embedded deployment) +- Chemin URL absolu, e.g. `/foo/` +- URL complète, e.g. `https://bar.com/foo/` (La partie origin ne sera pas utilisée dans le développement, donc la valeur est la même que `/foo/`) +- Chaîne vide ou `./` (pour le déploiement incorporé) -See [Public Base Path](/guide/build#public-base-path) for more details. +Voir [Public Base Path](/guide/build#public-base-path) pour plus de détails. ## mode - **Type:** `string` -- **Default:** `'development'` for serve, `'production'` for build +- **Default:** `'development'` pour serve, `'production'` pour build -Specifying this in config will override the default mode for **both serve and build**. This value can also be overridden via the command line `--mode` option. +Spécifier cette option dans la configuration remplacera le mode par défaut pour **serve et build**. Cette valeur peut également être remplacée via l'option de ligne de commande `--mode`. -See [Env Variables and Modes](/guide/env-and-mode) for more details. +Voir [Env Variables and Modes](/guide/env-and-mode) pour plus de détails. ## define - **Type:** `Record` -Define global constant replacements. Entries will be defined as globals during dev and statically replaced during build. +Définir les remplacements de constantes globales. Les entrées seront définies comme globals pendant le développement et statiquement remplacés pendant le build. -Vite uses [esbuild defines](https://esbuild.github.io/api/#define) to perform replacements, so value expressions must be a string that contains a JSON-serializable value (null, boolean, number, string, array, or object) or a single identifier. For non-string values, Vite will automatically convert it to a string with `JSON.stringify`. +Vite utilise [esbuild defines](https://esbuild.github.io/api/#define) pour effectuer les remplacements, donc les expressions de valeur doivent être une chaîne qui contient une valeur JSON-sérialisable (null, boolean, number, string, array, ou object) ou un identifiant unique. Pour les valeurs non-string, Vite convertira automatiquement en une chaîne avec `JSON.stringify`. **Example:** @@ -54,9 +54,9 @@ export default defineConfig({ ``` ::: tip NOTE -For TypeScript users, make sure to add the type declarations in the `env.d.ts` or `vite-env.d.ts` file to get type checks and Intellisense. +Pour les utilisateurs TypeScript, assurez-vous de rajouter les déclarations de type dans le fichier `env.d.ts` ou `vite-env.d.ts` pour obtenir des vérifications de type et un Intellisense. -Example: +Exemple: ```ts // vite-env.d.ts @@ -69,49 +69,49 @@ declare const __APP_VERSION__: string - **Type:** `(Plugin | Plugin[] | Promise)[]` -Array of plugins to use. Falsy plugins are ignored and arrays of plugins are flattened. If a promise is returned, it would be resolved before running. See [Plugin API](/guide/api-plugin) for more details on Vite plugins. +Tableau de plugins à utiliser. Les plugins non valides sont ignorés et les tableaux de plugins sont aplatis. Si une promesse est renvoyée, elle sera résolue avant d'exécuter. Voir [API Plugin](/guide/api-plugin) pour plus de détails sur les plugins Vite. ## publicDir - **Type:** `string | false` - **Default:** `"public"` -Directory to serve as plain static assets. Files in this directory are served at `/` during dev and copied to the root of `outDir` during build, and are always served or copied as-is without transform. The value can be either an absolute file system path or a path relative to project root. +Répertoire à servir en tant que ressources statiques pures. Les fichiers dans ce répertoire sont servis à `/` pendant le développement et copiés dans le répertoire racine de `outDir` pendant le build, et sont toujours servis ou copiés tel quel sans transformation. La valeur peut être un chemin absolu du système de fichiers ou un chemin relatif au répertoire racine du projet. -Defining `publicDir` as `false` disables this feature. +Définir `publicDir` comme `false` désactive cette fonctionnalité. -See [The `public` Directory](/guide/assets#the-public-directory) for more details. +Voir [Le répertoire `public`](/guide/assets#the-public-directory) pour plus de détails. ## cacheDir - **Type:** `string` - **Default:** `"node_modules/.vite"` -Directory to save cache files. Files in this directory are pre-bundled deps or some other cache files generated by vite, which can improve the performance. You can use `--force` flag or manually delete the directory to regenerate the cache files. The value can be either an absolute file system path or a path relative to project root. Default to `.vite` when no package.json is detected. +Répertoire où enregistrer les fichiers de cache. Les fichiers dans ce répertoire sont des dépendances pré-bundlées ou d'autres fichiers de cache générés par Vite, ce qui peut améliorer les performances. Vous pouvez utiliser l'argument `--force` ou supprimer manuellement le répertoire pour régénérer les fichiers de cache. La valeur peut être un chemin absolu du système de fichiers ou un chemin relatif au répertoire racine du projet. Par défaut à `.vite` lorsque aucun `package.json` n'est détecté. ## resolve.alias - **Type:** `Record | Array<{ find: string | RegExp, replacement: string, customResolver?: ResolverFunction | ResolverObject }>` -Will be passed to `@rollup/plugin-alias` as its [entries option](https://github.com/rollup/plugins/tree/master/packages/alias#entries). Can either be an object, or an array of `{ find, replacement, customResolver }` pairs. +Sera passé à l'option `entries` de `@rollup/plugin-alias`. Peut être un objet ou un tableau de paires `{ find, replacement, customResolver }`. -When aliasing to file system paths, always use absolute paths. Relative alias values will be used as-is and will not be resolved into file system paths. +Lors de l'aliasisation vers des chemins de système de fichiers, utilisez toujours des chemins absolus. Les alias relatifs seront utilisés tels quels et ne seront pas résolus en chemins de système de fichiers. -More advanced custom resolution can be achieved through [plugins](/guide/api-plugin). +Des résolutions plus avancées peuvent être obtenues via [plugins](/guide/api-plugin). -::: warning Using with SSR -If you have configured aliases for [SSR externalized dependencies](/guide/ssr.md#ssr-externals), you may want to alias the actual `node_modules` packages. Both [Yarn](https://classic.yarnpkg.com/en/docs/cli/add/#toc-yarn-add-alias) and [pnpm](https://pnpm.io/aliases/) support aliasing via the `npm:` prefix. +::: warning Utilisation avec SSR +Si vous avez configuré des alias pour [dépendances externalisées SSR](/guide/ssr.md#ssr-externals), vous souhaiterez peut-être aliaser les packages `node_modules` réels. Les alias sont supportés via le préfixe `npm:` pour [Yarn](https://classic.yarnpkg.com/en/docs/cli/add/#toc-yarn-add-alias) et [pnpm](https://pnpm.io/aliases/). ::: ## resolve.dedupe - **Type:** `string[]` -If you have duplicated copies of the same dependency in your app (likely due to hoisting or linked packages in monorepos), use this option to force Vite to always resolve listed dependencies to the same copy (from project root). +Si vous avez des copies en double de la même dépendance dans votre application (probablement due à l'hoisting ou aux packages liés dans des monorepos), utilisez cette option pour forcer Vite à résoudre toujours les dépendances listées vers la même copie (depuis le répertoire racine du projet). :::warning SSR + ESM -For SSR builds, deduplication does not work for ESM build outputs configured from `build.rollupOptions.output`. A workaround is to use CJS build outputs until ESM has better plugin support for module loading. +Pour les builds SSR, la déduplication ne fonctionne pas pour les sorties de build ESM configurées à partir de `build.rollupOptions.output`. Une solution de contournement est d'utiliser les sorties de build CJS jusqu'à ce que ESM ait de meilleures fonctionnalités de plugin pour le chargement des modules. ::: ## resolve.conditions @@ -119,9 +119,9 @@ For SSR builds, deduplication does not work for ESM build outputs configured fro - **Type:** `string[]` - **Default:** `['module', 'browser', 'development|production']` (`defaultClientConditions`) -Additional allowed conditions when resolving [Conditional Exports](https://nodejs.org/api/packages.html#packages_conditional_exports) from a package. +Conditions supplémentaires autorisées lors de la résolution de [Conditional Exports](https://nodejs.org/api/packages.html#packages_conditional_exports) d'un package. -A package with conditional exports may have the following `exports` field in its `package.json`: +Un package avec des exports conditionnels peut avoir le champ `exports` suivant dans son `package.json`: ```json { @@ -134,42 +134,42 @@ A package with conditional exports may have the following `exports` field in its } ``` -Here, `import` and `require` are "conditions". Conditions can be nested and should be specified from most specific to least specific. +Ici, `import` et `require` sont des "conditions". Les conditions peuvent être imbriquées et doivent être spécifiées de la plus spécifique à la moins spécifique. -`development|production` is a special value that is replaced with `production` or `development` depending on the value of `process.env.NODE_ENV`. It is replaced with `production` when `process.env.NODE_ENV === 'production'` and `development` otherwise. +`development|production` est une valeur spéciale qui est remplacée par `production` ou `development` en fonction de la valeur de `process.env.NODE_ENV`. Elle est remplacée par `production` lorsque `process.env.NODE_ENV === 'production'` et par `development` dans les autres cas. -Note that `import`, `require`, `default` conditions are always applied if the requirements are met. +Note que les conditions `import`, `require`, `default` sont toujours appliquées si les conditions sont remplies. ## resolve.mainFields - **Type:** `string[]` - **Default:** `['browser', 'module', 'jsnext:main', 'jsnext']` (`defaultClientMainFields`) -List of fields in `package.json` to try when resolving a package's entry point. Note this takes lower precedence than conditional exports resolved from the `exports` field: if an entry point is successfully resolved from `exports`, the main field will be ignored. +Liste des champs dans `package.json` à essayer lors de la résolution du point d'entrée d'un package. Notez que cela prend une priorité inférieure aux exports conditionnels résolus à partir du champ `exports` : si un point d'entrée est résolu avec succès à partir de `exports`, le champ principal sera ignoré. ## resolve.extensions - **Type:** `string[]` - **Default:** `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']` -List of file extensions to try for imports that omit extensions. Note it is **NOT** recommended to omit extensions for custom import types (e.g. `.vue`) since it can interfere with IDE and type support. +Liste des extensions de fichiers à essayer pour les imports qui omettent les extensions. Notez que cela n'est **PAS** recommandé pour les types d'importation personnalisés (e.g. `.vue`) puisqu'il peut interférer avec le support IDE et le type. ## resolve.preserveSymlinks - **Type:** `boolean` - **Default:** `false` -Enabling this setting causes vite to determine file identity by the original file path (i.e. the path without following symlinks) instead of the real file path (i.e. the path after following symlinks). +Lorsque cette option est activée, Vite détermine l'identité du fichier par le chemin du fichier original (i.e. le chemin sans suivre les liens symboliques) plutôt que le chemin du fichier réel (i.e. le chemin après suivi des liens symboliques). -- **Related:** [esbuild#preserve-symlinks](https://esbuild.github.io/api/#preserve-symlinks), [webpack#resolve.symlinks +- **Lié:** [esbuild#preserve-symlinks](https://esbuild.github.io/api/#preserve-symlinks), [webpack#resolve.symlinks ](https://webpack.js.org/configuration/resolve/#resolvesymlinks) ## html.cspNonce - **Type:** `string` -- **Related:** [Content Security Policy (CSP)](/guide/features#content-security-policy-csp) +- **Lié:** [Content Security Policy (CSP)](/guide/features#content-security-policy-csp) -A nonce value placeholder that will be used when generating script / style tags. Setting this value will also generate a meta tag with nonce value. +Une valeur de nonce à placer lors de la génération de balises de script / style. Définir cette valeur générera également une balise meta avec la valeur de nonce. ## css.modules @@ -204,19 +204,19 @@ A nonce value placeholder that will be used when generating script / style tags. } ``` -Configure CSS modules behavior. The options are passed on to [postcss-modules](https://github.com/css-modules/postcss-modules). +Configure le comportement des modules CSS. Les options sont passées à [postcss-modules](https://github.com/css-modules/postcss-modules). -This option doesn't have any effect when using [Lightning CSS](../guide/features.md#lightning-css). If enabled, [`css.lightningcss.cssModules`](https://lightningcss.dev/css-modules.html) should be used instead. +Cette option n'a aucun effet lors de l'utilisation de [Lightning CSS](../guide/features.md#lightning-css). Si activé, [`css.lightningcss.cssModules`](https://lightningcss.dev/css-modules.html) doit être utilisé à la place. ## css.postcss - **Type:** `string | (postcss.ProcessOptions & { plugins?: postcss.AcceptedPlugin[] })` -Inline PostCSS config or a custom directory to search PostCSS config from (default is project root). +Configuration PostCSS en inline ou un répertoire personnalisé pour rechercher la configuration PostCSS (par défaut est le répertoire racine du projet). -For inline PostCSS config, it expects the same format as `postcss.config.js`. But for `plugins` property, only [array format](https://github.com/postcss/postcss-load-config/blob/main/README.md#array) can be used. +Pour la configuration PostCSS inline, il attend le même format que `postcss.config.js`. Mais pour la propriété `plugins`, seul le [format de tableau](https://github.com/postcss/postcss-load-config/blob/main/README.md#array) peut être utilisé. -The search is done using [postcss-load-config](https://github.com/postcss/postcss-load-config) and only the supported config file names are loaded. Config files outside the workspace root (or the [project root](/guide/#index-html-and-project-root) if no workspace is found) are not searched by default. You can specify a custom path outside of the root to load the specific config file instead if needed. +La recherche est faite en utilisant [postcss-load-config](https://github.com/postcss/postcss-load-config) et seuls les noms de fichiers de configuration pris en charge sont chargés. Les fichiers de configuration en dehors du répertoire racine du projet (ou du [répertoire racine du projet](/guide/#index-html-and-project-root) si aucun espace de travail n'est trouvé) ne sont pas recherchés par défaut. Vous pouvez spécifier un chemin personnalisé en dehors de la racine pour charger le fichier de configuration spécifique si nécessaire. Note if an inline config is provided, Vite will not search for other PostCSS config sources. From 31e2f6d8ea819f71e5a000fdbfb569347a15b0fd Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 15:29:44 +0200 Subject: [PATCH 24/40] traduction de dep optimization options --- docs/config/dep-optimization-options.md | 66 ++++++++++++------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/docs/config/dep-optimization-options.md b/docs/config/dep-optimization-options.md index 70d338a..3323fdf 100644 --- a/docs/config/dep-optimization-options.md +++ b/docs/config/dep-optimization-options.md @@ -1,25 +1,25 @@ -# Dep Optimization Options +# Options d'optimisation de dépendances -- **Related:** [Dependency Pre-Bundling](/guide/dep-pre-bundling) +- **Connexe :** [Pré-building des dépendances](/guide/dep-pre-bundling) -Unless noted, the options in this section are only applied to the dependency optimizer, which is only used in dev. +Sauf mention contraire, les options de cette section ne s'appliquent qu'à l'optimiseur de dépendances, qui n'est utilisé qu'en développement. ## optimizeDeps.entries -- **Type:** `string | string[]` +- **Type :** `string | string[]` -By default, Vite will crawl all your `.html` files to detect dependencies that need to be pre-bundled (ignoring `node_modules`, `build.outDir`, `__tests__` and `coverage`). If `build.rollupOptions.input` is specified, Vite will crawl those entry points instead. +Par défaut, Vite parcourt tous vos fichiers `.html` pour détecter les dépendances qui doivent être pré-buildé (en ignorant `node_modules`, `build.outDir`, `__tests__` et `coverage`). Si `build.rollupOptions.input` est spécifié, Vite parcourra ces points d'entrée à la place. -If neither of these fit your needs, you can specify custom entries using this option - the value should be a [`tinyglobby` pattern](https://github.com/SuperchupuDev/tinyglobby) or array of patterns that are relative from Vite project root. This will overwrite default entries inference. Only `node_modules` and `build.outDir` folders will be ignored by default when `optimizeDeps.entries` is explicitly defined. If other folders need to be ignored, you can use an ignore pattern as part of the entries list, marked with an initial `!`. If you don't want to ignore `node_modules` and `build.outDir`, you can specify using literal string paths (without `tinyglobby` patterns) instead. +Si aucune de ces options ne correspond à vos besoins, vous pouvez spécifier des entrées personnalisées en utilisant cette option - la valeur doit être un [modèle `tinyglobby`](https://github.com/SuperchupuDev/tinyglobby) ou un tableau de pattern relatifs à la racine du projet Vite. Cela écrasera l'inférence d'entrées par défaut. Seuls les dossiers `node_modules` et `build.outDir` seront ignorés par défaut lorsque `optimizeDeps.entries` est explicitement défini. Si d'autres dossiers doivent être ignorés, vous pouvez utiliser un modèle d'ignore dans la liste des entrées, marqué par un `!` initial. Si vous ne souhaitez pas ignorer `node_modules` et `build.outDir`, vous pouvez spécifier en utilisant des chemins de chaînes littérales (sans pattern `tinyglobby`) à la place. ## optimizeDeps.exclude -- **Type:** `string[]` +- **Type :** `string[]` -Dependencies to exclude from pre-bundling. +Dépendances à exclure du pré-building. :::warning CommonJS -CommonJS dependencies should not be excluded from optimization. If an ESM dependency is excluded from optimization, but has a nested CommonJS dependency, the CommonJS dependency should be added to `optimizeDeps.include`. Example: +Les dépendances CommonJS ne doivent pas être exclues de l'optimisation. Si une dépendance ESM est exclue de l'optimisation, mais possède une dépendance CommonJS imbriquée, la dépendance CommonJS doit être ajoutée à `optimizeDeps.include`. Exemple : ```js twoslash import { defineConfig } from 'vite' @@ -35,11 +35,11 @@ export default defineConfig({ ## optimizeDeps.include -- **Type:** `string[]` +- **Type :** `string[]` -By default, linked packages not inside `node_modules` are not pre-bundled. Use this option to force a linked package to be pre-bundled. +Par défaut, les packages liés qui ne sont pas dans `node_modules` ne sont pas pré-buildés. Utilisez cette option pour forcer un package lié à être pré-buildés. -**Experimental:** If you're using a library with many deep imports, you can also specify a trailing glob pattern to pre-bundle all deep imports at once. This will avoid constantly pre-bundling whenever a new deep import is used. [Give Feedback](https://github.com/vitejs/vite/discussions/15833). For example: +**Expérimental :** Si vous utilisez une bibliothèque avec de nombreux imports profonds, vous pouvez également spécifier un modèle glob à la fin pour pré-builder toutes les importations profondes en une seule fois. Cela évitera de constamment pré-builder chaque fois qu'un nouvel importat profond est utilisé. [Donnez votre avis](https://github.com/vitejs/vite/discussions/15833). Par exemple : ```js twoslash import { defineConfig } from 'vite' @@ -53,7 +53,7 @@ export default defineConfig({ ## optimizeDeps.esbuildOptions -- **Type:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`[`EsbuildBuildOptions`](https://esbuild.github.io/api/#general-options)`, +- **Type :** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`[`EsbuildBuildOptions`](https://esbuild.github.io/api/#general-options)`, | 'bundle' | 'entryPoints' | 'external' @@ -65,45 +65,45 @@ export default defineConfig({ | 'outExtension' | 'metafile'>` -Options to pass to esbuild during the dep scanning and optimization. +Options à transmettre à esbuild pendant l'analyse et l'optimisation des dépendances. -Certain options are omitted since changing them would not be compatible with Vite's dep optimization. +Certaines options sont omises car leur modification ne serait pas compatible avec l'optimisation des dépendances de Vite. -- `external` is also omitted, use Vite's `optimizeDeps.exclude` option -- `plugins` are merged with Vite's dep plugin +- `external` est également omis, utilisez l'option `optimizeDeps.exclude` de Vite +- Les `plugins` sont fusionnés avec le plugin de dépendances de Vite ## optimizeDeps.force -- **Type:** `boolean` +- **Type :** `boolean` -Set to `true` to force dependency pre-bundling, ignoring previously cached optimized dependencies. +Définissez sur `true` pour forcer le pré-building des dépendances, en ignorant les dépendances optimisées précédemment mises en cache. ## optimizeDeps.holdUntilCrawlEnd -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/15834) -- **Type:** `boolean` -- **Default:** `true` +- **Expérimental :** [Donnez votre avis](https://github.com/vitejs/vite/discussions/15834) +- **Type :** `boolean` +- **Défaut :** `true` -When enabled, it will hold the first optimized deps results until all static imports are crawled on cold start. This avoids the need for full-page reloads when new dependencies are discovered and they trigger the generation of new common chunks. If all dependencies are found by the scanner plus the explicitly defined ones in `include`, it is better to disable this option to let the browser process more requests in parallel. +Lorsqu'elle est activée, cette option retient les premiers résultats des dépendances optimisées jusqu'à ce que toutes les importations statiques soient parcourues au démarrage à froid. Cela évite la nécessité de rechargements complets de page lorsque de nouvelles dépendances sont découvertes et qu'elles déclenchent la génération de nouveaux fragments communs. Si toutes les dépendances sont trouvées par le scanner plus celles explicitement définies dans `include`, il est préférable de désactiver cette option pour permettre au navigateur de traiter plus de requêtes en parallèle. ## optimizeDeps.disabled -- **Deprecated** -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/13839) -- **Type:** `boolean | 'build' | 'dev'` -- **Default:** `'build'` +- **Déprécié** +- **Expérimental :** [Donnez votre avis](https://github.com/vitejs/vite/discussions/13839) +- **Type :** `boolean | 'build' | 'dev'` +- **Défaut :** `'build'` -This option is deprecated. As of Vite 5.1, pre-bundling of dependencies during build have been removed. Setting `optimizeDeps.disabled` to `true` or `'dev'` disables the optimizer, and configured to `false` or `'build'` leaves the optimizer during dev enabled. +Cette option est dépréciée. Depuis Vite 5.1, le pré-build des dépendances pendant la construction a été supprimé. Définir `optimizeDeps.disabled` sur `true` ou `'dev'` désactive l'optimiseur, et le configurer sur `false` ou `'build'` laisse l'optimiseur activé pendant le développement. -To disable the optimizer completely, use `optimizeDeps.noDiscovery: true` to disallow automatic discovery of dependencies and leave `optimizeDeps.include` undefined or empty. +Pour désactiver complètement l'optimiseur, utilisez `optimizeDeps.noDiscovery: true` pour interdire la découverte automatique des dépendances et laissez `optimizeDeps.include` non défini ou vide. :::warning -Optimizing dependencies during build time was an **experimental** feature. Projects trying out this strategy also removed `@rollup/plugin-commonjs` using `build.commonjsOptions: { include: [] }`. If you did so, a warning will guide you to re-enable it to support CJS only packages while bundling. +L'optimisation des dépendances pendant la phase de build était une fonctionnalité **expérimentale**. Les projets essayant cette stratégie ont également supprimé `@rollup/plugin-commonjs` en utilisant `build.commonjsOptions: { include: [] }`. Si vous l'avez utilisé, un avertissement vous guidera pour le réactiver afin de prendre en charge les packages CJS uniquement pendant le build. ::: ## optimizeDeps.needsInterop -- **Experimental** -- **Type:** `string[]` +- **Expérimental** +- **Type :** `string[]` -Forces ESM interop when importing these dependencies. Vite is able to properly detect when a dependency needs interop, so this option isn't generally needed. However, different combinations of dependencies could cause some of them to be prebundled differently. Adding these packages to `needsInterop` can speed up cold start by avoiding full-page reloads. You'll receive a warning if this is the case for one of your dependencies, suggesting to add the package name to this array in your config. +Force l'interopérabilité ESM lors de l'importation de ces dépendances. Vite est capable de détecter correctement quand une dépendance a besoin d'interopérabilité, donc cette option n'est généralement pas nécessaire. Cependant, différentes combinaisons de dépendances pourraient amener certaines d'entre elles à être pré-buildé différemment. Ajouter ces packages à `needsInterop` peut accélérer le démarrage à froid en évitant les rechargements complets de page. Vous recevrez un avertissement si c'est le cas pour l'une de vos dépendances, suggérant d'ajouter le nom du package à ce tableau dans votre configuration. From 62a5ee346741d712d52e00d577ae0cce0e2a4863 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 15:52:40 +0200 Subject: [PATCH 25/40] traduction de docs/config/index.md --- docs/config/index.md | 62 ++++++++++++++++++++++---------------------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/config/index.md b/docs/config/index.md index 02a9719..65e3745 100644 --- a/docs/config/index.md +++ b/docs/config/index.md @@ -1,36 +1,36 @@ --- -title: Configuring Vite +title: Configurer Vite --- -# Configuring Vite +# Configurer Vite -When running `vite` from the command line, Vite will automatically try to resolve a config file named `vite.config.js` inside [project root](/guide/#index-html-and-project-root) (other JS and TS extensions are also supported). +Lorsque vous exécutez `vite` depuis la ligne de commande, Vite essaiera automatiquement de trouver un fichier de configuration nommé `vite.config.js` dans la [racine du projet](/guide/#index-html-and-project-root) (les autres extensions JS et TS sont également prises en charge). -The most basic config file looks like this: +Le fichier de configuration le plus basique ressemble à ceci : ```js [vite.config.js] export default { - // config options + // options de configuration } ``` -Note Vite supports using ES modules syntax in the config file even if the project is not using native Node ESM, e.g. `type: "module"` in `package.json`. In this case, the config file is auto pre-processed before load. +Notez que Vite prend en charge l'utilisation de la syntaxe des modules ES dans le fichier de configuration, même si le projet n'utilise pas les modules ESM natifs de Node, par exemple `type: "module"` dans `package.json`. Dans ce cas, le fichier de configuration est automatiquement prétraité avant d'être chargé. -You can also explicitly specify a config file to use with the `--config` CLI option (resolved relative to `cwd`): +Vous pouvez également spécifier explicitement un fichier de configuration à utiliser avec l'option CLI `--config` (résolu de manière relative à `cwd`) : ```bash -vite --config my-config.js +vite --config ma-config.js ``` -::: tip CONFIG LOADING -By default, Vite uses `esbuild` to bundle the config into a temporary file and load it. This may cause issues when importing TypeScript files in a monorepo. If you encounter any issues with this approach, you can specify `--configLoader runner` to use the [module runner](/guide/api-environment-runtimes.html#modulerunner) instead, which will not create a temporary config and will transform any files on the fly. Note that module runner doesn't support CJS in config files, but external CJS packages should work as usual. +::: tip CHARGEMENT DE LA CONFIGURATION +Par défaut, Vite utilise `esbuild` pour empaqueter la configuration dans un fichier temporaire et le charger. Cela peut causer des problèmes lors de l'importation de fichiers TypeScript dans un monorepo. Si vous rencontrez des problèmes avec cette approche, vous pouvez spécifier `--configLoader runner` pour utiliser le [module runner](/guide/api-environment-runtimes.html#modulerunner) à la place, qui ne créera pas de configuration temporaire et transformera les fichiers à la volée. Notez que le module runner ne prend pas en charge CJS dans les fichiers de configuration, mais les paquets CJS externes devraient fonctionner comme d'habitude. -Alternatively, if you're using an environment that supports TypeScript (e.g. `node --experimental-strip-types`), or if you're only writing plain JavaScript, you can specify `--configLoader native` to use the environment's native runtime to load the config file. Note that updates to modules imported by the config file are not detected and hence would not auto-restart the Vite server. +Alternativement, si vous utilisez un environnement qui prend en charge TypeScript (par exemple `node --experimental-strip-types`), ou si vous n'écrivez que du JavaScript simple, vous pouvez spécifier `--configLoader native` pour utiliser l'environnement d'exécution natif pour charger le fichier de configuration. Notez que les mises à jour des modules importés par le fichier de configuration ne sont pas détectées et ne redémarreront donc pas automatiquement le serveur Vite. ::: -## Config Intellisense +## Configurer Intellisense -Since Vite ships with TypeScript typings, you can leverage your IDE's intellisense with jsdoc type hints: +Comme Vite est livré avec des typages TypeScript, vous pouvez profiter de l'intellisense de votre IDE avec des indications de type jsdoc : ```js /** @type {import('vite').UserConfig} */ @@ -39,7 +39,7 @@ export default { } ``` -Alternatively, you can use the `defineConfig` helper which should provide intellisense without the need for jsdoc annotations: +Alternativement, vous pouvez utiliser l'assistant `defineConfig` qui devrait fournir l'intellisense sans avoir besoin d'annotations jsdoc : ```js import { defineConfig } from 'vite' @@ -49,7 +49,7 @@ export default defineConfig({ }) ``` -Vite also supports TypeScript config files. You can use `vite.config.ts` with the `defineConfig` helper function above, or with the `satisfies` operator: +Vite prend également en charge les fichiers de configuration TypeScript. Vous pouvez utiliser `vite.config.ts` avec la fonction d'assistance `defineConfig` ci-dessus, ou avec l'opérateur `satisfies` : ```ts import type { UserConfig } from 'vite' @@ -59,9 +59,9 @@ export default { } satisfies UserConfig ``` -## Conditional Config +## Configuration conditionnelle -If the config needs to conditionally determine options based on the command (`serve` or `build`), the [mode](/guide/env-and-mode#modes) being used, if it's an SSR build (`isSsrBuild`), or is previewing the build (`isPreview`), it can export a function instead: +Si la configuration doit déterminer conditionnellement des options en fonction de la commande (`serve` ou `build`), du [mode](/guide/env-and-mode#modes) utilisé, s'il s'agit d'une construction SSR (`isSsrBuild`), ou de la prévisualisation de la construction (`isPreview`), elle peut exporter une fonction à la place : ```js twoslash import { defineConfig } from 'vite' @@ -69,24 +69,24 @@ import { defineConfig } from 'vite' export default defineConfig(({ command, mode, isSsrBuild, isPreview }) => { if (command === 'serve') { return { - // dev specific config + // configuration spécifique au développement } } else { // command === 'build' return { - // build specific config + // configuration spécifique à la construction } } }) ``` -It is important to note that in Vite's API the `command` value is `serve` during dev (in the cli [`vite`](/guide/cli#vite), `vite dev`, and `vite serve` are aliases), and `build` when building for production ([`vite build`](/guide/cli#vite-build)). +Il est important de noter que dans l'API de Vite, la valeur de `command` est `serve` pendant le développement (dans la CLI [`vite`](/guide/cli#vite), `vite dev`, et `vite serve` sont des alias), et `build` lors de la construction pour la production ([`vite build`](/guide/cli#vite-build)). -`isSsrBuild` and `isPreview` are additional optional flags to differentiate the kind of `build` and `serve` commands respectively. Some tools that load the Vite config may not support these flags and will pass `undefined` instead. Hence, it's recommended to use explicit comparison against `true` and `false`. +`isSsrBuild` et `isPreview` sont des arguments optionnels supplémentaires pour différencier le type de commandes `build` et `serve` respectivement. Certains outils qui chargent la configuration Vite peuvent ne pas prendre en charge ces arguments et passeront `undefined` à la place. Par conséquent, il est recommandé d'utiliser une comparaison explicite avec `true` et `false`. -## Async Config +## Configuration asynchrone -If the config needs to call async functions, it can export an async function instead. And this async function can also be passed through `defineConfig` for improved intellisense support: +Si la configuration doit appeler des fonctions asynchrones, elle peut exporter une fonction asynchrone à la place. Cette fonction asynchrone peut également être passée par `defineConfig` pour une meilleure prise en charge de l'intellisense : ```js twoslash import { defineConfig } from 'vite' @@ -94,27 +94,27 @@ import { defineConfig } from 'vite' export default defineConfig(async ({ command, mode }) => { const data = await asyncFunction() return { - // vite config + // configuration vite } }) ``` -## Using Environment Variables in Config +## Utilisation des variables d'environnement dans la configuration -Environmental Variables can be obtained from `process.env` as usual. +Les variables d'environnement peuvent être obtenues à partir de `process.env` comme d'habitude. -Note that Vite doesn't load `.env` files by default as the files to load can only be determined after evaluating the Vite config, for example, the `root` and `envDir` options affect the loading behaviour. However, you can use the exported `loadEnv` helper to load the specific `.env` file if needed. +Notez que Vite ne charge pas les fichiers `.env` par défaut car les fichiers à charger ne peuvent être déterminés qu'après avoir évalué la configuration Vite, par exemple, les options `root` et `envDir` affectent le comportement de chargement. Cependant, vous pouvez utiliser l'assistant exporté `loadEnv` pour charger le fichier `.env` spécifique si nécessaire. ```js twoslash import { defineConfig, loadEnv } from 'vite' export default defineConfig(({ mode }) => { - // Load env file based on `mode` in the current working directory. - // Set the third parameter to '' to load all env regardless of the - // `VITE_` prefix. + // Charge le fichier d'environnement basé sur `mode` dans le répertoire de travail actuel. + // Définit le troisième paramètre à '' pour charger tous les env indépendamment + // du préfixe `VITE_`. const env = loadEnv(mode, process.cwd(), '') return { - // vite config + // configuration vite define: { __APP_ENV__: JSON.stringify(env.APP_ENV), }, From 09f97c09aee0a6bdece859633821e26174ed78d1 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 15:59:04 +0200 Subject: [PATCH 26/40] traduction de preview-options --- docs/config/preview-options.md | 78 +++++++++++++++++----------------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/docs/config/preview-options.md b/docs/config/preview-options.md index 5f95461..2c0b572 100644 --- a/docs/config/preview-options.md +++ b/docs/config/preview-options.md @@ -1,41 +1,41 @@ -# Preview Options +# Options de prévisualisation -Unless noted, the options in this section are only applied to preview. +Sauf indication contraire, les options de cette section ne s'appliquent qu'à la prévisualisation. ## preview.host -- **Type:** `string | boolean` -- **Default:** [`server.host`](./server-options#server-host) +- **Type :** `string | boolean` +- **Défaut :** [`server.host`](./server-options#server-host) -Specify which IP addresses the server should listen on. -Set this to `0.0.0.0` or `true` to listen on all addresses, including LAN and public addresses. +Spécifie les adresses IP sur lesquelles le serveur doit écouter. +Définissez cette option sur `0.0.0.0` ou `true` pour écouter sur toutes les adresses, y compris les réseaux locaux et les adresses publiques. -This can be set via the CLI using `--host 0.0.0.0` or `--host`. +Cette option peut être définie via la CLI en utilisant `--host 0.0.0.0` ou `--host`. -::: tip NOTE +::: tip REMARQUE -There are cases when other servers might respond instead of Vite. -See [`server.host`](./server-options#server-host) for more details. +Il existe des cas où d'autres serveurs pourraient répondre à la place de Vite. +Consultez [`server.host`](./server-options#server-host) pour plus de détails. ::: ## preview.allowedHosts -- **Type:** `string | true` -- **Default:** [`server.allowedHosts`](./server-options#server-allowedhosts) +- **Type :** `string | true` +- **Défaut :** [`server.allowedHosts`](./server-options#server-allowedhosts) -The hostnames that Vite is allowed to respond to. +Les hostnames auxquels Vite est autorisé à répondre. -See [`server.allowedHosts`](./server-options#server-allowedhosts) for more details. +Consultez [`server.allowedHosts`](./server-options#server-allowedhosts) pour plus de détails. ## preview.port -- **Type:** `number` -- **Default:** `4173` +- **Type :** `number` +- **Défaut :** `4173` -Specify server port. Note if the port is already being used, Vite will automatically try the next available port so this may not be the actual port the server ends up listening on. +Spécifie le port du serveur. Notez que si le port est déjà utilisé, Vite essaiera automatiquement le prochain port disponible, ce ne sera donc pas forcement le port réel sur lequel le serveur finira par écouter. -**Example:** +**Exemple :** ```js export default defineConfig({ @@ -50,49 +50,49 @@ export default defineConfig({ ## preview.strictPort -- **Type:** `boolean` -- **Default:** [`server.strictPort`](./server-options#server-strictport) +- **Type :** `boolean` +- **Défaut :** [`server.strictPort`](./server-options#server-strictport) -Set to `true` to exit if port is already in use, instead of automatically trying the next available port. +Définissez sur `true` pour quitter si le port est déjà utilisé, au lieu d'essayer automatiquement le prochain port disponible. ## preview.https -- **Type:** `https.ServerOptions` -- **Default:** [`server.https`](./server-options#server-https) +- **Type :** `https.ServerOptions` +- **Défaut :** [`server.https`](./server-options#server-https) -Enable TLS + HTTP/2. +Active TLS + HTTP/2. -See [`server.https`](./server-options#server-https) for more details. +Voir [`server.https`](./server-options#server-https) pour plus de détails. ## preview.open -- **Type:** `boolean | string` -- **Default:** [`server.open`](./server-options#server-open) +- **Type :** `boolean | string` +- **Défaut :** [`server.open`](./server-options#server-open) -Automatically open the app in the browser on server start. When the value is a string, it will be used as the URL's pathname. If you want to open the server in a specific browser you like, you can set the env `process.env.BROWSER` (e.g. `firefox`). You can also set `process.env.BROWSER_ARGS` to pass additional arguments (e.g. `--incognito`). +Ouvre automatiquement l'application dans le navigateur au démarrage du serveur. Lorsque la valeur est une chaîne de caractères, elle sera utilisée comme chemin de l'URL. Si vous souhaitez ouvrir le serveur dans un navigateur spécifique, vous pouvez définir la variable d'environnement `process.env.BROWSER` (par exemple `firefox`). Vous pouvez également définir `process.env.BROWSER_ARGS` pour passer des arguments supplémentaires (par exemple `--incognito`). -`BROWSER` and `BROWSER_ARGS` are also special environment variables you can set in the `.env` file to configure it. See [the `open` package](https://github.com/sindresorhus/open#app) for more details. +`BROWSER` et `BROWSER_ARGS` sont également des variables d'environnement spéciales que vous pouvez définir dans le fichier `.env` pour les configurer. Consultez [le package `open`](https://github.com/sindresorhus/open#app) pour plus de détails. ## preview.proxy -- **Type:** `Record` -- **Default:** [`server.proxy`](./server-options#server-proxy) +- **Type :** `Record` +- **Défaut :** [`server.proxy`](./server-options#server-proxy) -Configure custom proxy rules for the preview server. Expects an object of `{ key: options }` pairs. If the key starts with `^`, it will be interpreted as a `RegExp`. The `configure` option can be used to access the proxy instance. +Configure des règles de proxy personnalisées pour le serveur de prévisualisation. S'attend à un objet de paires `{ clef: options }`. Si la clef commence par `^`, elle sera interprétée comme une `RegExp`. L'option `configure` peut être utilisée pour accéder à l'instance de proxy. -Uses [`http-proxy`](https://github.com/http-party/node-http-proxy). Full options [here](https://github.com/http-party/node-http-proxy#options). +Utilise [`http-proxy`](https://github.com/http-party/node-http-proxy). Options complètes [ici](https://github.com/http-party/node-http-proxy#options). ## preview.cors -- **Type:** `boolean | CorsOptions` -- **Default:** [`server.cors`](./server-options#server-cors) +- **Type :** `boolean | CorsOptions` +- **Défaut :** [`server.cors`](./server-options#server-cors) -Configure CORS for the preview server. +Configure les CORS pour le serveur de prévisualisation. -See [`server.cors`](./server-options#server-cors) for more details. +Consultez [`server.cors`](./server-options#server-cors) pour plus de détails. ## preview.headers -- **Type:** `OutgoingHttpHeaders` +- **Type :** `OutgoingHttpHeaders` -Specify server response headers. +Spécifie les en-têtes de réponse du serveur. From 360e26905b6c1f82613510bbd53e1a8627efd9fe Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 16:22:42 +0200 Subject: [PATCH 27/40] fin de traduction de shared options.md --- docs/config/shared-options.md | 148 +++++++++++++++++----------------- 1 file changed, 74 insertions(+), 74 deletions(-) diff --git a/docs/config/shared-options.md b/docs/config/shared-options.md index f202d11..e04795f 100644 --- a/docs/config/shared-options.md +++ b/docs/config/shared-options.md @@ -218,22 +218,22 @@ Pour la configuration PostCSS inline, il attend le même format que `postcss.con La recherche est faite en utilisant [postcss-load-config](https://github.com/postcss/postcss-load-config) et seuls les noms de fichiers de configuration pris en charge sont chargés. Les fichiers de configuration en dehors du répertoire racine du projet (ou du [répertoire racine du projet](/guide/#index-html-and-project-root) si aucun espace de travail n'est trouvé) ne sont pas recherchés par défaut. Vous pouvez spécifier un chemin personnalisé en dehors de la racine pour charger le fichier de configuration spécifique si nécessaire. -Note if an inline config is provided, Vite will not search for other PostCSS config sources. +Notez que si une configuration inline est fournie, Vite ne recherchera pas d'autres sources de configuration PostCSS. ## css.preprocessorOptions - **Type:** `Record` -Specify options to pass to CSS pre-processors. The file extensions are used as keys for the options. The supported options for each preprocessor can be found in their respective documentation: +Spécifie les options à passer aux préprocesseurs CSS. Les extensions de fichiers sont utilisées comme clefs pour les options. Les options prises en charge pour chaque préprocesseur peuvent être trouvées dans leur documentation respective : -- `sass`/`scss`: - - Select the sass API to use with `api: "modern-compiler" | "modern" | "legacy"` (default `"modern-compiler"` if `sass-embedded` is installed, otherwise `"modern"`). For the best performance, it's recommended to use `api: "modern-compiler"` with the `sass-embedded` package. The `"legacy"` API is deprecated and will be removed in Vite 7. +- `sass`/`scss` : + - Sélectionnez l'API sass à utiliser avec l'`api: "modern-compiler" | "modern" | "legacy"` (par défaut `"modern-compiler"` si `sass-embedded` est installé, sinon `"modern"`). Pour de meilleures performances, il est recommandé d'utiliser `api: "modern-compiler"` avec le package `sass-embedded`. L'API `"legacy"` est dépréciée et sera supprimée dans Vite 7. - [Options (modern)](https://sass-lang.com/documentation/js-api/interfaces/stringoptions/) - [Options (legacy)](https://sass-lang.com/documentation/js-api/interfaces/LegacyStringOptions). -- `less`: [Options](https://lesscss.org/usage/#less-options). -- `styl`/`stylus`: Only [`define`](https://stylus-lang.com/docs/js.html#define-name-node) is supported, which can be passed as an object. +- `less` : [Options](https://lesscss.org/usage/#less-options). +- `styl`/`stylus` : Seul [`define`](https://stylus-lang.com/docs/js.html#define-name-node) est pris en charge, qui peut être passé comme un objet. -**Example:** +**Exemple :** ```js export default defineConfig({ @@ -248,7 +248,7 @@ export default defineConfig({ }, }, scss: { - api: 'modern-compiler', // or "modern", "legacy" + api: 'modern-compiler', // ou "modern", "legacy" importers: [ // ... ], @@ -262,9 +262,9 @@ export default defineConfig({ - **Type:** `string | ((source: string, filename: string) => (string | { content: string; map?: SourceMap }))` -This option can be used to inject extra code for each style content. Note that if you include actual styles and not just variables, those styles will be duplicated in the final bundle. +Cette option peut être utilisée pour injecter du code supplémentaire pour chaque contenu de style. Notez que si vous incluez des styles et pas seulement des variables, ces styles seront dupliqués dans le bundle final. -**Example:** +**Exemple :** ```js export default defineConfig({ @@ -280,36 +280,36 @@ export default defineConfig({ ## css.preprocessorMaxWorkers -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/15835) -- **Type:** `number | true` -- **Default:** `0` (does not create any workers and run in the main thread) +- **Expérimental :** [Donner un avis](https://github.com/vitejs/vite/discussions/15835) +- **Type :** `number | true` +- **Default :** `0` (ne crée pas de workers et s'exécute dans le thread principal) -If this option is set, CSS preprocessors will run in workers when possible. `true` means the number of CPUs minus 1. +Si cette option est définie, les préprocesseurs CSS s'exécuteront dans des workers lorsque c'est possible. `true` signifie "nombre de CPU moins 1". ## css.devSourcemap -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/13845) -- **Type:** `boolean` -- **Default:** `false` +- **Expérimental :** [Donner un avis](https://github.com/vitejs/vite/discussions/13845) +- **Type :** `boolean` +- **Default :** `false` -Whether to enable sourcemaps during dev. +Pour activer les sourcemaps en développement. ## css.transformer -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/13835) -- **Type:** `'postcss' | 'lightningcss'` -- **Default:** `'postcss'` +- **Expérimental :** [Donner un avis](https://github.com/vitejs/vite/discussions/13835) +- **Type :** `'postcss' | 'lightningcss'` +- **Default :** `'postcss'` -Selects the engine used for CSS processing. Check out [Lightning CSS](../guide/features.md#lightning-css) for more information. +Sélectionne le moteur utilisé pour le traitement CSS. Consultez [Lightning CSS](../guide/features.md#lightning-css) pour plus d'informations. -::: info Duplicate `@import`s -Note that postcss (postcss-import) has a different behavior with duplicated `@import` from browsers. See [postcss/postcss-import#462](https://github.com/postcss/postcss-import/issues/462). +::: info `@import` en double +Notez que postcss (postcss-import) a un comportement différent avec les `@import` dupliqués par rapport aux navigateurs. Voir [postcss/postcss-import#462](https://github.com/postcss/postcss-import/issues/462). ::: ## css.lightningcss -- **Experimental:** [Give Feedback](https://github.com/vitejs/vite/discussions/13835) -- **Type:** +- **Expérimental :** [Donner un avis](https://github.com/vitejs/vite/discussions/13835) +- **Type :** ```js import type { @@ -336,29 +336,29 @@ import type { } ``` -Configures Lightning CSS. Full transform options can be found in [the Lightning CSS repo](https://github.com/parcel-bundler/lightningcss/blob/master/node/index.d.ts). +Configure Lightning CSS. Les options de transformation complètes peuvent être trouvées dans [le dépôt Lightning CSS](https://github.com/parcel-bundler/lightningcss/blob/master/node/index.d.ts). ## json.namedExports -- **Type:** `boolean` -- **Default:** `true` +- **Type :** `boolean` +- **Default :** `true` -Whether to support named imports from `.json` files. +Pour activer le support des importations nommées à partir de fichiers `.json`. ## json.stringify -- **Type:** `boolean | 'auto'` -- **Default:** `'auto'` +- **Type :** `boolean | 'auto'` +- **Default :** `'auto'` -If set to `true`, imported JSON will be transformed into `export default JSON.parse("...")` which is significantly more performant than Object literals, especially when the JSON file is large. +Si défini à `true`, le JSON importé sera transformé en `export default JSON.parse("...")` qui est beaucoup plus performant que les objets literaux, surtout lorsque le fichier JSON est volumineux. -If set to `'auto'`, the data will be stringified only if [the data is bigger than 10kB](https://v8.dev/blog/cost-of-javascript-2019#json:~:text=A%20good%20rule%20of%20thumb%20is%20to%20apply%20this%20technique%20for%20objects%20of%2010%20kB%20or%20larger). +Si défini à `'auto'`, les données seront stringifiées uniquement si [elles sont plus grandes que 10kB](https://v8.dev/blog/cost-of-javascript-2019#json:~:text=A%20good%20rule%20of%20thumb%20is%20to%20apply%20this%20technique%20for%20objects%20of%2010%20kB%20or%20larger). ## esbuild -- **Type:** `ESBuildOptions | false` +- **Type :** `ESBuildOptions | false` -`ESBuildOptions` extends [esbuild's own transform options](https://esbuild.github.io/api/#transform). The most common use case is customizing JSX: +`ESBuildOptions` étend les [options de transformation d'esbuild](https://esbuild.github.io/api/#transform). Le cas d'utilisation le plus courant est la personnalisation de JSX : ```js export default defineConfig({ @@ -369,9 +369,9 @@ export default defineConfig({ }) ``` -By default, esbuild is applied to `ts`, `jsx` and `tsx` files. You can customize this with `esbuild.include` and `esbuild.exclude`, which can be a regex, a [picomatch](https://github.com/micromatch/picomatch#globbing-features) pattern, or an array of either. +Par défaut, esbuild est appliqué aux fichiers `ts`, `jsx` et `tsx`. Vous pouvez personnaliser cela avec `esbuild.include` et `esbuild.exclude`, qui peuvent être une regex, un modèle [picomatch](https://github.com/micromatch/picomatch#globbing-features), ou un tableau de l'un ou l'autre. -In addition, you can also use `esbuild.jsxInject` to automatically inject JSX helper imports for every file transformed by esbuild: +En outre, vous pouvez également utiliser `esbuild.jsxInject` pour injecter automatiquement des importations d'helper JSX pour chaque fichier transformé par esbuild : ```js export default defineConfig({ @@ -381,24 +381,24 @@ export default defineConfig({ }) ``` -When [`build.minify`](./build-options.md#build-minify) is `true`, all minify optimizations are applied by default. To disable [certain aspects](https://esbuild.github.io/api/#minify) of it, set any of `esbuild.minifyIdentifiers`, `esbuild.minifySyntax`, or `esbuild.minifyWhitespace` options to `false`. Note the `esbuild.minify` option can't be used to override `build.minify`. +Lorsque [`build.minify`](./build-options.md#build-minify) est `true`, toutes les optimisations de minification sont appliquées par défaut. Pour désactiver [certains aspects](https://esbuild.github.io/api/#minify), définissez l'une des options `esbuild.minifyIdentifiers`, `esbuild.minifySyntax` ou `esbuild.minifyWhitespace` à `false`. Notez que l'option `esbuild.minify` ne peut pas être utilisée pour remplacer `build.minify`. -Set to `false` to disable esbuild transforms. +Définissez à `false` pour désactiver les transformations esbuild. ## assetsInclude -- **Type:** `string | RegExp | (string | RegExp)[]` -- **Related:** [Static Asset Handling](/guide/assets) +- **Type :** `string | RegExp | (string | RegExp)[]` +- **Lié :** [Gestion des assets statiques](/guide/assets) -Specify additional [picomatch patterns](https://github.com/micromatch/picomatch#globbing-features) to be treated as static assets so that: +Spécifiez des [modèles picomatch](https://github.com/micromatch/picomatch#globbing-features) supplémentaires à traiter comme des assets statiques afin que : -- They will be excluded from the plugin transform pipeline when referenced from HTML or directly requested over `fetch` or XHR. +- Ils seront exclus du pipeline de transformation des plugins lorsqu'ils sont référencés depuis HTML ou directement demandés via `fetch` ou XHR. -- Importing them from JS will return their resolved URL string (this can be overwritten if you have a `enforce: 'pre'` plugin to handle the asset type differently). +- Les importer depuis JS renverra leur URL résolue sous forme de chaîne (cela peut être remplacé si vous avez un plugin `enforce: 'pre'` pour gérer le type d'asset différemment). -The built-in asset type list can be found [here](https://github.com/vitejs/vite/blob/main/packages/vite/src/node/constants.ts). +La liste des types d'assets intégrés peut être trouvée [ici](https://github.com/vitejs/vite/blob/main/packages/vite/src/node/constants.ts). -**Example:** +**Exemple :** ```js export default defineConfig({ @@ -408,13 +408,13 @@ export default defineConfig({ ## logLevel -- **Type:** `'info' | 'warn' | 'error' | 'silent'` +- **Type :** `'info' | 'warn' | 'error' | 'silent'` -Adjust console output verbosity. Default is `'info'`. +Ajuste la verbosité des messages de la console. Par défaut : `'info'`. ## customLogger -- **Type:** +- **Type :** ```ts interface Logger { info(msg: string, options?: LogOptions): void @@ -427,7 +427,7 @@ Adjust console output verbosity. Default is `'info'`. } ``` -Use a custom logger to log messages. You can use Vite's `createLogger` API to get the default logger and customize it to, for example, change the message or filter out certain warnings. +Utilisez un logger personnalisé pour les messages. Vous pouvez utiliser l'API `createLogger` de Vite pour obtenir le logger par défaut et le personnaliser pour, par exemple, modifier le message ou filtrer certains avertissements. ```ts twoslash import { createLogger, defineConfig } from 'vite' @@ -436,7 +436,7 @@ const logger = createLogger() const loggerWarn = logger.warn logger.warn = (msg, options) => { - // Ignore empty CSS files warning + // Ignorer l'avertissement des fichiers CSS vides if (msg.includes('vite:css') && msg.includes(' is empty')) return loggerWarn(msg, options) } @@ -448,31 +448,31 @@ export default defineConfig({ ## clearScreen -- **Type:** `boolean` -- **Default:** `true` +- **Type :** `boolean` +- **Default :** `true` -Set to `false` to prevent Vite from clearing the terminal screen when logging certain messages. Via command line, use `--clearScreen false`. +Définissez à `false` pour empêcher Vite d'effacer l'écran du terminal lors de l'affichage de certains messages. Via la ligne de commande, utilisez `--clearScreen false`. ## envDir - **Type:** `string | false` - **Default:** `root` -The directory from which `.env` files are loaded. Can be an absolute path, or a path relative to the project root. `false` will disable the `.env` file loading. +Le répertoire à partir duquel les fichiers `.env` sont chargés. Peut être un chemin absolu, ou un chemin relatif à la racine du projet. Désactive le chargement du fichier `.env` si `false`. -See [here](/guide/env-and-mode#env-files) for more about environment files. +Voir [ici](/guide/env-and-mode#env-files) pour plus d'informations sur les fichiers d'environnement. ## envPrefix -- **Type:** `string | string[]` -- **Default:** `VITE_` +- **Type :** `string | string[]` +- **Default :** `VITE_` -Env variables starting with `envPrefix` will be exposed to your client source code via import.meta.env. +Les variables d'environnement commençant par `envPrefix` seront exposées à votre code source client via import.meta.env. -:::warning SECURITY NOTES -`envPrefix` should not be set as `''`, which will expose all your env variables and cause unexpected leaking of sensitive information. Vite will throw an error when detecting `''`. +:::warning NOTES DE SÉCURITÉ +`envPrefix` ne doit pas être défini comme `''`, ce qui exposerait toutes vos variables d'environnement et pourrait entraîner une fuite inattendue d'informations sensibles. Vite générera une erreur lors de la détection de `''`. -If you would like to expose an unprefixed variable, you can use [define](#define) to expose it: +Si vous souhaitez exposer une variable sans préfixe, vous pouvez utiliser [define](#define) pour l'exposer : ```js define: { @@ -484,22 +484,22 @@ define: { ## appType -- **Type:** `'spa' | 'mpa' | 'custom'` -- **Default:** `'spa'` +- **Type :** `'spa' | 'mpa' | 'custom'` +- **Default :** `'spa'` -Whether your application is a Single Page Application (SPA), a [Multi Page Application (MPA)](../guide/build#multi-page-app), or Custom Application (SSR and frameworks with custom HTML handling): +Si votre application est une Single Page Application (SPA), une [Multi Page Application (MPA)](../guide/build#multi-page-app), ou une application personnalisée (SSR et frameworks avec gestion HTML personnalisée) : -- `'spa'`: include HTML middlewares and use SPA fallback. Configure [sirv](https://github.com/lukeed/sirv) with `single: true` in preview -- `'mpa'`: include HTML middlewares -- `'custom'`: don't include HTML middlewares +- `'spa'` : inclut les middlewares HTML et utilise la solution de repli SPA. Configure [sirv](https://github.com/lukeed/sirv) avec `single: true` en prévisualisation +- `'mpa'` : inclut les middlewares HTML +- `'custom'` : n'inclut pas les middlewares HTML -Learn more in Vite's [SSR guide](/guide/ssr#vite-cli). Related: [`server.middlewareMode`](./server-options#server-middlewaremode). +En savoir plus dans le [guide SSR](/guide/ssr#vite-cli) de Vite. Connexe : [`server.middlewareMode`](./server-options#server-middlewaremode). ## future -- **Type:** `Record` -- **Related:** [Breaking Changes](/changes/) +- **Type :** `Record` +- **Lié :** [Changements majeurs](/changes/) -Enable future breaking changes to prepare for a smooth migration to the next major version of Vite. The list may be updated, added, or removed at any time as new features are developed. +Activez les futurs changements majeurs pour préparer une migration en douceur vers la prochaine version majeure de Vite. La liste peut être mise à jour, ajoutée ou supprimée à tout moment au fur et à mesure que de nouvelles fonctionnalités sont développées. -See the [Breaking Changes](/changes/) page for details of the possible options. +Consultez la page [Changements majeurs](/changes/) pour les détails des options possibles. From b8b9f7535dd7c93d5af69d7bc605a5c97bb01e06 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 17:00:49 +0200 Subject: [PATCH 28/40] traduction de server-options et fin de traduction de config --- docs/config/server-options.md | 268 +++++++++++++++++----------------- 1 file changed, 134 insertions(+), 134 deletions(-) diff --git a/docs/config/server-options.md b/docs/config/server-options.md index b689118..5e05434 100644 --- a/docs/config/server-options.md +++ b/docs/config/server-options.md @@ -1,24 +1,24 @@ -# Server Options +# Options du serveur -Unless noted, the options in this section are only applied to dev. +Sauf mention contraire, les options de cette section ne s'appliquent qu'au développement. ## server.host -- **Type:** `string | boolean` -- **Default:** `'localhost'` +- **Type :** `string | boolean` +- **Défaut :** `'localhost'` -Specify which IP addresses the server should listen on. -Set this to `0.0.0.0` or `true` to listen on all addresses, including LAN and public addresses. +Spécifie les adresses IP sur lesquelles le serveur doit écouter. +Définissez cette option sur `0.0.0.0` ou `true` pour écouter sur toutes les adresses, y compris les réseaux locaux et les adresses publiques. -This can be set via the CLI using `--host 0.0.0.0` or `--host`. +Cette option peut être définie via la CLI en utilisant `--host 0.0.0.0` ou `--host`. -::: tip NOTE +::: tip REMARQUE -There are cases when other servers might respond instead of Vite. +Il existe des cas où d'autres serveurs pourraient répondre à la place de Vite. -The first case is when `localhost` is used. Node.js under v17 reorders the result of DNS-resolved addresses by default. When accessing `localhost`, browsers use DNS to resolve the address and that address might differ from the address which Vite is listening to. Vite prints the resolved address when it differs. +Le premier cas est lorsque `localhost` est utilisé. Node.js avant la v17 réorganise par défaut le résultat des adresses résolues par DNS. Lorsque vous accédez à `localhost`, les navigateurs utilisent DNS pour résoudre l'adresse et cette adresse peut différer de celle sur laquelle Vite écoute. Vite affiche l'adresse résolue lorsqu'elle diffère. -You can set [`dns.setDefaultResultOrder('verbatim')`](https://nodejs.org/api/dns.html#dns_dns_setdefaultresultorder_order) to disable the reordering behavior. Vite will then print the address as `localhost`. +Vous pouvez définir [`dns.setDefaultResultOrder('verbatim')`](https://nodejs.org/api/dns.html#dns_dns_setdefaultresultorder_order) pour désactiver le comportement de réorganisation. Vite affichera alors l'adresse comme `localhost`. ```js twoslash [vite.config.js] import { defineConfig } from 'vite' @@ -31,80 +31,80 @@ export default defineConfig({ }) ``` -The second case is when wildcard hosts (e.g. `0.0.0.0`) are used. This is because servers listening on non-wildcard hosts take priority over those listening on wildcard hosts. +Le deuxième cas est lorsque des hôtes génériques (par ex. `0.0.0.0`) sont utilisés. C'est parce que les serveurs écoutant sur des hôtes non génériques ont priorité sur ceux écoutant sur des hôtes génériques. ::: -::: tip Accessing the server on WSL2 from your LAN +::: tip Accéder au serveur sur WSL2 depuis votre réseau local -When running Vite on WSL2, it is not sufficient to set `host: true` to access the server from your LAN. -See [the WSL document](https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan) for more details. +Lorsque vous exécutez Vite sur WSL2, il ne suffit pas de définir `host: true` pour accéder au serveur depuis votre réseau local. +Consultez [le document WSL](https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan) pour plus de détails. ::: ## server.allowedHosts -- **Type:** `string[] | true` -- **Default:** `[]` +- **Type :** `string[] | true` +- **Défaut :** `[]` -The hostnames that Vite is allowed to respond to. -`localhost` and domains under `.localhost` and all IP addresses are allowed by default. -When using HTTPS, this check is skipped. +Les noms d'hôtes auxquels Vite est autorisé à répondre. +`localhost` et les domaines sous `.localhost` ainsi que toutes les adresses IP sont autorisés par défaut. +Lorsque vous utilisez HTTPS, cette vérification est ignorée. -If a string starts with `.`, it will allow that hostname without the `.` and all subdomains under the hostname. For example, `.example.com` will allow `example.com`, `foo.example.com`, and `foo.bar.example.com`. If set to `true`, the server is allowed to respond to requests for any hosts. +Si une chaîne commence par `.`, elle autorisera ce nom d'hôte sans le `.` et tous les sous-domaines sous ce nom d'hôte. Par exemple, `.example.com` autorisera `example.com`, `foo.example.com` et `foo.bar.example.com`. Si défini à `true`, le serveur est autorisé à répondre aux requêtes pour n'importe quel hôte. -::: details What hosts are safe to be added? +::: details Quels hôtes est-il sûr d'ajouter ? -Hosts that you have control over which IP addresses they resolve to are safe to add to the list of allowed hosts. +Les hôtes dont vous contrôlez les adresses IP sont sûrs à ajouter à la liste des hôtes autorisés. -For example, if you own a domain `vite.dev`, you can add `vite.dev` and `.vite.dev` to the list. If you don't own that domain and you cannot trust the owner of that domain, you should not add it. +Par exemple, si vous possédez un domaine `vite.dev`, vous pouvez ajouter `vite.dev` et `.vite.dev` à la liste. Si vous ne possédez pas ce domaine et que vous ne pouvez pas faire confiance au propriétaire de ce domaine, vous ne devriez pas l'ajouter. -Especially, you should never add Top-Level Domains like `.com` to the list. This is because anyone can purchase a domain like `example.com` and control the IP address it resolves to. +En particulier, vous ne devriez jamais ajouter des domaines de premier niveau comme `.com` à la liste. C'est parce que n'importe qui peut acheter un domaine comme `example.com` et contrôler l'adresse IP à laquelle il résout. ::: ::: danger -Setting `server.allowedHosts` to `true` allows any website to send requests to your dev server through DNS rebinding attacks, allowing them to download your source code and content. We recommend always using an explicit list of allowed hosts. See [GHSA-vg6x-rcgg-rjx6](https://github.com/vitejs/vite/security/advisories/GHSA-vg6x-rcgg-rjx6) for more details. +Définir `server.allowedHosts` à `true` permet à n'importe quel site web d'envoyer des requêtes à votre serveur de développement grâce à des attaques de rebinding DNS, leur permettant de télécharger votre code source et votre contenu. Nous recommandons toujours d'utiliser une liste explicite d'hôtes autorisés. Voir [GHSA-vg6x-rcgg-rjx6](https://github.com/vitejs/vite/security/advisories/GHSA-vg6x-rcgg-rjx6) pour plus de détails. ::: -::: details Configure via environment variable -You can set the environment variable `__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS` to add an additional allowed host. +::: details Configurer via une variable d'environnement +Vous pouvez définir la variable d'environnement `__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS` pour ajouter un hôte autorisé supplémentaire. ::: ## server.port -- **Type:** `number` -- **Default:** `5173` +- **Type :** `number` +- **Défaut :** `5173` -Specify server port. Note if the port is already being used, Vite will automatically try the next available port so this may not be the actual port the server ends up listening on. +Spécifie le port du serveur. Notez que si le port est déjà utilisé, Vite essaiera automatiquement le prochain port disponible, donc ce ne sera peut-être pas le port réel sur lequel le serveur finira par écouter. ## server.strictPort -- **Type:** `boolean` +- **Type :** `boolean` -Set to `true` to exit if port is already in use, instead of automatically trying the next available port. +Définissez sur `true` pour quitter si le port est déjà utilisé, au lieu d'essayer automatiquement le prochain port disponible. ## server.https -- **Type:** `https.ServerOptions` +- **Type :** `https.ServerOptions` -Enable TLS + HTTP/2. The value is an [options object](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener) passed to `https.createServer()`. +Active TLS + HTTP/2. La valeur est un [objet d'options](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener) passé à `https.createServer()`. -Note that this downgrades to TLS only when the [`server.proxy` option](#server-proxy) is also used. +Notez que cela est rétrogradé à TLS uniquement lorsque l'[option `server.proxy`](#server-proxy) est également utilisée. -A valid certificate is needed. For a basic setup, you can add [@vitejs/plugin-basic-ssl](https://github.com/vitejs/vite-plugin-basic-ssl) to the project plugins, which will automatically create and cache a self-signed certificate. But we recommend creating your own certificates. +Un certificat valide est nécessaire. Pour une configuration de base, vous pouvez ajouter [@vitejs/plugin-basic-ssl](https://github.com/vitejs/vite-plugin-basic-ssl) aux plugins du projet, qui créera et mettra en cache automatiquement un certificat auto-signé. Mais nous vous recommandons de créer vos propres certificats. ## server.open -- **Type:** `boolean | string` +- **Type :** `boolean | string` -Automatically open the app in the browser on server start. When the value is a string, it will be used as the URL's pathname. If you want to open the server in a specific browser you like, you can set the env `process.env.BROWSER` (e.g. `firefox`). You can also set `process.env.BROWSER_ARGS` to pass additional arguments (e.g. `--incognito`). +Ouvre automatiquement l'application dans le navigateur au démarrage du serveur. Lorsque la valeur est une chaîne, elle sera utilisée comme chemin de l'URL. Si vous souhaitez ouvrir le serveur dans un navigateur spécifique, vous pouvez définir la variable d'environnement `process.env.BROWSER` (par exemple `firefox`). Vous pouvez également définir `process.env.BROWSER_ARGS` pour passer des arguments supplémentaires (par exemple `--incognito`). -`BROWSER` and `BROWSER_ARGS` are also special environment variables you can set in the `.env` file to configure it. See [the `open` package](https://github.com/sindresorhus/open#app) for more details. +`BROWSER` et `BROWSER_ARGS` sont également des variables d'environnement spéciales que vous pouvez définir dans le fichier `.env` pour les configurer. Consultez [le package `open`](https://github.com/sindresorhus/open#app) pour plus de détails. -**Example:** +**Exemple :** ```js export default defineConfig({ @@ -116,27 +116,27 @@ export default defineConfig({ ## server.proxy -- **Type:** `Record` +- **Type :** `Record` -Configure custom proxy rules for the dev server. Expects an object of `{ key: options }` pairs. Any requests that request path starts with that key will be proxied to that specified target. If the key starts with `^`, it will be interpreted as a `RegExp`. The `configure` option can be used to access the proxy instance. If a request matches any of the configured proxy rules, the request won't be transformed by Vite. +Configure des règles de proxy personnalisées pour le serveur de développement. Attend un objet de paires `{ clef: options }`. Toutes les requêtes dont le chemin commence par cette clef seront redirigées vers la cible spécifiée. Si la clef commence par `^`, elle sera interprétée comme une `RegExp`. L'option `configure` peut être utilisée pour accéder à l'instance de proxy. Si une requête correspond à l'une des règles de proxy configurées, la requête ne sera pas transformée par Vite. -Note that if you are using non-relative [`base`](/config/shared-options.md#base), you must prefix each key with that `base`. +Notez que si vous utilisez une [`base`](/config/shared-options.md#base) non relative, vous devez préfixer chaque clef avec cette `base`. -Extends [`http-proxy`](https://github.com/http-party/node-http-proxy#options). Additional options are [here](https://github.com/vitejs/vite/blob/main/packages/vite/src/node/server/middlewares/proxy.ts#L13). +Étend [`http-proxy`](https://github.com/http-party/node-http-proxy#options). Options supplémentaires [ici](https://github.com/vitejs/vite/blob/main/packages/vite/src/node/server/middlewares/proxy.ts#L13). -In some cases, you might also want to configure the underlying dev server (e.g. to add custom middlewares to the internal [connect](https://github.com/senchalabs/connect) app). In order to do that, you need to write your own [plugin](/guide/using-plugins.html) and use [configureServer](/guide/api-plugin.html#configureserver) function. +Dans certains cas, vous pourriez également vouloir configurer le serveur de développement sous-jacent (par exemple pour ajouter des middlewares personnalisés à l'application interne [connect](https://github.com/senchalabs/connect)). Pour ce faire, vous devez écrire votre propre [plugin](/guide/using-plugins.html) et utiliser la fonction [configureServer](/guide/api-plugin.html#configureserver). -**Example:** +**Exemple :** ```js export default defineConfig({ server: { proxy: { - // string shorthand: + // raccourci de chaine de caractère : // http://localhost:5173/foo // -> http://localhost:4567/foo '/foo': 'http://localhost:4567', - // with options: + // avec options : // http://localhost:5173/api/bar // -> http://jsonplaceholder.typicode.com/bar '/api': { @@ -144,7 +144,7 @@ export default defineConfig({ changeOrigin: true, rewrite: (path) => path.replace(/^\/api/, ''), }, - // with RegExp: + // avec RegExp : // http://localhost:5173/fallback/ // -> http://jsonplaceholder.typicode.com/ '^/fallback/.*': { @@ -152,19 +152,19 @@ export default defineConfig({ changeOrigin: true, rewrite: (path) => path.replace(/^\/fallback/, ''), }, - // Using the proxy instance + // Utilisation de l'instance de proxy '/api': { target: 'http://jsonplaceholder.typicode.com', changeOrigin: true, configure: (proxy, options) => { - // proxy will be an instance of 'http-proxy' + // proxy sera une instance de 'http-proxy' }, }, - // Proxying websockets or socket.io: + // Proxy de websockets ou socket.io : // ws://localhost:5173/socket.io // -> ws://localhost:5174/socket.io - // Exercise caution using `rewriteWsOrigin` as it can leave the - // proxying open to CSRF attacks. + // Soyez prudent avec `rewriteWsOrigin` car cela peut laisser + // le proxy ouvert aux attaques CSRF. '/socket.io': { target: 'ws://localhost:5174', ws: true, @@ -177,65 +177,65 @@ export default defineConfig({ ## server.cors -- **Type:** `boolean | CorsOptions` -- **Default:** `{ origin: /^https?:\/\/(?:(?:[^:]+\.)?localhost|127\.0\.0\.1|\[::1\])(?::\d+)?$/ }` (allows localhost, `127.0.0.1` and `::1`) +- **Type :** `boolean | CorsOptions` +- **Défaut :** `{ origin: /^https?:\/\/(?:(?:[^:]+\.)?localhost|127\.0\.0\.1|\[::1\])(?::\d+)?$/ }` (autorise localhost, `127.0.0.1` et `::1`) -Configure CORS for the dev server. Pass an [options object](https://github.com/expressjs/cors#configuration-options) to fine tune the behavior or `true` to allow any origin. +Configure les CORS pour le serveur de développement. Passez un [objet d'options](https://github.com/expressjs/cors#configuration-options) pour affiner le comportement ou `true` pour autoriser n'importe quelle origine. ::: danger -Setting `server.cors` to `true` allows any website to send requests to your dev server and download your source code and content. We recommend always using an explicit list of allowed origins. +Définir `server.cors` à `true` permet à n'importe quel site web d'envoyer des requêtes à votre serveur de développement et de télécharger votre code source et votre contenu. Nous recommandons toujours d'utiliser une liste explicite d'origines autorisées. ::: ## server.headers -- **Type:** `OutgoingHttpHeaders` +- **Type :** `OutgoingHttpHeaders` -Specify server response headers. +Spécifie les en-têtes de réponse du serveur. ## server.hmr -- **Type:** `boolean | { protocol?: string, host?: string, port?: number, path?: string, timeout?: number, overlay?: boolean, clientPort?: number, server?: Server }` +- **Type :** `boolean | { protocol?: string, host?: string, port?: number, path?: string, timeout?: number, overlay?: boolean, clientPort?: number, server?: Server }` -Disable or configure HMR connection (in cases where the HMR websocket must use a different address from the http server). +Désactive ou configure la connexion HMR (dans les cas où le websocket HMR doit utiliser une adresse différente du serveur HTTP). -Set `server.hmr.overlay` to `false` to disable the server error overlay. +Définissez `server.hmr.overlay` à `false` pour désactiver l'overlay d'erreur du serveur. -`protocol` sets the WebSocket protocol used for the HMR connection: `ws` (WebSocket) or `wss` (WebSocket Secure). +`protocol` définit le protocole WebSocket utilisé pour la connexion HMR : `ws` (WebSocket) ou `wss` (WebSocket Secure). -`clientPort` is an advanced option that overrides the port only on the client side, allowing you to serve the websocket on a different port than the client code looks for it on. +`clientPort` est une option avancée qui remplace le port uniquement côté client, vous permettant de servir le websocket sur un port différent de celui que le code client recherche. -When `server.hmr.server` is defined, Vite will process the HMR connection requests through the provided server. If not in middleware mode, Vite will attempt to process HMR connection requests through the existing server. This can be helpful when using self-signed certificates or when you want to expose Vite over a network on a single port. +Lorsque `server.hmr.server` est défini, Vite traitera les requêtes de connexion HMR via le serveur fourni. Si ce n'est pas en mode middleware, Vite tentera de traiter les requêtes de connexion HMR via le serveur existant. Cela peut être utile lorsque vous utilisez des certificats auto-signés ou lorsque vous souhaitez exposer Vite sur un réseau via un seul port. -Check out [`vite-setup-catalogue`](https://github.com/sapphi-red/vite-setup-catalogue) for some examples. +Consultez [`vite-setup-catalogue`](https://github.com/sapphi-red/vite-setup-catalogue) pour quelques exemples. -::: tip NOTE +::: tip REMARQUE -With the default configuration, reverse proxies in front of Vite are expected to support proxying WebSocket. If the Vite HMR client fails to connect WebSocket, the client will fall back to connecting the WebSocket directly to the Vite HMR server bypassing the reverse proxies: +Avec la configuration par défaut, on s'attend à ce que les reverse proxys devant Vite prennent en charge le proxy WebSocket. Si le client HMR de Vite ne parvient pas à se connecter en WebSocket, le client retombera sur une connexion WebSocket directe au serveur HMR de Vite, contournant les reverse proxys : ``` -Direct websocket connection fallback. Check out https://vite.dev/config/server-options.html#server-hmr to remove the previous connection error. +Fallback de connexion websocket directe. Consultez https://vite.dev/config/server-options.html#server-hmr pour supprimer l'erreur de connexion précédente. ``` -The error that appears in the Browser when the fallback happens can be ignored. To avoid the error by directly bypassing reverse proxies, you could either: +L'erreur qui apparaît dans le navigateur lorsque le fallback se produit peut être ignorée. Pour éviter l'erreur en contournant directement les reverse proxys, vous pouvez soit : -- configure the reverse proxy to proxy WebSocket too -- set [`server.strictPort = true`](#server-strictport) and set `server.hmr.clientPort` to the same value with `server.port` -- set `server.hmr.port` to a different value from [`server.port`](#server-port) +- configurer le reverse proxy pour qu'il proxifie également WebSocket +- définir [`server.strictPort = true`](#server-strictport) et définir `server.hmr.clientPort` à la même valeur que `server.port` +- définir `server.hmr.port` à une valeur différente de [`server.port`](#server-port) ::: ## server.warmup -- **Type:** `{ clientFiles?: string[], ssrFiles?: string[] }` -- **Related:** [Warm Up Frequently Used Files](/guide/performance.html#warm-up-frequently-used-files) +- **Type :** `{ clientFiles?: string[], ssrFiles?: string[] }` +- **Connexe :** [Préchauffer les fichiers fréquemment utilisés](/guide/performance.html#warm-up-frequently-used-files) -Warm up files to transform and cache the results in advance. This improves the initial page load during server starts and prevents transform waterfalls. +Préchauffe les fichiers pour transformer et mettre en cache les résultats à l'avance. Cela améliore le chargement initial de la page pendant les démarrages du serveur et empêche les cascades de transformation. -`clientFiles` are files that are used in the client only, while `ssrFiles` are files that are used in SSR only. They accept an array of file paths or [`tinyglobby`](https://github.com/SuperchupuDev/tinyglobby) patterns relative to the `root`. +`clientFiles` sont des fichiers qui ne sont utilisés que dans le client, tandis que `ssrFiles` sont des fichiers qui ne sont utilisés que dans le SSR. Ils acceptent un tableau de chemins de fichiers ou de modèles [`tinyglobby`](https://github.com/SuperchupuDev/tinyglobby) relatifs à la `root`. -Make sure to only add files that are frequently used to not overload the Vite dev server on startup. +Assurez-vous de n'ajouter que les fichiers fréquemment utilisés pour ne pas surcharger le serveur de développement Vite au démarrage. ```js export default defineConfig({ @@ -250,43 +250,43 @@ export default defineConfig({ ## server.watch -- **Type:** `object | null` +- **Type :** `object | null` -File system watcher options to pass on to [chokidar](https://github.com/paulmillr/chokidar/tree/3.6.0#api). +Options de surveillance du système de fichiers à transmettre à [chokidar](https://github.com/paulmillr/chokidar/tree/3.6.0#api). -The Vite server watcher watches the `root` and skips the `.git/`, `node_modules/`, and Vite's `cacheDir` and `build.outDir` directories by default. When updating a watched file, Vite will apply HMR and update the page only if needed. +Le watcher du serveur Vite surveille le répertoire `root` et ignore par défaut les répertoires `.git/`, `node_modules/`, ainsi que le `cacheDir` de Vite et le `build.outDir`. Lors de la mise à jour d'un fichier surveillé, Vite appliquera le HMR et mettra à jour la page uniquement si nécessaire. -If set to `null`, no files will be watched. `server.watcher` will provide a compatible event emitter, but calling `add` or `unwatch` will have no effect. +Si défini à `null`, aucun fichier ne sera surveillé. `server.watcher` fournira un émetteur d'événements compatible, mais l'appel de `add` ou `unwatch` n'aura aucun effet. -::: warning Watching files in `node_modules` +::: warning Surveillance des fichiers dans `node_modules` -It's currently not possible to watch files and packages in `node_modules`. For further progress and workarounds, you can follow [issue #8619](https://github.com/vitejs/vite/issues/8619). +Il n'est actuellement pas possible de surveiller les fichiers et les packages dans `node_modules`. Pour plus de progression et de solutions de contournement, vous pouvez suivre [le ticket #8619](https://github.com/vitejs/vite/issues/8619). ::: -::: warning Using Vite on Windows Subsystem for Linux (WSL) 2 +::: warning Utilisation de Vite sur Windows Subsystem for Linux (WSL) 2 -When running Vite on WSL2, file system watching does not work when a file is edited by Windows applications (non-WSL2 process). This is due to [a WSL2 limitation](https://github.com/microsoft/WSL/issues/4739). This also applies to running on Docker with a WSL2 backend. +Lorsque vous exécutez Vite sur WSL2, la surveillance du système de fichiers ne fonctionne pas lorsqu'un fichier est modifié par des applications Windows (processus non-WSL2). Cela est dû à [une limitation de WSL2](https://github.com/microsoft/WSL/issues/4739). Cela s'applique également à l'exécution sur Docker avec un backend WSL2. -To fix it, you could either: +Pour résoudre ce problème, vous pouvez soit : -- **Recommended**: Use WSL2 applications to edit your files. - - It is also recommended to move the project folder outside of a Windows filesystem. Accessing Windows filesystem from WSL2 is slow. Removing that overhead will improve performance. -- Set `{ usePolling: true }`. - - Note that [`usePolling` leads to high CPU utilization](https://github.com/paulmillr/chokidar/tree/3.6.0#performance). +- **Recommandé** : Utiliser des applications WSL2 pour éditer vos fichiers. + - Il est également recommandé de déplacer le dossier du projet en dehors d'un système de fichiers Windows. L'accès au système de fichiers Windows depuis WSL2 est lent. Supprimer cette surcharge améliorera les performances. +- Définir `{ usePolling: true }`. + - Notez que [`usePolling` entraîne une utilisation élevée du CPU](https://github.com/paulmillr/chokidar/tree/3.6.0#performance). ::: ## server.middlewareMode -- **Type:** `boolean` -- **Default:** `false` +- **Type :** `boolean` +- **Défaut :** `false` -Create Vite server in middleware mode. +Crée le serveur Vite en mode middleware. -- **Related:** [appType](./shared-options#apptype), [SSR - Setting Up the Dev Server](/guide/ssr#setting-up-the-dev-server) +- **Connexe :** [appType](./shared-options#apptype), [SSR - Configuration du serveur de développement](/guide/ssr#setting-up-the-dev-server) -- **Example:** +- **Exemple :** ```js twoslash import express from 'express' @@ -295,20 +295,20 @@ import { createServer as createViteServer } from 'vite' async function createServer() { const app = express() - // Create Vite server in middleware mode + // Crée le serveur Vite en mode middleware const vite = await createViteServer({ server: { middlewareMode: true }, - // don't include Vite's default HTML handling middlewares + // n'inclut pas les middlewares de gestion HTML par défaut de Vite appType: 'custom', }) - // Use vite's connect instance as middleware + // Utilise l'instance connect de vite comme middleware app.use(vite.middlewares) app.use('*', async (req, res) => { - // Since `appType` is `'custom'`, should serve response here. - // Note: if `appType` is `'spa'` or `'mpa'`, Vite includes middlewares - // to handle HTML requests and 404s so user middlewares should be added - // before Vite's middlewares to take effect instead + // Puisque `appType` est `'custom'`, il faut servir la réponse ici. + // Note : si `appType` est `'spa'` ou `'mpa'`, Vite inclut des middlewares + // pour gérer les requêtes HTML et les 404, donc les middlewares utilisateur + // doivent être ajoutés avant les middlewares de Vite pour prendre effet }) } @@ -317,40 +317,40 @@ createServer() ## server.fs.strict -- **Type:** `boolean` -- **Default:** `true` (enabled by default since Vite 2.7) +- **Type :** `boolean` +- **Défaut :** `true` (activé par défaut depuis Vite 2.7) -Restrict serving files outside of workspace root. +Restreint la diffusion de fichiers en dehors de la racine de l'espace de travail. ## server.fs.allow -- **Type:** `string[]` +- **Type :** `string[]` -Restrict files that could be served via `/@fs/`. When `server.fs.strict` is set to `true`, accessing files outside this directory list that aren't imported from an allowed file will result in a 403. +Restreint les fichiers qui pourraient être servis via `/@fs/`. Lorsque `server.fs.strict` est défini à `true`, l'accès aux fichiers en dehors de cette liste de répertoires qui ne sont pas importés depuis un fichier autorisé se traduira par un 403. -Both directories and files can be provided. +Des répertoires et des fichiers peuvent être fournis. -Vite will search for the root of the potential workspace and use it as default. A valid workspace met the following conditions, otherwise will fall back to the [project root](/guide/#index-html-and-project-root). +Vite recherchera la racine de l'espace de travail potentiel et l'utilisera par défaut. Un espace de travail valide répond aux conditions suivantes, sinon il se rabattra sur la [racine du projet](/guide/#index-html-and-project-root). -- contains `workspaces` field in `package.json` -- contains one of the following file +- contient le champ `workspaces` dans `package.json` +- contient l'un des fichiers suivants - `lerna.json` - `pnpm-workspace.yaml` -Accepts a path to specify the custom workspace root. Could be a absolute path or a path relative to [project root](/guide/#index-html-and-project-root). For example: +Accepte un chemin pour spécifier la racine personnalisée de l'espace de travail. Peut être un chemin absolu ou un chemin relatif à la [racine du projet](/guide/#index-html-and-project-root). Par exemple : ```js export default defineConfig({ server: { fs: { - // Allow serving files from one level up to the project root + // Autorise la diffusion de fichiers à partir d'un niveau au-dessus de la racine du projet allow: ['..'], }, }, }) ``` -When `server.fs.allow` is specified, the auto workspace root detection will be disabled. To extend the original behavior, a utility `searchForWorkspaceRoot` is exposed: +Lorsque `server.fs.allow` est spécifié, la détection automatique de la racine de l'espace de travail sera désactivée. Pour étendre le comportement original, un utilitaire `searchForWorkspaceRoot` est exposé : ```js import { defineConfig, searchForWorkspaceRoot } from 'vite' @@ -359,11 +359,11 @@ export default defineConfig({ server: { fs: { allow: [ - // search up for workspace root + // recherche vers le haut pour la racine de l'espace de travail searchForWorkspaceRoot(process.cwd()), - // your custom rules - '/path/to/custom/allow_directory', - '/path/to/custom/allow_file.demo', + // vos règles personnalisées + '/chemin/vers/repertoire_autorise_personnalise', + '/chemin/vers/fichier_autorise_personnalise.demo', ], }, }, @@ -372,10 +372,10 @@ export default defineConfig({ ## server.fs.deny -- **Type:** `string[]` -- **Default:** `['.env', '.env.*', '*.{crt,pem}', '**/.git/**']` +- **Type :** `string[]` +- **Défaut :** `['.env', '.env.*', '*.{crt,pem}', '**/.git/**']` -Blocklist for sensitive files being restricted to be served by Vite dev server. This will have higher priority than [`server.fs.allow`](#server-fs-allow). [picomatch patterns](https://github.com/micromatch/picomatch#globbing-features) are supported. +Liste noire des fichiers sensibles qui sont restreints pour être servis par le serveur de développement Vite. Cela aura une priorité plus élevée que [`server.fs.allow`](#server-fs-allow). Les [modèles picomatch](https://github.com/micromatch/picomatch#globbing-features) sont pris en charge. ::: tip NOTE @@ -385,9 +385,9 @@ This blocklist does not apply to [the public directory](/guide/assets.md#the-pub ## server.origin -- **Type:** `string` +- **Type :** `string` -Defines the origin of the generated asset URLs during development. +Définit l'origine des URL d'assets générées pendant le développement. ```js export default defineConfig({ @@ -399,20 +399,20 @@ export default defineConfig({ ## server.sourcemapIgnoreList -- **Type:** `false | (sourcePath: string, sourcemapPath: string) => boolean` -- **Default:** `(sourcePath) => sourcePath.includes('node_modules')` +- **Type :** `false | (sourcePath: string, sourcemapPath: string) => boolean` +- **Défaut :** `(sourcePath) => sourcePath.includes('node_modules')` -Whether or not to ignore source files in the server sourcemap, used to populate the [`x_google_ignoreList` source map extension](https://developer.chrome.com/articles/x-google-ignore-list/). +Indique s'il faut ignorer les fichiers source dans la sourcemap du serveur, utilisée pour remplir l'[extension de sourcemap `x_google_ignoreList`](https://developer.chrome.com/articles/x-google-ignore-list/). -`server.sourcemapIgnoreList` is the equivalent of [`build.rollupOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) for the dev server. A difference between the two config options is that the rollup function is called with a relative path for `sourcePath` while `server.sourcemapIgnoreList` is called with an absolute path. During dev, most modules have the map and the source in the same folder, so the relative path for `sourcePath` is the file name itself. In these cases, absolute paths makes it convenient to be used instead. +`server.sourcemapIgnoreList` est l'équivalent de [`build.rollupOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) pour le serveur de développement. Une différence entre les deux options de configuration est que la fonction rollup est appelée avec un chemin relatif pour `sourcePath` tandis que `server.sourcemapIgnoreList` est appelée avec un chemin absolu. Pendant le développement, la plupart des modules ont la carte et la source dans le même dossier, donc le chemin relatif pour `sourcePath` est le nom du fichier lui-même. Dans ces cas, les chemins absolus sont plus pratiques à utiliser. -By default, it excludes all paths containing `node_modules`. You can pass `false` to disable this behavior, or, for full control, a function that takes the source path and sourcemap path and returns whether to ignore the source path. +Par défaut, il exclut tous les chemins contenant `node_modules`. Vous pouvez passer `false` pour désactiver ce comportement, ou, pour un contrôle total, une fonction qui prend le chemin source et le chemin sourcemap et retourne si le chemin source doit être ignoré. ```js export default defineConfig({ server: { - // This is the default value, and will add all files with node_modules - // in their paths to the ignore list. + // C'est la valeur par défaut, et elle ajoutera tous les fichiers avec node_modules + // dans leurs chemins à la liste d'ignorés. sourcemapIgnoreList(sourcePath, sourcemapPath) { return sourcePath.includes('node_modules') }, @@ -421,5 +421,5 @@ export default defineConfig({ ``` ::: tip Note -[`server.sourcemapIgnoreList`](#server-sourcemapignorelist) and [`build.rollupOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) need to be set independently. `server.sourcemapIgnoreList` is a server only config and doesn't get its default value from the defined rollup options. +[`server.sourcemapIgnoreList`](#server-sourcemapignorelist) et [`build.rollupOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) doivent être définis indépendamment. `server.sourcemapIgnoreList` est une configuration uniquement pour le serveur et ne récupère pas sa valeur par défaut des options rollup définies. ::: From 73d0e10709c79b48ff286fdc09fe4d183eea2939 Mon Sep 17 00:00:00 2001 From: Simon Belbeoch Date: Fri, 11 Apr 2025 17:34:44 +0200 Subject: [PATCH 29/40] traduction de why --- docs/guide/why.md | 60 +++++++++++++++++++++++------------------------ 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/guide/why.md b/docs/guide/why.md index f502685..c4d88f7 100644 --- a/docs/guide/why.md +++ b/docs/guide/why.md @@ -1,28 +1,28 @@ -# Why Vite +# Pourquoi Vite -## The Problems +## Les problèmes -Before ES modules were available in browsers, developers had no native mechanism for authoring JavaScript in a modularized fashion. This is why we are all familiar with the concept of "bundling": using tools that crawl, process and concatenate our source modules into files that can run in the browser. +Avant que les modules ES ne soient disponibles dans les navigateurs, les développeurs n'avaient aucun mécanisme natif pour écrire du JavaScript de manière modulaire. C'est pourquoi nous sommes tous familiers avec le concept de "bundling" : l'utilisation d'outils qui parcourent, traitent et concatènent nos modules source en fichiers pouvant s'exécuter dans le navigateur. -Over time we have seen tools like [webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org) and [Parcel](https://parceljs.org/), which greatly improved the development experience for frontend developers. +Au fil du temps, nous avons vu apparaître des outils comme [webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org) et [Parcel](https://parceljs.org/), qui ont considérablement amélioré l'expérience de développement pour les développeurs frontend. -However, as we build more and more ambitious applications, the amount of JavaScript we are dealing with is also increasing dramatically. It is not uncommon for large scale projects to contain thousands of modules. We are starting to hit a performance bottleneck for JavaScript based tooling: it can often take an unreasonably long wait (sometimes up to minutes!) to spin up a dev server, and even with Hot Module Replacement (HMR), file edits can take a couple of seconds to be reflected in the browser. The slow feedback loop can greatly affect developers' productivity and happiness. +Cependant, à mesure que nous construisons des applications de plus en plus ambitieuses, la quantité de JavaScript à traiter augmente également de façon spectaculaire. Il n'est pas rare que des projets à grande échelle contiennent des milliers de modules. Nous commençons à atteindre un goulet d'étranglement de performance pour les outils basés sur JavaScript : il peut souvent falloir un temps d'attente déraisonnablement long (parfois jusqu'à plusieurs minutes !) pour démarrer un serveur de développement, et même avec le remplacement de module à chaud (HMR), les modifications de fichiers peuvent prendre quelques secondes avant d'être répercutées dans le navigateur. Cette boucle de retour lente peut grandement affecter la productivité et la satisfaction des développeurs. -Vite aims to address these issues by leveraging new advancements in the ecosystem: the availability of native ES modules in the browser, and the rise of JavaScript tools written in compile-to-native languages. +Vite vise à résoudre ces problèmes en tirant parti des nouvelles avancées dans l'écosystème : la disponibilité des modules ES natifs dans le navigateur et l'essor des outils JavaScript écrits dans des langages compilés en code natif. -### Slow Server Start +### Démarrage lent du serveur -When cold-starting the dev server, a bundler-based build setup has to eagerly crawl and build your entire application before it can be served. +Lors du démarrage à froid du serveur de développement, une configuration de build basée sur un bundler doit parcourir et construire toute votre application avant qu'elle ne puisse être servie. -Vite improves the dev server start time by first dividing the modules in an application into two categories: **dependencies** and **source code**. +Vite améliore le temps de démarrage du serveur de développement en divisant d'abord les modules d'une application en deux catégories : **dépendances** et **code source**. -- **Dependencies** are mostly plain JavaScript that do not change often during development. Some large dependencies (e.g. component libraries with hundreds of modules) are also quite expensive to process. Dependencies may also be shipped in various module formats (e.g. ESM or CommonJS). +- Les **dépendances** sont principalement du JavaScript simple qui ne change pas souvent pendant le développement. Certaines dépendances volumineuses (par exemple, des bibliothèques de composants avec des centaines de modules) sont également assez coûteuses à traiter. Les dépendances peuvent également être livrées dans différents formats de modules (par exemple, ESM ou CommonJS). - Vite [pre-bundles dependencies](./dep-pre-bundling.md) using [esbuild](https://esbuild.github.io/). esbuild is written in Go and pre-bundles dependencies 10-100x faster than JavaScript-based bundlers. + Vite [pré-bundle les dépendances](./dep-pre-bundling.md) en utilisant [esbuild](https://esbuild.github.io/). esbuild est écrit en Go et pré-bundle les dépendances 10 à 100 fois plus rapidement que les bundlers basés sur JavaScript. -- **Source code** often contains non-plain JavaScript that needs transforming (e.g. JSX, CSS or Vue/Svelte components), and will be edited very often. Also, not all source code needs to be loaded at the same time (e.g. with route-based code-splitting). +- Le **code source** contient souvent du JavaScript non standard qui nécessite une transformation (par exemple, JSX, CSS ou composants Vue/Svelte), et sera modifié très fréquemment. De plus, tout le code source n'a pas besoin d'être chargé en même temps (par exemple, avec la séparation du code basée sur les routes). - Vite serves source code over [native ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules). This is essentially letting the browser take over part of the job of a bundler: Vite only needs to transform and serve source code on demand, as the browser requests it. Code behind conditional dynamic imports is only processed if actually used on the current screen. + Vite sert le code source via [ESM natif](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules). C'est essentiellement pour laisser le navigateur prendre en charge une partie du travail d'un bundler : Vite n'a besoin de transformer et de servir le code source qu'à la demande, lorsque le navigateur le demande. Le code derrière les importations dynamiques conditionnelles n'est traité que s'il est effectivement utilisé sur l'écran actuel.