From 6f4d29ebf5e242a52939eb9739fc580944b88545 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Mon, 6 Nov 2017 18:32:33 +0100 Subject: [PATCH 1/4] Translation of all api/internals-*.md files Signed-off-by: Bruno Lesieur --- en/api/internals-builder.md | 30 ++++++------- en/api/internals-generator.md | 20 ++++----- en/api/internals-module-container.md | 64 +++++++++++++------------- en/api/internals-nuxt.md | 29 ++++++------ en/api/internals-renderer.md | 24 +++++----- en/api/internals.md | 67 ++++++++++++++-------------- en/api/menu.json | 14 +++--- 7 files changed, 125 insertions(+), 123 deletions(-) diff --git a/en/api/internals-builder.md b/en/api/internals-builder.md index f153892b4..1976c9a85 100644 --- a/en/api/internals-builder.md +++ b/en/api/internals-builder.md @@ -1,16 +1,16 @@ --- -title: "API: The Builder Class" -description: Nuxt Builder Class +title: "API : La classe Builder" +description: La classe `Builder` de Nuxt --- -# Builder Class (En) +# Classe Builder -- Source: **[builder/builder.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/builder.js)** +- Source : **[builder/builder.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/builder.js)** -## Tapable plugins +## Plugins Tapable -

⚠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 | When +---------------|-----------------------------------------|------------------------------------------------------------------------------- +`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 build webpack sont fini +`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..992b78097 100644 --- a/en/api/internals-generator.md +++ b/en/api/internals-generator.md @@ -1,16 +1,16 @@ --- -title: "API: The Generator Class" -description: Nuxt Generator Class +title: "API : La classe Generator" +description: Le 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)** -## Tapable plugins +## 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 +20,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 | When +-----------------|-----------------------------|------------------------------------------------------------------------------------------------- +`generateRoutes` | {generator, generateRoutes} | Après la résolution des routes pour généreration 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..81bc3bc11 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é 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 | When +--------|-----------------|----------------------------------------------------------- +`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. + +Ajouter à `options.build.vendor` et appliquer 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 fait 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 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. +Enregistrer un plugin en utilisant `addTemplate` et l'ajouter 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ésolues `meta` préviennent l'enregitrement 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..2d6da19e1 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 | When +---------|------------------------|----------------------------------------------------------------------------------------- +`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 commence à écouter. (Avec `nuxt start` ou `nuxt dev`) diff --git a/en/api/internals-renderer.md b/en/api/internals-renderer.md index a77aab35e..c3a3fe4dc 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 exportée 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 | When +------------------|------------------------|--------------------------------------------------------------------------------------------------------------------------------- +`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..c616520c9 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 va vous aider à 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 pilliers de Nuxt et devrait 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" } ] }, { From d87ec80ff4ed34359e504815ca40133b3d08e396 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Tue, 7 Nov 2017 09:50:28 +0100 Subject: [PATCH 2/4] @rspt review Signed-off-by: Bruno Lesieur --- en/api/internals-builder.md | 2 +- en/api/internals-generator.md | 2 +- en/api/internals-module-container.md | 8 ++++---- en/api/internals-nuxt.md | 2 +- en/api/internals-renderer.md | 2 +- en/api/internals.md | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/en/api/internals-builder.md b/en/api/internals-builder.md index 1976c9a85..794989508 100644 --- a/en/api/internals-builder.md +++ b/en/api/internals-builder.md @@ -26,6 +26,6 @@ Plugin | Arguments | When `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 build webpack sont fini +`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 992b78097..f7e3e975a 100644 --- a/en/api/internals-generator.md +++ b/en/api/internals-generator.md @@ -22,5 +22,5 @@ nuxt.plugin('generator', generator => { Plugin | Arguments | When -----------------|-----------------------------|------------------------------------------------------------------------------------------------- -`generateRoutes` | {generator, generateRoutes} | Après la résolution des routes pour généreration afin de faire des changements personnalisés +`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 81bc3bc11..d129cacce 100644 --- a/en/api/internals-module-container.md +++ b/en/api/internals-module-container.md @@ -15,7 +15,7 @@ Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle ```js nuxt.moduleContainer.plugin('ready', async moduleContainer => { - // Faire ceci après que tous les modules soient prèts + // Faire ceci après que tous les modules soient prêts }) ``` @@ -23,7 +23,7 @@ Dans le contexte des [modules](/guide/modules) nous pouvons utiliser ceci à la ```js this.plugin('ready', async moduleContainer => { - // Faire ceci après que tous les modules soient prèts + // Faire ceci après que tous les modules soient prêts }) ``` @@ -45,7 +45,7 @@ Ajouter à `options.build.vendor` et appliquer un filtre unique. - `options` - `fileName` -Le rendu des templates sont fait dans le projet `buildDir` (`.nuxt`) en utilisant [lodash template](https://lodash.com/docs/4.17.4#template). +Le rendu des templates sont faits dans le projet `buildDir` (`.nuxt`) en utilisant [lodash template](https://lodash.com/docs/4.17.4#template). Si n'est pas fourni ou que `template` est une chaine de caractères, le fichier ciblé par défaut sera `[dirName].[fileName].[pathHash].[ext]`. @@ -71,7 +71,7 @@ Permet d'étendre facilement les routes en chainant la fonction [options.build.e ### addModule (moduleOpts, requireOnce) -Enregistre le module. `moduleOpts` peut être une chaine de caractères ou `[src, options]`. Si `requireOnce` est `true`, les modules résolues `meta` préviennent l'enregitrement du même module plus d'une fois. +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) diff --git a/en/api/internals-nuxt.md b/en/api/internals-nuxt.md index 2d6da19e1..f02fa0b0c 100644 --- a/en/api/internals-nuxt.md +++ b/en/api/internals-nuxt.md @@ -24,4 +24,4 @@ Plugin | Arguments | When `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 commence à écouter. (Avec `nuxt start` ou `nuxt dev`) +`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 c3a3fe4dc..0f5aefc99 100644 --- a/en/api/internals-renderer.md +++ b/en/api/internals-renderer.md @@ -7,7 +7,7 @@ description: La classe `Renderer` de Nuxt - Source : **[core/renderer.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/renderer.js)** -Cette classe exporte un middleware exportée qui gère et sert tous les rendus côté serveur et les requêtes de ressources. +Cette classe exporte un middleware qui gère et sert tous les rendus côté serveur et les requêtes de ressources. ## Plugins Tapable diff --git a/en/api/internals.md b/en/api/internals.md index c616520c9..20161dbcf 100644 --- a/en/api/internals.md +++ b/en/api/internals.md @@ -13,7 +13,7 @@ Cette section va vous aider à vous familiariser avec les mécanismes de Nuxt et ### Le cœur -Ces classes sont les pilliers de Nuxt et devrait exister à l'exécution ou pour le build. +Ces classes sont les piliers de Nuxt et devraient exister à l'exécution ou pour le build. #### Nuxt From 9101d24014a34d81c8f866edcdb368562ff0e3c5 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Tue, 7 Nov 2017 15:59:35 +0100 Subject: [PATCH 3/4] @forresst review Signed-off-by: Bruno Lesieur --- en/api/internals-builder.md | 4 ++-- en/api/internals-generator.md | 9 ++++----- en/api/internals-module-container.md | 14 +++++++------- en/api/internals-nuxt.md | 2 +- en/api/internals-renderer.md | 4 ++-- en/api/internals.md | 4 ++-- 6 files changed, 18 insertions(+), 19 deletions(-) diff --git a/en/api/internals-builder.md b/en/api/internals-builder.md index 794989508..ad38f8ebe 100644 --- a/en/api/internals-builder.md +++ b/en/api/internals-builder.md @@ -1,5 +1,5 @@ --- -title: "API : La classe Builder" +title: "API : la classe Builder" description: La classe `Builder` de Nuxt --- @@ -20,7 +20,7 @@ nuxt.plugin('build', builder => { }) ``` -Plugin | Arguments | When +Plugin | Arguments | Quand ---------------|-----------------------------------------|------------------------------------------------------------------------------- `build` | builder | Au démarrage du premier build `built` | builder | À la fin du premier build diff --git a/en/api/internals-generator.md b/en/api/internals-generator.md index f7e3e975a..f1fb69167 100644 --- a/en/api/internals-generator.md +++ b/en/api/internals-generator.md @@ -1,14 +1,13 @@ --- -title: "API : La classe Generator" -description: Le classe `Generator` de Nuxt +title: "API : la classe Generator" +description: La classe `Generator` de Nuxt --- # La classe Generator - Source : **[builder/generator.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/builder/generator.js)** - -## Plugins +## Plugins Tapable Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie. @@ -20,7 +19,7 @@ nuxt.plugin('generator', generator => { }) ``` -Plugin | Arguments | When +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 d129cacce..be763f33d 100644 --- a/en/api/internals-module-container.md +++ b/en/api/internals-module-container.md @@ -1,5 +1,5 @@ --- -title: "API : La classe ModuleContainer" +title: "API : la classe ModuleContainer" description: La classe `ModuleContainer` de Nuxt --- @@ -7,7 +7,7 @@ description: La classe `ModuleContainer` de Nuxt - Source : **[core/module.js](https://github.com/nuxt/nuxt.js/blob/dev/lib/core/module.js)** -Tous les [modules](/guide/modules) seront appelé dans le contexte de l'instance de `ModuleContainer`. +Tous les [modules](/guide/modules) seront appelés dans le contexte de l'instance de `ModuleContainer`. ## Plugins Tapable @@ -27,7 +27,7 @@ this.plugin('ready', async moduleContainer => { }) ``` -Plugin | Arguments | When +Plugin | Arguments | Quand --------|-----------------|----------------------------------------------------------- `ready` | moduleContainer | Tous les modules dans `nuxt.config.js` ont été initialisés @@ -36,7 +36,7 @@ Plugin | Arguments | When ### addVendor (vendor) -Ajouter à `options.build.vendor` et appliquer un filtre unique. +Ajoute à `options.build.vendor` et applique un filtre unique. ### addTemplate (template) @@ -47,13 +47,13 @@ Ajouter à `options.build.vendor` et appliquer un filtre unique. Le rendu des templates sont faits dans le projet `buildDir` (`.nuxt`) en utilisant [lodash template](https://lodash.com/docs/4.17.4#template). -Si n'est pas fourni ou que `template` est une chaine de caractères, le fichier ciblé par défaut sera `[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]`. -Cette méthode retourne un objet final `{ dist, src, options }`. +Cette méthode retourne un objet final `{ dist, src, options }`. ### addPlugin (template) -Enregistrer un plugin en utilisant `addTemplate` et l'ajouter en premier à la liste des options de `plugins[]`. +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. diff --git a/en/api/internals-nuxt.md b/en/api/internals-nuxt.md index f02fa0b0c..d1b1fce43 100644 --- a/en/api/internals-nuxt.md +++ b/en/api/internals-nuxt.md @@ -1,5 +1,5 @@ --- -title: "API : La classe Nuxt" +title: "API : la classe Nuxt" description: La classe cœur Nuxt --- diff --git a/en/api/internals-renderer.md b/en/api/internals-renderer.md index 0f5aefc99..d89bc67e5 100644 --- a/en/api/internals-renderer.md +++ b/en/api/internals-renderer.md @@ -1,5 +1,5 @@ --- -title: "API : La classe Renderer" +title: "API : la classe Renderer" description: La classe `Renderer` de Nuxt --- @@ -21,7 +21,7 @@ nuxt.plugin('renderer', renderer => { }) ``` -Plugin | Arguments | When +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 20161dbcf..c47a95412 100644 --- a/en/api/internals.md +++ b/en/api/internals.md @@ -1,5 +1,5 @@ --- -title: "API : Introduction aux modules Nuxt" +title: "API : introduction aux modules Nuxt" description: Mieux comprendre les mécanismes de Nuxt --- @@ -9,7 +9,7 @@ Nuxt.js a une architecture intégralement modulable permettant au développeur d Consultez le [guide sur les modules](/guide/modules) pour des informations plus détaillées si vous souhaitez développer votre propre module. -Cette section va vous aider à vous familiariser avec les mécanismes de Nuxt et vous servira de référence pour mieux comprendre comment écrire votre propre module. +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 From df8a0da1f4727adc9a5b220996206edbddae4cf6 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Tue, 7 Nov 2017 16:01:04 +0100 Subject: [PATCH 4/4] Add the last correction Signed-off-by: Bruno Lesieur --- en/api/internals-nuxt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/api/internals-nuxt.md b/en/api/internals-nuxt.md index d1b1fce43..2ba9c97ae 100644 --- a/en/api/internals-nuxt.md +++ b/en/api/internals-nuxt.md @@ -19,7 +19,7 @@ nuxt.plugin('ready', async nuxt => { }) ``` -Plugin | Arguments | When +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