diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 6470d4f..511fbf2 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,55 +1,55 @@ -# Docs Translation Contributing Guide +# Guide de contribution à la traduction de la documentation -This repo is a template for [Vite.js docs translation repositories](https://github.com/vitejs?q=docs). +Ce dépôt est un template pour les [dépôts de traduction de la documentation Vite.js](https://github.com/vitejs?q=docs). -## Creating a Translation Repo +## Création d'un dépôt de traduction -1. Click [*Use this template*](https://github.com/tony19/vite-docs-template/generate) to scaffold a new translation repo in your personal GitHub. +1. Cliquez sur [*Utiliser ce template*](https://github.com/tony19/vite-docs-template/generate) pour créer un nouveau dépôt de traduction dans votre compte GitHub personnel. -2. Configure workflow permissions (required): +2. Configurez les permissions de workflow (requis) : - - Go to your repository's "Settings" > "Actions" > "General" > "Workflow permissions" - - Select "Read and write permissions" - - Click "Save" + - Allez dans les "Settings" > "Actions" > "General" > "Workflow permissions" de votre dépôt + - Sélectionnez "Read and write permissions" + - Cliquez sur "Save" - This is a standard requirement for any GitHub Actions that need to create issues or make repository changes. Without these permissions, the action will fail with a `403 "Resource not accessible by integration"` error when trying to create issues or manage labels. + Il s'agit d'un prérequis standard pour toutes Action GitHub qui doivent créer des tickets ou apporter des modifications au dépôt. Sans ces permissions, l'action échouera avec une erreur `403 "Resource not accessible by integration"` lors de la création de tickets ou de la gestion des labels. -3. This repo uses the [`yuki-no` GitHub Action](https://github.com/Gumball12/yuki-no) to keep it in sync with changes from [Vite's `docs`](https://github.com/vitejs/vite/tree/main/docs). It creates issues in this repo to track upstream changes that need to be translated. +3. Ce dépôt utilise l'[Action GitHub `yuki-no`](https://github.com/Gumball12/yuki-no) pour le maintenir synchronisé avec les changements de la [documentation de Vite](https://github.com/vitejs/vite/tree/main/docs). Elle crée des issues dans ce dépôt pour suivre les modifications en amont qui doivent être traduites. - You must configure the following field in [`/.github/workflows/yuki-no.yml`](/.github/workflows/yuki-no.yml): + Vous devez configurer le champ suivant dans [`/.github/workflows/yuki-no.yml`](/.github/workflows/yuki-no.yml) : - * `track-from`: Set this to a recent commit hash from the head repository (vitejs/vite). This is the starting point for tracking changes - Yuki-no will only track commits after this hash. Using an old commit hash will significantly slow down the initial action run as it needs to process each historical commit. (After the first successful run, Yuki-no automatically skips previously processed commits.) + * `track-from` : définissez-le sur un hash de commit récent du dépôt principal (vitejs/vite). C'est le point de départ pour suivre les changements - Yuki-no ne suivra que les commits après ce hash. L'utilisation d'un ancien hash de commit ralentira considérablement l'exécution initiale de l'action, car elle devra traiter chaque commit historique. Après la première exécution réussie, Yuki-no ignore automatiquement les commits déjà traités. - By default, `yuki-no` uses the `github-actions` bot. If you want to use a custom bot: + Par défaut, `yuki-no` utilise le bot `github-actions`. Si vous souhaitez utiliser un bot personnalisé : - * `username` - the GitHub username of a [machine user](https://docs.github.com/en/developers/overview/managing-deploy-keys#machine-users) (e.g., `ci-bot`) - * `email` - the email associated with the GitHub username above - * `access-token` - a [personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) of the machine user (stored in a [repository secret](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository), enabling `access-token: ${{ secrets.MY_SECRET_TOKEN }}`) + * `username` - le nom d'utilisateur GitHub d'un [utilisateur machine](https://docs.github.com/en/developers/overview/managing-deploy-keys#machine-users) (par exemple, `ci-bot`) + * `email` - l'e-mail associé au nom d'utilisateur GitHub ci-dessus + * `access-token` - un [jeton d'accès personnel](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) de l'utilisateur machine (stocké dans un [secret de dépôt](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository), permettant `access-token: ${{ secrets.MY_SECRET_TOKEN }}`) - For more configuration options, see the [`yuki-no` documentation](https://github.com/Gumball12/yuki-no). + Pour plus d'options de configuration, consultez la [documentation de `yuki-no`](https://github.com/Gumball12/yuki-no). -4. Translate all user-visible strings (unless specified otherwise) in the following files to the target language: +4. Traduisez toutes les chaînes visibles par l'utilisateur (sauf indication contraire) dans les fichiers suivants vers la langue cible : - * [`/docs/.vitepress/config.ts`](/docs/.vitepress/config.ts) (the `og*`, `footer.*`, `text`, and `link` fields) + * [`/docs/.vitepress/config.ts`](/docs/.vitepress/config.ts) (les champs `og*`, `footer.*`, `text` et `link`) * [`/docs/.vitepress/theme/components/HomeSponsors.vue`](/docs/.vitepress/theme/components/HomeSponsors.vue) - * [`/docs/.vitepress/theme/composables/sponsor.ts`](https://github.com/tony19/vite-docs-template/blob/acea14e/docs/.vitepress/theme/composables/sponsor.ts#L44) (the `tier` fields) - * [`/docs/_data/team.js`](/docs/_data/team.js) (the `title` and `desc` fields) + * [`/docs/.vitepress/theme/composables/sponsor.ts`](https://github.com/tony19/vite-docs-template/blob/acea14e/docs/.vitepress/theme/composables/sponsor.ts#L44) (les champs `tier`) + * [`/docs/_data/team.js`](/docs/_data/team.js) (les champs `title` et `desc`) * `/docs/**/*.md` * [`/CONTRIBUTING.md`](/CONTRIBUTING.md) * [`/README.md`](/README.md) * `/docs/images/*.svg` - 💡 *Tips:* + 💡 *Tips :* - * *Ping the [`#docs` channel](https://discord.com/channels/804011606160703521/855049073157341234) in [Discord](https://chat.vitejs.dev) or [GitHub Discussions](https://github.com/vitejs/vite/discussions/categories/general) for others who can help with translations.* - * *Submit pull requests in your repo for this work so that collaborators can proofread the translations.* + * *Contactez le [canal `#docs`](https://discord.com/channels/804011606160703521/855049073157341234) sur [Discord](https://chat.vitejs.dev) ou les [Discussions GitHub](https://github.com/vitejs/vite/discussions/categories/general) pour trouver d'autres personnes qui peuvent aider aux traductions.* + * *Soumettez des pull requests dans votre dépôt pour ce travail afin que les collaborateurs puissent relire les traductions.* -5. Create a [pull request in Vite's main repo](https://github.com/vitejs/vite/pulls) to update the [locale links in `docs/.vitepress/config.ts`](https://github.com/vitejs/vite/blob/1e078ad1902ae980741d6920fc3a72d182fcf179/docs/.vitepress/config.ts#L55-L62), which would add the new language to the dropdown on the Vite homepage. Specifically, append to `localeLinks.items[]` an object with these keys: +5. Créez une [pull request dans le dépôt principal de Vite](https://github.com/vitejs/vite/pulls) pour mettre à jour les [liens de localisation dans `docs/.vitepress/config.ts`](https://github.com/vitejs/vite/blob/1e078ad1902ae980741d6920fc3a72d182fcf179/docs/.vitepress/config.ts#L55-L62), ce qui ajouterait la nouvelle langue au menu déroulant sur la page d'accueil de Vite. Plus précisément, ajoutez à `localeLinks.items[]` un objet avec ces clés : - - `text` - the language name in its native spelling (e.g., `Español`) - - `link` - the URL to the target site, composed of the language's [ISO 639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) as a subdomain of `https://vitejs.dev` (e.g., `https://es.vitejs.dev`) + - `text` - le nom de la langue dans son orthographe native (par exemple, `Español`) + - `link` - l'URL du site cible, composée du [code ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) de la langue comme sous-domaine de `https://vitejs.dev` (par exemple, `https://es.vitejs.dev`) - *Example for French:* + *Exemple pour le français :* ```js localeLinks: { @@ -59,6 +59,6 @@ This repo is a template for [Vite.js docs translation repositories](https://gith }, ``` -6. In the pull request's description, include the URL to your translation repo. Be prepared to [transfer the repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository) to the [`vitejs` organization](https://github.com/vitejs) upon request by the [Vite team](https://github.com/orgs/vitejs/people). The transfer automatically adds you as a collaborator on the repo. The repo will be renamed to `docs-LANGUAGE_CODE` (e.g., `docs-fr`) after the transfer. +6. Dans la description de la pull request, incluez l'URL de votre dépôt de traduction. Soyez prêt à [transférer le dépôt](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository) à l'[organisation `vitejs`](https://github.com/vitejs) à la demande de l'[équipe Vite](https://github.com/orgs/vitejs/people). Le transfert vous ajoute automatiquement en tant que collaborateur sur le dépôt. Le dépôt sera renommé en `docs-CODE_DE_LANGUE` (par exemple, `docs-fr`) après le transfert. - **Thank you for your contribution!** ❤️ + **Merci pour votre contribution !** ❤️ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f00edd9..22ed96a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,69 +1,69 @@ -# Vite Contributing Guide +# Guide de contribution à Vite -Hi! We're really excited that you're interested in contributing to Vite! Before submitting your contribution, please read through the following guide. We also suggest you read the [Project Philosophy](https://vitejs.dev/guide/philosophy) in our documentation. +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. -You can use [StackBlitz Codeflow](https://stackblitz.com/codeflow) to fix bugs or implement features. You'll see a Codeflow button on issues to start a PR to fix them. A button will also appear on PRs to review them without needing to check out the branch locally. When using Codeflow, the Vite repository will be cloned for you in an online editor, with the Vite package built in watch mode ready to test your changes. If you'd like to learn more, check out the [Codeflow docs](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 observateur (watch) prêt à tester vos modifications. Si vous souhaitez en savoir plus, consultez la [documentation Codeflow](https://developer.stackblitz.com/codeflow/what-is-codeflow). -[![Open in Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/vitejs/vite) +[![Ouvrir dans Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/vitejs/vite) -## Repo Setup +## Configuration du dépôt -To develop locally, fork the Vite repository and clone it in your local machine. The Vite repo is a monorepo using pnpm workspaces. The package manager used to install and link dependencies must be [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/). -To develop and test the core `vite` package: +Pour développer et tester le package du noyau `vite`: -1. Run `pnpm i` in Vite's root folder. +1. Executez `pnpm i`dans le dossier racine de Vite. -2. Run `pnpm run build` in Vite's root folder. +2. Executez `pnpm run build`dans le dossier racine de Vite. -3. If you are developing Vite itself, you can go to `packages/vite` and run `pnpm run dev` to automatically rebuild Vite whenever you change its code. +3. Si vous développez sur Vite en lui-même, vous pouvez aller dans `packages/vite`et lancer `pnpm run dev`pour reconstruire Vite automatiquement chaque fois que vous changez son code. -You can alternatively use [Vite.js Docker Dev](https://github.com/nystudio107/vitejs-docker-dev) for a containerized Docker setup for Vite.js development. +Vous pouvez également utiliser [Vite.js Docker Dev](https://github.com/nystudio107/vitejs-docker-dev) pour avoir un environnement Docker configuré pour le développement de Vite. -> Vite uses pnpm v8. If you are working on multiple projects with different versions of pnpm, it's recommended to enable [Corepack](https://github.com/nodejs/corepack) by running `corepack enable`. +> Vite utilise pnpm v8. Si vous travaillez sur plusieurs projets avec différentes versions de pnpm, il est recommandé d’activer [Corepack](https://github.com/nodejs/corepack) en lançant`corepack enable`. -### Ignoring commits when running `git blame` +### Ignorer les commits lors de l’exécution de `git blame` -We have a `.git-blame-ignore-revs` file to ignore formatting changes. -To make this file used by `git blame`, you need to run the following command. +Nous avons un fichier `.git-blame-ignore-revs` pour ignorer les modifications de formatage. +Pour que ce fichier soit utilisé par`git blame`, vous devez lancer la commande suivante. ```sh git config --local blame.ignoreRevsFile .git-blame-ignore-revs ``` -## Debugging +## Débogage -To use breakpoints and explore code execution, you can use the ["Run and Debug"](https://code.visualstudio.com/docs/editor/debugging) feature from VS Code. +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. Add a `debugger` statement where you want to stop the code execution. +1. Ajoutez une instruction `debugger` à l'endroit où vous souhaitez arrêter l’exécution du code. -2. Click the "Run and Debug" icon in the activity bar of the editor, which opens the [_Run and Debug view_](https://code.visualstudio.com/docs/editor/debugging#_run-and-debug-view). +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). -3. Click the "JavaScript Debug Terminal" button in the _Run and Debug view_, which opens a terminal in VS Code. +3. Cliquez sur le bouton « JavaScript Debug Terminal » dans la vue [_Run and Debug_](https://code.visualstudio.com/docs/editor/debugging#_run-and-debug-view), qui ouvre un terminal dans VS Code. -4. From that terminal, go to `playground/xxx`, and run `pnpm run dev`. +4. Depuis ce terminal, allez dans`playground/xxx`, et lancez`pnpm run dev`. -5. The execution will stop at the `debugger` statement, and you can use the [Debug toolbar](https://code.visualstudio.com/docs/editor/debugging#_debug-actions) to continue, step over, and restart the process... +5. L’exécution s’arrêtera à l’instruction`debugger`, et vous pouvez utiliser la [Barre de débogage](https://code.visualstudio.com/docs/editor/debugging#_debug-actions) pour continuer, passez à l’étape suivante, et redémarrez le processus… -### Debugging Errors in Vitest Tests Using Playwright (Chromium) +### Débogage des erreurs dans les tests de Vitest en utilisant Playwright (Chromium) -Some errors are masked and hidden away because of the layers of abstraction and sandboxed nature added by Vitest, Playwright, and Chromium. In order to see what's actually going wrong and the contents of the devtools console in those instances, follow this setup: +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. Add a `debugger` statement to the `playground/vitestSetup.ts` -> `afterAll` hook. This will pause execution before the tests quit and the Playwright browser instance exits. +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. -2. Run the tests with the `debug-serve` script command, which will enable remote debugging: `pnpm run debug-serve resolve`. +2. Lancez les tests avec la commande de script`debug-serve`, qui activera le débogage distant :`pnpm run debug-serve resolve`. -3. Wait for inspector devtools to open in your browser and the debugger to attach. +3. Attendez que le devtools de l’inspecteur s’ouvre dans votre navigateur et que le débogage soit attaché. -4. In the sources panel in the right column, click the play button to resume execution, and allow the tests to run, which will open a Chromium instance. +4. Dans le panneau des sources dans la colonne de droite, cliquez sur le bouton de lecture pour reprendre l’exécution, et permettre aux tests de s’exécuter, ce qui ouvrira une instance de Chromium. -5. Focusing the Chromium instance, you can open the browser devtools and inspect the console there to find the underlying problems. +5. En sélectionnant l’instance de Chromium, vous pouvez ouvrir les outils de développement du navigateur et inspecter la console pour trouver les problèmes sous-jacents. -6. To close everything, just stop the test process back in your terminal. +6. Pour l’arrêter, arrêtez simplement le processus de test dans votre terminal. -## Testing Vite against external packages +## Test de Vite avec des packages externes -You may wish to test your locally modified copy of Vite against another package that is built with Vite. For pnpm, after building Vite, you can use [`pnpm.overrides`](https://pnpm.io/package_json#pnpmoverrides) to do this. Note that `pnpm.overrides` must be specified in the root `package.json`, and you must list the package as a dependency in the root `package.json`: +Vous souhaiterez peut-être tester votre copie modifiée de Vite contre un autre package construit avec Vite. Pour pnpm, après avoir construit Vite, vous pouvez utiliser [`pnpm.overrides`](https://pnpm.io/package_json#pnpmoverrides)pour cela. Notez que `pnpm.overrides` doit être spécifié dans la `package.json`racine, et vous devez lister le package comme une dépendance dans la `package.json`racine : ```json { @@ -78,41 +78,41 @@ You may wish to test your locally modified copy of Vite against another package } ``` -And re-run `pnpm install` to link the package. +Et relancez `pnpm install`pour lier le package. -## Running Tests +## Exécution des tests -### Integration Tests +### Tests d’intégration -Each package under `playground/` contains a `__tests__` directory. The tests are run using [Vitest](https://vitest.dev/) + [Playwright](https://playwright.dev/) with custom integrations to make writing tests simple. The detailed setup is inside `vitest.config.e2e.js` and `playground/vitest*` files. +Chaque package sous `playground/`contient un répertoire`__tests__`. Les tests sont exécutés en utilisant [Vitest](https://vitest.dev/) + [Playwright](https://playwright.dev/) avec des intégrations personnalisées pour rendre l’écriture de tests simple. La configuration détaillée est à l’intérieur de `vitest.config.e2e.js`et des fichiers`playground/vitest*`. -Some playgrounds define variants to run the same app using different config setups. By convention, when running a test spec file in a nested folder in `__tests__`, the setup will try to use a config file named `vite.config-{folderName}.js` at the playground's root. You can see an example of variants in the [assets playground](https://github.com/vitejs/vite/tree/main/playground/assets). +Certains playgrounds définissent des variantes pour exécuter la même application avec différentes configurations. Par convention, lorsque vous exécutez un fichier de spécification de test dans un répertoire imbriqué dans`__tests__`, la configuration tentera d’utiliser un fichier de configuration nommé `vite.config-{folderName}.js` à la racine du playground. Vous pouvez voir un exemple de variantes dans le [playground des assets](https://github.com/vitejs/vite/tree/main/playground/assets). -Before running the tests, make sure that [Vite has been built](#repo-setup). On Windows, you may want to [activate Developer Mode](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) to resolve [issues with symlink creation for non-admins](https://github.com/vitejs/vite/issues/7390). Also, you may want to [set git `core.symlinks` to `true` to resolve issues with symlinks in git](https://github.com/vitejs/vite/issues/5242). +Avant d’exécuter les tests, assurez-vous que [Vite a bien été build](#repo-setup). Sur Windows, vous souhaiteriez peut-être [activer le mode Développeur](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) pour résoudre [les problèmes avec la création de liens symboliques pour les non-administrateurs](https://github.com/vitejs/vite/issues/7390). De plus, vous souhaiteriez peut-être [définir `core.symlinks` à `true`pour résoudre les problèmes avec les liens symboliques dans git](https://github.com/vitejs/vite/issues/5242). -Each integration test can be run under either dev server mode or build mode. +Chaque test d’intégration peut être exécuté soit en mode serveur, soit en mode build. -- `pnpm test` by default runs every integration test in both serve and build mode, and also unit tests. +- `pnpm test` par défaut, exécute tous les tests d’intégration dans les modes serveur et build, ainsi que les tests unitaires. -- `pnpm run test-serve` runs tests only under serve mode. +- `pnpm run test-serve`exécute les tests uniquement en mode serveur. -- `pnpm run test-build` runs tests only under build mode. +- `pnpm run test-build`exécute les tests uniquement en mode build. -- `pnpm run test-serve [match]` or `pnpm run test-build [match]` runs tests in specific packages that match the given filter. e.g. `pnpm run test-serve asset` runs tests for both `playground/asset` and `vite/src/node/__tests__/asset` under serve mode. +- `pnpm run test-serve [match]`ou `pnpm run test-build [match]` exécute les tests dans des packages spécifiques qui correspondent au filtre donné. Par exemple, `pnpm run test-serve asset` exécute les tests pour les deux `playground/asset` et `vite/src/node/__tests__/asset` sous le mode serveur. - Note package matching is not available for the `pnpm test` script, which always runs all tests. + Note : Le filtrage des packages n’est pas disponible pour le script`pnpm test`, qui exécute tous les tests. -### Unit Tests +### Tests unitaires -Other than tests under `playground/` for integration tests, packages might contain unit tests under their `__tests__` directory. Unit tests are powered by [Vitest](https://vitest.dev/). The detailed config is inside `vitest.config.ts` files. +Outre les tests sous `playground/`pour les tests d’intégration, les packages peuvent contenir des tests unitaires sous leur répertoire`__tests__`. Les tests unitaires sont alimentés par [Vitest](https://vitest.dev/). La configuration détaillée est à l’intérieur des fichiers`vitest.config.ts`. -- `pnpm run test-unit` runs unit tests under each package. +- `pnpm run test-unit`exécute les tests unitaires de chaque package. -- `pnpm run test-unit [match]` runs tests in specific packages that match the given filter. +- `pnpm run test-unit [match]`exécute les tests dans des packages spécifiques qui correspondent au filtre donné. -### Test Env and Helpers +### Environnement de test et helpers -Inside playground tests, you can import the `page` object from `~utils`, which is a Playwright [`Page`](https://playwright.dev/docs/api/class-page) instance that has already navigated to the served page of the current playground. So, writing a test is as simple as: +Dans les tests au sein de `playground/`, vous pouvez importer l’objet `page` depuis `~utils`, qui est une instance de [`Page`](https://playwright.dev/docs/api/class-page)de Playwright qui a déjà navigué vers la page servie du playground actuel. Donc, écrire un test est aussi simple que : ```js import { page } from '~utils' @@ -122,27 +122,27 @@ test('should work', async () => { }) ``` -Some common test helpers (e.g. `testDir`, `isBuild`, or `editFile`) are also available in the utils. Source code is located at `playground/test-utils.ts`. +Certains helpers communs (e.g.`testDir`, `isBuild`, ou`editFile`) sont également disponibles dans les utils. Le code source est situé dans`playground/test-utils.ts`. -Note: The test build environment uses a [different default set of Vite config](https://github.com/vitejs/vite/blob/main/playground/vitestSetup.ts#L102-L122) to skip transpilation during tests to make it faster. This may produce a different result compared to the default production build. +Note : L’environnement de test de build utilise un [ensemble de configuration de Vite différent par défaut](https://github.com/vitejs/vite/blob/main/playground/vitestSetup.ts#L102-L122) pour ignorer la transpilation pendant les tests pour rendre les tests plus rapides. Cela peut produire un résultat différent par rapport au build de production par défaut. -### Extending the Test Suite +### Étendre le jeu de tests -To add new tests, you should find a related playground to the fix or feature (or create a new one). As an example, static assets loading is tested in the [assets playground](https://github.com/vitejs/vite/tree/main/playground/assets). In this Vite app, there is a test for `?raw` imports with [a section defined in the `index.html` for it](https://github.com/vitejs/vite/blob/main/playground/assets/index.html#L121): +Pour ajouter de nouveaux tests, vous devriez trouver un playground lié à la correction ou à la fonctionnalité (ou en créer un nouveau). Par exemple, le chargement des assets statiques est testé dans le [playground des assets](https://github.com/vitejs/vite/tree/main/playground/assets). Dans cette application Vite, il y a un test pour `?rawimports` avec [une section définie dans le `index.html`pour cela](https://github.com/vitejs/vite/blob/main/playground/assets/index.html#L121) : ```html

?raw import

``` -This will be modified [with the result of a file import](https://github.com/vitejs/vite/blob/main/playground/assets/index.html#L151): +Cela sera modifié [avec le résultat d’un import de fichier](https://github.com/vitejs/vite/blob/main/playground/assets/index.html#L151) : ```js import rawSvg from './nested/fragment.svg?raw' text('.raw', rawSvg) ``` -...where the `text` util is defined as: +… où la fonction `text`est définie comme : ```js function text(el, text) { @@ -150,7 +150,7 @@ function text(el, text) { } ``` -In the [spec tests](https://github.com/vitejs/vite/blob/main/playground/assets/__tests__/assets.spec.ts#L180), the modifications to the DOM listed above are used to test this feature: +Dans les [tests de spécification](https://github.com/vitejs/vite/blob/main/playground/assets/__tests__/assets.spec.ts#L180), les modifications apportées au DOM ci-dessus sont utilisées pour tester cette fonctionnalité : ```js test('?raw import', async () => { @@ -158,118 +158,118 @@ test('?raw import', async () => { }) ``` -## Note on Test Dependencies +## Note sur les dépendances de test -In many test cases, we need to mock dependencies using `link:` and `file:` protocols. `pnpm` treats `link:` as symlinks and `file:` as hardlinks. To test dependencies as if they were copied into `node_modules`, use the `file:` protocol. Otherwise, use the `link:` protocol. +Dans de nombreux cas de test, nous avons besoin de simuler des dépendances en utilisant les protocoles `link:` et `file:`. `pnpm` Traite `link:`comme des liens symboliques et `file:`comme des lien physiques. Pour tester les dépendances comme si elles étaient copiées dans`node_modules`, utilisez le protocole`file:`. Sinon, utilisez le protocole`link:`. -For a mock dependency, make sure you add a `@vitejs/test-` prefix to the package name. This will avoid possible issues like false-positive alerts. +Pour une dépendance simulée (mockée), assurez-vous d’ajouter un préfixe `@vitejs/test-`au nom du package. Cela évitera les problèmes de faux positifs. -## Debug Logging +## Logging de débogage -You can set the `DEBUG` environment variable to turn on debugging logs (e.g. `DEBUG="vite:resolve"`). To see all debug logs, you can set `DEBUG="vite:*"`, but be warned that it will be quite noisy. You can run `grep -r "createDebugger('vite:" packages/vite/src/` to see a list of available debug scopes. +Vous pouvez définir la variable d’environnement `DEBUG`pour activer les logs de débogage (e.g.`DEBUG="vite:resolve"`). Pour voir tous les logs de débogage, vous pouvez définir`DEBUG="vite:*"`, mais soyez prévenu, cela sera assez verbeux. Vous pouvez lancer `grep -r "createDebugger('vite:" packages/vite/src/`pour voir la liste des scopes de débogage disponibles. -## Pull Request Guidelines +## Guidelines pour les PR -- Checkout a topic branch from a base branch (e.g. `main`), and merge back against that branch. +- Checkout une branche avec un sujet à partir d’une branche de base (e.g.`main`), et mergez-la vers cette branche. -- If adding a new feature: +- Si vous ajoutez une nouvelle fonctionnalité : - - Add accompanying test case. - - Provide a convincing reason to add this feature. Ideally, you should open a suggestion issue first, and have it approved before working on it. + - Ajoutez un cas de test l’accompagnant. + - Fournissez une raison convaincante pour ajouter cette fonctionnalité. Idéalement, vous devriez ouvrir un problème de suggestion d’abord, et doit avoir été approuvé avant de commencer à travailler dessus. -- If fixing a bug: +- Si vous corrigez un bug : - - If you are resolving a special issue, add `(fix #xxxx[,#xxxx])` (#xxxx is the issue id) in your PR title for a better release log (e.g. `fix: update entities encoding/decoding (fix #3899)`). - - Provide a detailed description of the bug in the PR. Live demo preferred. - - Add appropriate test coverage if applicable. + - Si vous résolvez un problème déjà spécifié, ajoutez `(fix #xxxx[,#xxxx])`(#xxxx est l’identifiant du problème) dans le titre de votre PR pour un meilleur journal de release (e.g.`fix: update entities encoding/decoding (fix #3899)`). + - Fournissez une description détaillée du bug dans la PR. Un live démo est préférable. + - Ajoutez la couverture des tests si applicable. -- It's OK to have multiple small commits as you work on the PR. GitHub can automatically squash them before merging. +- Il est OK de commiter plusieurs petites modifications tant que vous travaillez sur la PR. GitHub peut les squasher automatiquement avant de fusionner. -- Make sure tests pass! +- Assurez-vous que les tests passent ! -- No need to worry about code style as long as you have installed the dev dependencies. Modified files are automatically formatted with Prettier on commit (by invoking [Git Hooks](https://git-scm.com/docs/githooks) via [simple-git-hooks](https://github.com/toplenboren/simple-git-hooks)). +- Pas besoin de vous soucier du style de code tant que vous avez installé les dépendances de développement. Les fichiers modifiés sont automatiquement formatés avec Prettier lors du commit (en invoquant les [Git Hooks](https://git-scm.com/docs/githooks) via [simple-git-hooks](https://github.com/toplenboren/simple-git-hooks)). -- PR title must follow the [commit message convention](./.github/commit-convention.md) so that changelogs can be automatically generated. +- Le titre de la PR doit suivre la [convention de message de commit](./.github/commit-convention.md) pour que les journaux de release puissent être générés automatiquement. -## Maintenance Guidelines +## Guidelines pour la maintenance -> The following section is mostly for maintainers who have commit access, but it's helpful to go through if you intend to make non-trivial contributions to the codebase. +> La section suivante est principalement pour les mainteneurs qui ont accès au commit, mais il est utile de la parcourir si vous souhaitez faire des contributions non triviales à la base de code. -### Issue Triaging Workflow +### Workflow de tri des problèmes -### Pull Request Review Workflow +### Workflow de revue des PR -## Notes on Dependencies +## Notes sur les dépendances -Vite aims to be lightweight, and this includes being aware of the number of npm dependencies and their size. +Vite vise à être léger, et cela inclut le nombre de dépendances npm et leur taille. -We use Rollup to pre-bundle most dependencies before publishing! Therefore, most dependencies, even those used in runtime source code, should be added under `devDependencies` by default. This also creates the following constraints that we need to be aware of in the codebase. +Nous utilisons Rollup pour prébundle la plupart des dépendances avant de publier ! Par conséquent, la plupart des dépendances, même celles utilisées dans le code source en cours d’exécution, doivent être ajoutées par défaut sous`devDependencies`. Cela crée également les contraintes suivantes que nous devons être conscientes du codebase. -### Usage of `require()` +### Usage de `require()` -In some cases, we intentionally lazy-require some dependencies to improve start-up performance. However, note that we cannot use simple `require('somedep')` calls since these are ignored in ESM files, so the dependency won't be included in the bundle, and the actual dependency won't even be there when published since they are in `devDependencies`. +Dans certains cas, nous utilisons intentionnellement des dépendances de manière paresseuse (lazy load) pour améliorer les performances de démarrage. Cependant, notez que nous ne pouvons pas utiliser des appels simples `require('somedep')`dans les fichiers ESM, donc la dépendance ne sera pas incluse dans le bundle, et la dépendance réelle ne sera même pas là lorsqu’elle est publiée puisqu’elles sont dans`devDependencies`. -Instead, use `(await import('somedep')).default`. +Au lieu de cela, utilisez`(await import('somedep')).default`. -### Think Before Adding a Dependency +### Réfléchir avant d’ajouter une dépendance -Most deps should be added to `devDependencies` even if they are needed at runtime. Some exceptions are: +La plupart des dépendances devraient être ajoutées à `devDependencies` même si elles sont nécessaires au runtime. Certaines exceptions sont : -- Type packages. Example: `@types/*`. -- Deps that cannot be properly bundled due to binary files. Example: `esbuild`. -- Deps that ship their own types that are used in Vite's own public types. Example: `rollup`. +- Packages de types. Exemple :`@types/*`. +- Les dépendances qui ne peuvent pas être correctement bundlées en raison de fichiers binaires. Exemple :`esbuild`. +- Les dépendances qui livrent leurs propres types utilisés dans les types publics de Vite. Exemple :`rollup`. -Avoid deps with large transitive dependencies that result in bloated size compared to the functionality it provides. For example, `http-proxy` itself plus `@types/http-proxy` is a little over 1MB in size, but `http-proxy-middleware` pulls in a ton of dependencies that make it 7MB(!) when a minimal custom middleware on top of `http-proxy` only requires a couple of lines of code. +Évitez les grandes dépendances transitives qui entraînent une taille excessive par rapport à la fonctionnalité qu’elles fournissent. Par exemple, `http-proxy` ne fait en lui-même pas plus de 1MB mais `http-proxy-middleware` tire une tonne de dépendances qui le passent à 7 MB (!) lorsqu’un middleware personnalisé minimal sur `http-proxy` n’exige que quelques lignes de code. -### Ensure Type Support +### Assurer le support des types -Vite aims to be fully usable as a dependency in a TypeScript project (e.g. it should provide proper typings for VitePress), and also in `vite.config.ts`. This means technically a dependency whose types are exposed needs to be part of `dependencies` instead of `devDependencies`. However, this also means we won't be able to bundle it. +Vite vise à être entièrement utilisable comme dépendance dans un projet TypeScript (ex: il doit fournir des types corrects pour VitePress), et également dans`vite.config.ts`. Cela signifie techniquement que toute dépendance dont les types sont exposés doit être ajoutée à `dependencies` au lieu de`devDependencies`. Cependant, cela signifie également que nous ne pourrons pas le lier. -To get around this, we inline some of these dependencies' types in `packages/vite/src/types`. This way, we can still expose the typing but bundle the dependency's source code. +Pour contourner cela, nous intégrons certains types de ces dépendances dans `packages/vite/src/types`. De cette façon, nous pouvons toujours exposer les types, mais lier le code source de la dépendance. -Use `pnpm run build-types-check` to check that the bundled types do not rely on types in `devDependencies`. +Utilisez `pnpm run build-types-check` pour vérifier que les types liés ne dépendent pas de types dans`devDependencies`. -For types shared between client and node, they should be added into `packages/vite/types`. These types are not bundled and are published as is (though they are still considered internal). Dependency types within this directory (e.g. `packages/vite/types/chokidar.d.ts`) are deprecated and should be added to `packages/vite/src/types` instead. +Pour les types partagés entre le client et node, ils doivent être ajoutés dans`packages/vite/types`. Ces types ne sont pas liés et sont publiés tels quels (bien qu’ils soient toujours considérés comme internes). Les types de dépendances dans ce répertoire (ex:`packages/vite/types/chokidar.d.ts`) sont obsolètes et doivent être ajoutés à `packages/vite/src/types` à la place. -### Think Before Adding Yet Another Option +### Réflechissez avant d’ajouter encore une option -We already have many config options, and we should avoid fixing an issue by adding yet another one. Before adding an option, consider whether the problem: +Nous avons déjà de nombreuses options de configuration et nous devons éviter de résoudre un problème en ajoutant une autre option. Avant d’ajouter une option, demandez-vous si le problème : -- is really worth addressing -- can be fixed with a smarter default -- has workaround using existing options -- can be addressed with a plugin instead +- est vraiment digne d’attention +- peut être résolu avec une valeur par défaut plus élégante +- a une solution de contournement utilisant des options existantes +- peut être résolu avec un plugin au lieu d’une option ## Release -If you have publish access, the steps below explain how to cut a release for a package. There are two phases for the release step: "Release" and "Publish". +Si vous avez accès à la publication, les étapes ci-dessous expliquent comment couper une release pour un package. Il y a deux phases pour la procédure de release : « Release » et « Publish ». -"Release" is done locally to generate the changelogs and git tags: +« Release » est fait localement pour générer les journaux de release et les tags git : -1. Make sure the git remote for https://github.com/vitejs/vite is set as `origin`. -2. In the `vite` project root `main` branch, run `git pull` and `pnpm i` to get it up-to-date. -3. Run `pnpm release` and follow the prompts to cut a release for a package. It will generate the changelog, a git release tag, and push them to `origin`. You can run with the `--dry` flag to test it out. -4. When the command finishes, it will provide a link to https://github.com/vitejs/vite/actions/workflows/publish.yml. -5. Click the link to visit the page, and follow the next steps below. +1. Assurez-vous que le remote git pour https://github.com/vitejs/vite est défini comme `origin`. +2. Dans le répertoire racine du projet `vite`, branche `main`, exécutez `git pull` et `pnpm i`pour le mettre à jour. +3. Exécutez `pnpm release` et suivez les invites pour couper une release pour un package. Il générera le journal de release, un tag git et les poussera à `origin` . Vous pouvez lancer avec le flag `--dry` pour tester. +4. Quand la commande est terminée, il fournira un lien vers https://github.com/vitejs/vite/actions/workflows/publish.yml. +5. Cliquez sur le lien pour visiter la page, et suivez les étapes ci-dessous. -"Publish" is done on GitHub Actions to publish the package to npm: +« Publish » est fait sur GitHub Actions pour publier le package à npm : -1. Shortly in the workflows page, a new workflow will appear for the released package and is waiting for approval to publish to npm. -2. Click on the workflow to open its page. -3. Click on the "Review deployments" button in the yellow box, a popup will appear. -4. Check "Release" and click "Approve and deploy". -5. The package will start publishing to npm. +1. Quelques instants après la commande, un nouveau workflow apparaîtra pour le package publié et sera en attente d’approbation pour publier sur npm. +2. Cliquez sur le workflow pour ouvrir sa page. +3. Cliquez sur le bouton « Review deployments » dans la boîte jaune, une fenêtre popup apparaîtra. +4. Vérifiez « Release » et cliquez sur « Approve and deploy ». +5. Le package commencera à être publié sur npm. -## Docs Translation Contribution +## Contribution à la traduction des docs -To add a new language to the Vite docs, see [`vite-docs-template`](https://github.com/tony19/vite-docs-template/blob/main/.github/CONTRIBUTING.md). +Pour ajouter une nouvelle langue aux docs de Vite, voir[`vite-docs-template`](https://github.com/tony19/vite-docs-template/blob/main/.github/CONTRIBUTING.md). diff --git a/README.md b/README.md index c735a61..e9bb5a0 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,6 @@ - -## This repo is a template for [Vite.js docs translation repositories](https://github.com/vitejs?q=docs). See [guide](/.github/CONTRIBUTING.md). - ----

- - Vite logo + + 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 (/vit/ à prononcer comme en français) 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://fr.vite.dev/guide/features.html) et un système de [Hot Module Replacement (HMR)](https://fr.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://fr.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://fr.vite.dev/guide/api-plugin.html) et son [API JavaScript](https://fr.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://fr.vite.dev). ## Packages -| Package | Version (click for changelogs) | +| Package | 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). diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 24dfc2a..acf5f57 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -9,7 +9,7 @@ import llmstxt from 'vitepress-plugin-llms' import type { PluginOption } from 'vite' import { buildEnd } from './buildEnd.config' -const ogDescription = 'Next Generation Frontend Tooling' +const ogDescription = 'outil Frontend de nouvelle génération' const ogImage = 'https://vite.dev/og-image.jpg' const ogTitle = 'Vite' const ogUrl = 'https://vite.dev' @@ -41,19 +41,19 @@ const additionalTitle = ((): string => { const versionLinks = ((): DefaultTheme.NavItemWithLink[] => { const oldVersions: DefaultTheme.NavItemWithLink[] = [ { - text: 'Vite 5 Docs', + text: 'Doc Vite 5', link: 'https://v5.vite.dev', }, { - text: 'Vite 4 Docs', + text: 'Doc Vite 4', link: 'https://v4.vite.dev', }, { - text: 'Vite 3 Docs', + text: 'Doc Vite 3', link: 'https://v3.vite.dev', }, { - text: 'Vite 2 Docs', + text: 'Doc Vite 2', link: 'https://v2.vite.dev', }, ] @@ -63,7 +63,7 @@ const versionLinks = ((): DefaultTheme.NavItemWithLink[] => { case 'local': return [ { - text: 'Vite 6 Docs (release)', + text: 'Doc Vite 6 (release)', link: 'https://vite.dev', }, ...oldVersions, @@ -136,14 +136,14 @@ export default defineConfig({ pt: { label: 'Português', link: 'https://pt.vite.dev' }, ko: { label: '한국어', link: 'https://ko.vite.dev' }, de: { label: 'Deutsch', link: 'https://de.vite.dev' }, + fr: { label: 'Français', link: 'https://fr.vite.dev' }, }, - themeConfig: { logo: '/logo.svg', editLink: { pattern: 'https://github.com/vitejs/vite/edit/main/docs/:path', - text: 'Suggest changes to this page', + text: 'Suggestions pour cette page', }, socialLinks: [ @@ -159,7 +159,7 @@ export default defineConfig({ apiKey: '208bb9c14574939326032b937431014b', indexName: 'vitejs', searchParameters: { - facetFilters: ['tags:en'], + facetFilters: ['tags:fr'], }, }, @@ -169,7 +169,7 @@ export default defineConfig({ }, footer: { - message: `Released under the MIT License. (${commitRef})`, + message: `Publié sous la licence MIT. (${commitRef})`, copyright: 'Copyright © 2019-present VoidZero Inc. & Vite Contributors', }, @@ -178,9 +178,9 @@ export default defineConfig({ { text: 'Config', link: '/config/', activeMatch: '/config/' }, { text: 'Plugins', link: '/plugins/', activeMatch: '/plugins/' }, { - text: 'Resources', + text: 'Ressources', items: [ - { text: 'Team', link: '/team' }, + { text: 'Équipe', link: '/team' }, { text: 'Blog', link: '/blog' }, { text: 'Releases', link: '/releases' }, { @@ -218,7 +218,7 @@ export default defineConfig({ link: 'https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md', }, { - text: 'Contributing', + text: 'Contribuer', link: 'https://github.com/vitejs/vite/blob/main/CONTRIBUTING.md', }, ], @@ -237,15 +237,15 @@ export default defineConfig({ text: 'Introduction', items: [ { - text: 'Getting Started', + text: 'Commencer', link: '/guide/', }, { - text: 'Philosophy', + text: 'Philosophie', link: '/guide/philosophy', }, { - text: 'Why Vite', + text: 'Pourquoi Vite', link: '/guide/why', }, ], @@ -254,7 +254,7 @@ export default defineConfig({ text: 'Guide', items: [ { - text: 'Features', + text: 'Fonctionnalités', link: '/guide/features', }, { @@ -262,39 +262,39 @@ export default defineConfig({ link: '/guide/cli', }, { - text: 'Using Plugins', + text: 'Utiliser les plugins', link: '/guide/using-plugins', }, { - text: 'Dependency Pre-Bundling', + text: 'Pré-bundling des dépendances', link: '/guide/dep-pre-bundling', }, { - text: 'Static Asset Handling', + text: 'Gestion des ressources statiques', link: '/guide/assets', }, { - text: 'Building for Production', + text: 'Construction pour la production', link: '/guide/build', }, { - text: 'Deploying a Static Site', + text: 'Déployer un site statique', link: '/guide/static-deploy', }, { - text: 'Env Variables and Modes', + text: 'Variables d‘environnement et modes', link: '/guide/env-and-mode', }, { - text: 'Server-Side Rendering (SSR)', + text: 'Rendu côté serveur (SSR)', link: '/guide/ssr', }, { - text: 'Backend Integration', + text: 'Intégration avec le backend', link: '/guide/backend-integration', }, { - text: 'Troubleshooting', + text: 'Résolution des problèmes', link: '/guide/troubleshooting', }, { @@ -306,11 +306,11 @@ export default defineConfig({ link: '/guide/rolldown', }, { - text: 'Migration from v5', + text: 'Migration depuis v5', link: '/guide/migration', }, { - text: 'Breaking Changes', + text: 'Changements cassants', link: '/changes/', }, ], @@ -319,32 +319,32 @@ export default defineConfig({ text: 'APIs', items: [ { - text: 'Plugin API', + text: 'API des plugins', link: '/guide/api-plugin', }, { - text: 'HMR API', + text: 'API HMR', link: '/guide/api-hmr', }, { - text: 'JavaScript API', + text: 'API JavaScript', link: '/guide/api-javascript', }, { - text: 'Config Reference', + text: 'Référence de configuration', link: '/config/', }, ], }, { - text: 'Environment API', + text: 'API d‘environnement', items: [ { text: 'Introduction', link: '/guide/api-environment', }, { - text: 'Environment Instances', + text: 'Instances d‘environnement', link: '/guide/api-environment-instances', }, { @@ -356,7 +356,7 @@ export default defineConfig({ link: '/guide/api-environment-frameworks', }, { - text: 'Runtimes', + text: 'Runtime', link: '/guide/api-environment-runtimes', }, ], @@ -367,35 +367,35 @@ export default defineConfig({ text: 'Config', items: [ { - text: 'Configuring Vite', + text: 'Configurer Vite', link: '/config/', }, { - text: 'Shared Options', + text: 'Options partagées', link: '/config/shared-options', }, { - text: 'Server Options', + text: 'Options serveur', link: '/config/server-options', }, { - text: 'Build Options', + text: 'Options de build', link: '/config/build-options', }, { - text: 'Preview Options', + text: 'Options de prévisualisation', link: '/config/preview-options', }, { - text: 'Dep Optimization Options', + text: 'Options d‘optimisation de dépendances', link: '/config/dep-optimization-options', }, { - text: 'SSR Options', + text: 'Options SSR', link: '/config/ssr-options', }, { - text: 'Worker Options', + text: 'Options worker', link: '/config/worker-options', }, ], @@ -403,40 +403,40 @@ export default defineConfig({ ], '/changes/': [ { - text: 'Breaking Changes', + text: 'Changements cassants', link: '/changes/', }, { - text: 'Current', + text: 'Actuels', items: [], }, { - text: 'Future', + text: 'Futurs', items: [ { - text: 'this.environment in Hooks', + text: 'this.environment dans les hooks', link: '/changes/this-environment-in-hooks', }, { - text: 'HMR hotUpdate Plugin Hook', + text: 'HMR hook hotUpdate Plugin', link: '/changes/hotupdate-hook', }, { - text: 'Move to per-environment APIs', + text: 'Passer à des APIs par environnement', link: '/changes/per-environment-apis', }, { - text: 'SSR using ModuleRunner API', + text: 'SSR avec ModuleRunner API', link: '/changes/ssr-using-modulerunner', }, { - text: 'Shared plugins during build', + text: 'Plugins partagés lors du build', link: '/changes/shared-plugins-during-build', }, ], }, { - text: 'Past', + text: 'Passés', items: [], }, ], diff --git a/docs/_data/team.js b/docs/_data/team.js index 07dc3ce..54578da 100644 --- a/docs/_data/team.js +++ b/docs/_data/team.js @@ -2,10 +2,10 @@ export const core = [ { avatar: 'https://www.github.com/yyx990803.png', name: 'Evan You', - title: 'Creator', + title: 'Créateur', org: 'Vue.js', orgLink: 'https://vuejs.org/', - desc: 'Independent open source developer, creator of Vue.js and Vite.', + desc: 'Développeur open source indépendant, créateur de Vue.js et Vite.', links: [ { icon: 'github', link: 'https://github.com/yyx990803' }, { icon: 'x', link: 'https://x.com/youyuxi' }, @@ -16,10 +16,10 @@ export const core = [ { avatar: 'https://www.github.com/patak-dev.png', name: 'Patak', - title: 'A collaborative being', + title: 'Un être collaboratif', org: 'StackBlitz', orgLink: 'https://stackblitz.com/', - desc: 'Core team member of Vite. Team member of Vue.', + desc: 'Core member de Vite. Membre de Vue.', links: [ { icon: 'github', link: 'https://github.com/patak-dev' }, { icon: 'bluesky', link: 'https://bsky.app/profile/patak.dev' }, @@ -30,10 +30,10 @@ export const core = [ { avatar: 'https://www.github.com/antfu.png', name: 'Anthony Fu', - title: 'A fanatical open sourceror', + title: 'Open sourcier fanatique', org: 'NuxtLabs', orgLink: 'https://nuxtlabs.com/', - desc: 'Core team member of Vite & Vue. Working at NuxtLabs.', + desc: 'Core member de Vite & Vue. Travaille à NuxtLabs.', links: [ { icon: 'github', link: 'https://github.com/antfu' }, { icon: 'bluesky', link: 'https://bsky.app/profile/antfu.me' }, @@ -44,8 +44,8 @@ export const core = [ { avatar: 'https://github.com/bluwy.png', name: 'Bjorn Lu', - title: 'Open Source Developer', - desc: 'Building tools for fun.', + title: 'Développeur open source', + desc: 'Création d\'outillages pour le plaisir.', links: [ { icon: 'github', link: 'https://github.com/bluwy' }, { icon: 'bluesky', link: 'https://bsky.app/profile/bluwy.me' }, @@ -57,8 +57,8 @@ export const core = [ { avatar: 'https://github.com/sapphi-red.png', name: 'green', - title: 'Web Developer', - desc: 'Vite core team member. Call me sapphi or green or midori ;)', + title: 'Développeur web', + desc: 'Core member de Vite. Appellez-moi sapphi ou green ou midori ;)', links: [ { icon: 'github', link: 'https://github.com/sapphi-red' }, { icon: 'bluesky', link: 'https://bsky.app/profile/sapphi.red' }, @@ -70,8 +70,8 @@ export const core = [ { avatar: 'https://github.com/ArnaudBarre.png', name: 'Arnaud Barré', - title: 'Frontend Developer', - desc: 'Passionate by tooling around TypeScript and React.', + title: 'Développeur frontend', + desc: 'Passionné par les outils autour de TypeScript et React.', links: [ { icon: 'github', link: 'https://github.com/ArnaudBarre' }, { @@ -85,8 +85,8 @@ export const core = [ { avatar: 'https://github.com/dominikg.png', name: 'Dominik G.', - title: 'Resident CI Expert', - desc: 'Team Member of Vite and Svelte', + title: 'Expert CI spécialiste', + desc: 'Membre de Vite et Svelte', links: [ { icon: 'github', link: 'https://github.com/dominikg' }, { icon: 'mastodon', link: 'https://elk.zone/m.webtoo.ls/@dominikg' }, @@ -96,8 +96,8 @@ export const core = [ { avatar: 'https://github.com/sheremet-va.png', name: 'Vladimir', - title: 'Core team member of Vitest & Vite', - desc: 'An open source fullstack developer', + title: 'Core member de Vitest & Vite', + desc: 'Un développeur fullstack open source', links: [ { icon: 'github', link: 'https://github.com/sheremet-va' }, { icon: 'bluesky', link: 'https://bsky.app/profile/erus.dev' }, @@ -108,8 +108,8 @@ export const core = [ { avatar: 'https://github.com/hi-ogawa.png', name: 'Hiroshi Ogawa', - title: 'Team Member of Vitest & Vite', - desc: 'Open source enthusiast', + title: 'Membre de Vitest & Vite', + desc: 'Enthousiaste de l\'open source', links: [ { icon: 'github', link: 'https://github.com/hi-ogawa' }, { icon: 'bluesky', link: 'https://bsky.app/profile/hiogawa.bsky.social' }, @@ -119,7 +119,7 @@ export const core = [ { avatar: 'https://github.com/btea.png', name: 'btea', - title: 'Web Developer', + title: 'Développeur web', links: [{ icon: 'github', link: 'https://github.com/btea' }], }, ] @@ -129,7 +129,7 @@ export const emeriti = [ avatar: 'https://i.imgur.com/KMed6rQ.jpeg', name: 'Alec Larson', title: 'Entrepreneur', - desc: 'Dabbling in social ecommerce, meta frameworks, and board games', + desc: 'Un entrepreneur qui aime les méta-frameworks et les jeux de société', links: [ { icon: 'github', link: 'https://github.com/aleclarson' }, { icon: 'x', link: 'https://x.com/retropragma' }, @@ -142,8 +142,8 @@ export const emeriti = [ { avatar: 'https://github.com/poyoho.png', name: 'yoho', - title: 'Frontend Developer', - desc: 'Frontend. Vite team member.', + title: 'Développeur frontend', + desc: 'Frontend. Code member de Vite.', links: [ { icon: 'github', link: 'https://github.com/poyoho' }, { icon: 'x', link: 'https://x.com/yoho_po' }, @@ -152,8 +152,8 @@ export const emeriti = [ { avatar: 'https://github.com/ygj6.png', name: 'ygj6', - title: 'Developer', - desc: 'Web Developer. Vue & Vite team member', + title: 'Développeur', + desc: 'Développeur web. Membre de Vue & Vite.', links: [ { icon: 'github', link: 'https://github.com/ygj6' }, { icon: 'x', link: 'https://x.com/ygj_66' }, @@ -162,7 +162,7 @@ export const emeriti = [ { avatar: 'https://github.com/Niputi.png', name: 'Niputi', - title: 'Developer', + title: 'Développeur', org: 'Computershare Denmark', desc: 'weeb/javascript lover.', links: [ @@ -174,13 +174,13 @@ export const emeriti = [ { avatar: 'https://github.com/underfin.png', name: 'underfin', - title: 'Developer', + title: 'Développeur', links: [{ icon: 'github', link: 'https://github.com/underfin' }], }, { avatar: 'https://github.com/GrygrFlzr.png', name: 'GrygrFlzr', - title: 'Developer', + title: 'Développeur', links: [ { icon: 'github', link: 'https://github.com/GrygrFlzr' }, { icon: 'bluesky', link: 'https://bsky.app/profile/bsky.cybeast.dev' }, @@ -189,16 +189,16 @@ export const emeriti = [ { avatar: 'https://github.com/nihalgonsalves.png', name: 'Nihal Gonsalves', - title: 'Senior Software Engineer', + title: 'Ingénieur logiciel senior', links: [{ icon: 'github', link: 'https://github.com/nihalgonsalves' }], }, { avatar: 'https://github.com/Shinigami92.png', name: 'Shinigami', - title: 'Senior Frontend Engineer', + title: 'Ingénieur Frontend senior', org: 'Faker', orgLink: 'https://fakerjs.dev', - desc: 'Passionate TypeScript enthusiast working extensively with Vue SPA.', + desc: 'Passionné par le TypeScript. Travaille avec des SPA Vue.', links: [ { icon: 'github', link: 'https://github.com/Shinigami92' }, { icon: 'mastodon', link: 'https://elk.zone/mas.to/@Shini92' }, @@ -207,10 +207,10 @@ export const emeriti = [ { avatar: 'https://github.com/haoqunjiang.png', name: 'Haoqun Jiang', - title: 'Core Team Member', + title: 'Membre de la Core Team', org: 'Vue.js', orgLink: 'https://vuejs.org/', - desc: 'Curator of best practices for Vue.js tooling', + desc: 'Garant des meilleures pratiques pour le tooling Vue.js', links: [ { icon: 'github', link: 'https://github.com/haoqunjiang' }, { icon: 'bluesky', link: 'https://bsky.app/profile/haoqun.dev' }, 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/blog/announcing-vite2.md b/docs/blog/announcing-vite2.md index 47ee96d..535151f 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 de Vite 2.0 - - meta - property: og:url - content: https://vite.dev/blog/announcing-vite2 + content: https://fr.vite.dev/blog/announcing-vite2 - - meta - property: og:description - content: Vite 2 Release Announcement + content: Annonce de la sortie de Vite 2 --- # 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://fr.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://fr.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://fr.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://fr.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/). diff --git a/docs/blog/announcing-vite3.md b/docs/blog/announcing-vite3.md index efb3be8..e528a1c 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,50 +10,50 @@ 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 + content: https://fr.vite.dev/og-image-announcing-vite3.png - - meta - property: og:url - content: https://vite.dev/blog/announcing-vite3 + content: https://fr.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://fr.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://fr.vite.dev/guide/why.html). Ensuite, consultez [le guide de démarrage](https://fr.vite.dev/guide/) et le [Guide des fonctionnalités](https://fr.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://fr.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://fr.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 :