Skip to content

Translation of all api/internals-*.md files #30

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 7, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 15 additions & 15 deletions en/api/internals-builder.md
Original file line number Diff line number Diff line change
@@ -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

<p style="width: 294px;position: fixed; top : 64px; right: 4px;" class="Alert Alert--orange"><strong>⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou <a href="https://github.com/vuejs-fr/nuxt" target="_blank">participer à la traduction</a> de celle-ci dès maintenant !</strong></p><p>We can register hooks on certain life cycle events.</p>
Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie.

```js
nuxt.plugin('build', builder => {
Expand All @@ -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
21 changes: 10 additions & 11 deletions en/api/internals-generator.md
Original file line number Diff line number Diff line change
@@ -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

<p style="width: 294px;position: fixed; top : 64px; right: 4px;" class="Alert Alert--orange"><strong>⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou <a href="https://github.com/vuejs-fr/nuxt" target="_blank">participer à la traduction</a> de celle-ci dès maintenant !</strong></p><p>We can register hooks on certain life cycle events.</p>
Nous pouvons enregistrer des points d'ancrage sur certains évènements du cycle de vie.

```js
nuxt.plugin('generator', generator => {
Expand All @@ -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
64 changes: 33 additions & 31 deletions en/api/internals-module-container.md
Original file line number Diff line number Diff line change
@@ -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)**

<p style="width: 294px;position: fixed; top : 64px; right: 4px;" class="Alert Alert--orange"><strong>⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou <a href="https://github.com/vuejs-fr/nuxt" target="_blank">participer à la traduction</a> de celle-ci dès maintenant !</strong></p><p>All [modules](/guide/modules) will be called within context of ModuleContainer instance.</p>
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)`
29 changes: 14 additions & 15 deletions en/api/internals-nuxt.md
Original file line number Diff line number Diff line change
@@ -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)**

<p style="width: 294px;position: fixed; top : 64px; right: 4px;" class="Alert Alert--orange"><strong>⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou <a href="https://github.com/vuejs-fr/nuxt" target="_blank">participer à la traduction</a> de celle-ci dès maintenant !</strong></p><p>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`.</p>
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`)
24 changes: 12 additions & 12 deletions en/api/internals-renderer.md
Original file line number Diff line number Diff line change
@@ -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)**

<p style="width: 294px;position: fixed; top : 64px; right: 4px;" class="Alert Alert--orange"><strong>⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou <a href="https://github.com/vuejs-fr/nuxt" target="_blank">participer à la traduction</a> de celle-ci dès maintenant !</strong></p><p>This class is exporting a connect middleware which handles and serves all SSR and asset requests.</p>
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
Loading