⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
We can register hooks on certain life cycle events.
+Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. ```js nuxt.plugin('build', builder => { @@ -20,12 +20,12 @@ nuxt.plugin('build', builder => { }) ``` -Plugin | Arguments | When ----------------------|-----------------------------------------|-------------------------------------------------------------------------------- -`build` | builder | First build started -`built` | builder | First build finished -`extendRoutes` | {routes, templateVars, r} | Generating routes -`generate` | {builder, templatesFiles, templateVars} | Generating `.nuxt` template files -`done` | {builder, stats} | Webpack build was done -`compile` | {builder, compiler} | Before webpack compile (compiler is a MultiCompiler instance) -`compiled` | builder | Webpack build finished +Plugin | Arguments | Quand +---------------|-----------------------------------------|------------------------------------------------------------------------------- +`build` | builder | Au démarrage du premier build +`built` | builder | À la fin du premier build +`extendRoutes` | {routes, templateVars, r} | À la génération des routes +`generate` | {builder, templatesFiles, templateVars} | À la génération des fichiers template `.nuxt` +`done` | {builder, stats} | Quand les builds webpack sont finis +`compile` | {builder, compiler} | Avant la compilation webpack (le compilateur est une instance `MultiCompiler`) +`compiled` | builder | À la fin du build webpack diff --git a/en/api/internals-generator.md b/en/api/internals-generator.md index aca309d68..f1fb69167 100644 --- a/en/api/internals-generator.md +++ b/en/api/internals-generator.md @@ -1,16 +1,15 @@ --- -title: "API: The Generator Class" -description: Nuxt Generator Class +title: "API : la classe Generator" +description: La classe `Generator` de Nuxt --- -# Generator Class (En) +# La classe Generator -- Source: **[builder/generator.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/generator.js)** +- Source : **[builder/generator.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/generator.js)** +## Plugins Tapable -## Tapable plugins - -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
We can register hooks on certain life cycle events.
+Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. ```js nuxt.plugin('generator', generator => { @@ -20,7 +19,7 @@ nuxt.plugin('generator', generator => { }) ``` -Plugin | Arguments | When ----------------------|-----------------------------------------|-------------------------------------------------------------------------------- -`generateRoutes` | {generator, generateRoutes} | After resolving routes to generate so we have change to customize them -`generate` | {generator, routes} | Just before start generating routes. routes are decorated with payloads +Plugin | Arguments | Quand +-----------------|-----------------------------|------------------------------------------------------------------------------------------------- +`generateRoutes` | {generator, generateRoutes} | Après la résolution des routes pour génération afin de faire des changements personnalisés +`generate` | {generator, routes} | Avant le démarrage de la génération des routes. Les routes sont décorées avec des charges utiles diff --git a/en/api/internals-module-container.md b/en/api/internals-module-container.md index a34a7da82..be763f33d 100644 --- a/en/api/internals-module-container.md +++ b/en/api/internals-module-container.md @@ -1,76 +1,78 @@ --- -title: "API: The ModuleContainer Class" -description: Nuxt ModuleContainer Class +title: "API : la classe ModuleContainer" +description: La classe `ModuleContainer` de Nuxt --- -# ModuleContainer Class (En) +# Classe ModuleContainer -- Source: **[core/module.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/module.js)** +- Source : **[core/module.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/module.js)** -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
All [modules](/guide/modules) will be called within context of ModuleContainer instance.
+Tous les [modules](/guide/modules) seront appelés dans le contexte de l'instance de `ModuleContainer`. -## Tapable plugins +## Plugins Tapable -We can register hooks on certain life cycle events. +Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. ```js nuxt.moduleContainer.plugin('ready', async moduleContainer => { - // Do this after all modules where ready + // Faire ceci après que tous les modules soient prêts }) ``` -Inside [modules](/guide/modules) context we can use this instead: +Dans le contexte des [modules](/guide/modules) nous pouvons utiliser ceci à la place : ```js this.plugin('ready', async moduleContainer => { - // Do this after all modules where ready + // Faire ceci après que tous les modules soient prêts }) ``` -Plugin | Arguments | When ----------------------|---------------------------|-------------------------------------------------------------- -`ready` | moduleContainuer | All modules in `nuxt.config.js` has been initialized +Plugin | Arguments | Quand +--------|-----------------|----------------------------------------------------------- +`ready` | moduleContainer | Tous les modules dans `nuxt.config.js` ont été initialisés -## Methods +## Méthodes ### addVendor (vendor) -Adds to `options.build.vendor` and apply unique filter. + +Ajoute à `options.build.vendor` et applique un filtre unique. ### addTemplate (template) -- **template**: String Or Object - - src - - options - - fileName -Renders given template using [lodash template](https://lodash.com/docs/4.17.4#template) during build into project `buildDir` (`.nuxt`). +- **template**: `String` ou `Object` + - `src` + - `options` + - `fileName` + +Le rendu des templates sont faits dans le projet `buildDir` (`.nuxt`) en utilisant [lodash template](https://lodash.com/docs/4.17.4#template). -If `fileName` is not provided or template is string, target file name defaults to `[dirName].[fileName].[pathHash].[ext]` +Si `fileName` n'est pas fourni ou que `template` est une chaine de caractères, le fichier ciblé par défaut sera `[dirName].[fileName].[pathHash].[ext]`. -This method returns final `{ dist, src, options }` object. +Cette méthode retourne un objet final `{ dist, src, options }`. ### addPlugin (template) -Registers a plugin using `addTemplate` and adds it to first of `plugins[]` option. -You can use `template.ssr: false` to disable plugin including in SSR bundle. +Enregistre un plugin en utilisant `addTemplate` et l'ajoute en premier à la liste des options de `plugins[]`. + +Vous pouvez utiliser `template.ssr: false` pour désactiver les plugins inclus dans le paquetage SSR. ### addServerMiddleware (middleware) -Pushes middleware into [options.serverMiddleware](/api/configuration-servermiddleware). +Pousse le middleware dans [options.serverMiddleware](/api/configuration-servermiddleware). ### extendBuild (fn) -Allows easily extending webpack build config by chaining [options.build.extend](/api/configuration-build#extend) function. +Permet d'étendre facilement la configuration de build webpack en chainant la fonction [options.build.extend](/api/configuration-build#extend). ### extendRoutes (fn) -Allows easily extending routes by chaining [options.build.extendRoutes](/api/configuration-router#extendroutes) function. +Permet d'étendre facilement les routes en chainant la fonction [options.build.extendRoutes](/api/configuration-router#extendroutes). -### addModule (moduleOpts, requireOnce) +### addModule (moduleOpts, requireOnce) -Registers module. moduleOpts can be string or `[src, options]`. -If `requireOnce` is `true` and resolved module exports `meta` prevents registering same module twice. +Enregistre le module. `moduleOpts` peut être une chaine de caractères ou `[src, options]`. Si `requireOnce` est `true`, les modules résolus `meta` préviennent l'enregistrement du même module plus d'une fois. ### requireModule (moduleOpts) -Is shortcut to `addModule(moduleOpts, true)` +C'est un alias raccourci de `addModule(moduleOpts, true)` diff --git a/en/api/internals-nuxt.md b/en/api/internals-nuxt.md index 76e9c035d..2ba9c97ae 100644 --- a/en/api/internals-nuxt.md +++ b/en/api/internals-nuxt.md @@ -1,28 +1,27 @@ --- -title: "API: The Nuxt Class" -description: Nuxt Core Class +title: "API : la classe Nuxt" +description: La classe cœur Nuxt --- -# Nuxt Class (En) +# La classe Nuxt -- Source: **[core/nuxt.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/nuxt.js)** +- Source : **[core/nuxt.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/nuxt.js)** -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
This is the core container which allows all modules and classes communicate with each other. -All modules has access to nuxt instance using `this.nuxt`.
+C'est le conteneur cœur qui permet à tous les modules et classes de communiquer les uns avec les autres. Tous les modules ont accès à l'instance de Nuxt en utilisant `this.nuxt`. -## Tapable plugins +## Plugins Tapable -We can register hooks on certain life cycle events. +Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. ```js nuxt.plugin('ready', async nuxt => { - // Your custom code here + // Votre code personnalisé ici }) ``` -Plugin | Arguments | When ---------------|------------------------|-------------------------------------------------------------------------------- -`ready` | nuxt | All modules initialized and before initializing renderer -`error` | error args | An unhandled error by one of nuxt modules caught -`close` | - | Nuxt instance is gracefully closing -`listen` | ({server, host, port}) | Nuxt **Internal** server starts listening. (Using `nuxt start` or `nuxt dev`) +Plugin | Arguments | Quand +---------|------------------------|----------------------------------------------------------------------------------------- +`ready` | nuxt | Après l'initialisation de tous les modules et avant l'initialisation du moteur de rendu +`error` | error args | Une erreur non gérée par un des modules Nuxt attrapée +`close` | - | L'instance de Nuxt est gracieusement fermée +`listen` | ({server, host, port}) | Les **mécanismes** serveur de Nuxt commencent à écouter. (Avec `nuxt start` ou `nuxt dev`) diff --git a/en/api/internals-renderer.md b/en/api/internals-renderer.md index a77aab35e..d89bc67e5 100644 --- a/en/api/internals-renderer.md +++ b/en/api/internals-renderer.md @@ -1,27 +1,27 @@ --- -title: "API: The Renderer Class" -description: Nuxt Renderer Class +title: "API : la classe Renderer" +description: La classe `Renderer` de Nuxt --- -# Renderer Class (En) +# Classe `Renderer` -- Source: **[core/renderer.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/renderer.js)** +- Source : **[core/renderer.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/renderer.js)** -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
This class is exporting a connect middleware which handles and serves all SSR and asset requests.
+Cette classe exporte un middleware qui gère et sert tous les rendus côté serveur et les requêtes de ressources. -## Tapable plugins +## Plugins Tapable -We can register hooks on certain life cycle events. +Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. ```js nuxt.plugin('renderer', renderer => { renderer.plugin('setupMiddleware', app => { - // + // ... }) }) ``` -Plugin | Arguments | When ----------------------|---------------------------|-------------------------------------------------------------------------------- -`ready` | renderer | SSR Middleware and all resources are ready -`setupMiddleware` | connect instance (app) | Before nuxt adds it's middleware stack. We can use it to register custom server side middleware. +Plugin | Arguments | Quand +------------------|------------------------|--------------------------------------------------------------------------------------------------------------------------------- +`ready` | renderer | Le rendu serveur du middleware et toutes les ressources sont prêtes +`setupMiddleware` | connect instance (app) | Avant que Nuxt ajoute sa pile de middleware. Nous pouvons l'utiliser pour enregistrer des middlewares côté serveur personnalisés diff --git a/en/api/internals.md b/en/api/internals.md index b5b0e3c50..c47a95412 100644 --- a/en/api/internals.md +++ b/en/api/internals.md @@ -1,69 +1,70 @@ --- -title: "API: Nuxt Modules Intro" -description: Better understand Nuxt internals +title: "API : introduction aux modules Nuxt" +description: Mieux comprendre les mécanismes de Nuxt --- -# Nuxt Internals (En) +# Mécanismes de Nuxt -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Nuxt.js has a fully modular architecture which allows developers extending any part of Nuxt Core using a flexible API. -Please see [Modules Guide](/guide/modules) for more detailed information if interested developing your own module. -This section helps getting familiar to Nuxt internals and can be used as a reference to understand it better while writing your own modules.
+Nuxt.js a une architecture intégralement modulable permettant au développeur d'étendre n'importe quelle partie du cœur de Nuxt en utilisant son API. -### Core +Consultez le [guide sur les modules](/guide/modules) pour des informations plus détaillées si vous souhaitez développer votre propre module. -These classes are the hearth of Nuxt and should exist on both runtime and build time. +Cette section vous aidera à vous familiariser avec les mécanismes de Nuxt et vous servira de référence pour mieux comprendre comment écrire votre propre module. + +### Le cœur + +Ces classes sont les piliers de Nuxt et devraient exister à l'exécution ou pour le build. #### Nuxt -- [Nuxt Class](/api/internals-nuxt) -- Source: [core/nuxt.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/nuxt.js) +- [Classe `Nuxt`](/api/internals-nuxt) +- Source : [core/nuxt.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/nuxt.js) #### Renderer -- [Renderer Class](/api/internals-renderer) -- Source: [core/renderer.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/renderer.js) +- [Classe `Renderer`](/api/internals-renderer) +- Source : [core/renderer.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/renderer.js) -#### Module Container +#### ModuleContainer -- [ModuleContainer Class](/api/internals-module-container) -- Source: [core/module.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/module.js) +- [Classe `ModuleContainer`](/api/internals-module-container) +- Source : [core/module.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/module.js) ### Build -These classes are only needed for build or dev mode. +Ces classes sont seulement utiles pour le build ou le mode développement. ### Builder -- [Builder Class](/api/internals-builder) -- Source: [builder/builder.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/builder.js) +- [Classe `Builder`](/api/internals-builder) +- Source : [builder/builder.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/builder.js) #### Generator -- [Generator Class](/api/internals-generator) -- Source: [generator/generator.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/generator.js) +- [Classe `Generator`](/api/internals-generator) +- Source : [generator/generator.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/generator.js) -### Common +### Communes -#### Utils +#### Utilitaires -- Source: [common/utils.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/common/utils.js) +- Source : [common/utils.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/common/utils.js) #### Options -- Source: [common/options.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/common/options.js) +- Source : [common/options.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/common/options.js) +## Utilisation et paquetage -## Packaging & Usage - -Nuxt exports all classes by default. To require them: +Nuxt exporte toutes les classes par défaut. Voici comment les `require` : ```js const { Nuxt, Builder, Utils } = require('nuxt') ``` -## Common patterns +## Pans de codes communs -All Nuxt classes have a reference to nuxt instance and options. Every class extends [`tappable`](https://github.com/nuxt/tappable), this way we always have a consistent API across classes to access options and nuxt. +Toutes les classes Nuxt ont une référence à l'instance `nuxt` et aux `options`. Chaque classe étend [`tappable`](https://github.com/nuxt/tappable), de cette manière nous avons toujours une API cohérente à travers les classes pour accéder à `options` et à `nuxt`. ```js const Tapable = require('tappable') @@ -76,12 +77,12 @@ class SomeClass extends Tapable { } someFunction() { - // We have access to this.nuxt and this.options + // Nous avons accès à `this.nuxt` and `this.options` } } ``` -Classes are *plugable* so they should register a plugin on main nuxt container to register more hooks. +Les classes sont *plugable* aussi elle devrait enregistrer un plugin sur le conteneur `nuxt` principal pour enregistrer plus de points d'ancrage. ```js class FooClass extends Tapable { @@ -95,10 +96,10 @@ class FooClass extends Tapable { } ``` -So we can hook into foo module like this: +Aussi nous pouvons l'ancrer dans le module `foo` comme ceci : ```js nuxt.plugin('foo', foo => { // ... }) -``` \ No newline at end of file +``` diff --git a/en/api/menu.json b/en/api/menu.json index 7fcdcd371..7592ed702 100644 --- a/en/api/menu.json +++ b/en/api/menu.json @@ -28,9 +28,9 @@ { "title": "Composants", "links": [ - { "name": "nuxt (En)", "to": "/components-nuxt" }, - { "name": "nuxt-child (En)", "to": "/components-nuxt-child" }, - { "name": "nuxt-link (En)", "to": "/components-nuxt-link" } + { "name": "nuxt", "to": "/components-nuxt" }, + { "name": "nuxt-child", "to": "/components-nuxt-child" }, + { "name": "nuxt-link", "to": "/components-nuxt-link" } ] }, { @@ -121,10 +121,10 @@ { "title": "Programmation", "links": [ - { "name": "Usage (En)", "to": "/nuxt" }, - { "name": "render (En)", "to": "/nuxt-render" }, - { "name": "renderRoute (En)", "to": "/nuxt-render-route" }, - { "name": "renderAndGetWindow (En)", "to": "/nuxt-render-and-get-window" } + { "name": "Utilisation", "to": "/nuxt" }, + { "name": "render", "to": "/nuxt-render" }, + { "name": "renderRoute", "to": "/nuxt-render-route" }, + { "name": "renderAndGetWindow", "to": "/nuxt-render-and-get-window" } ] }, {