Traduction de `modules.md` by MachinisteWeb · Pull Request #21 · vuejs-fr/nuxt

MachinisteWeb · 2017-09-30T10:39:08Z

Je commence cette traduction. Je laisse cette PR pour recueiller vos avis à l'avance si vous le souhaitez !

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb · 2017-09-30T12:26:07Z

Je corrige les fautes d'ortho que j'arrive a trouver et je passe ça en relecture !

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb · 2017-09-30T12:45:00Z

Voilà c'est prêt ! Pas d'inquiétude pour le nombre de ligne qui diffère, j'ai déjà PR l'original avec les changements clean qui vont bien ! nuxt#267

rspt · 2017-09-30T14:08:27Z

en/guide/modules.md


-Another point of using modules is that they can be refactored and packaged out of the project and released as NPM packages
-so you can share and use high quality integration and solutions from nuxt community with no pain! You might interested in modules if you:
+C'est pourquoi Nuxt introduit un système modulaire d'ordre supérieur pour facilement étendre ses fonctionnalités de base. Les modules sont en fait des **fonctions** qui sont appelées de manière séquentielle lors de la phase de démarrage de Nuxt. Le cœur va attendre que chacun d'entre eux soient chargés avant de continuer son travail. Ainsi vous avez la possibilité de personnaliser le moindre aspect de Nuxt. Grâce à sa conception modulaire ainsi que webpack [Tapable](https://github.com/webpack/tapable), il peut également abonner des points d'ancrage (« hooks ») pour certaines étapes comme l'initialisation de la phase de build.


"chacun d'entre eux soit chargé"

Accord avec chacun qui est invariable

rspt · 2017-09-30T14:09:57Z

en/guide/modules.md

+- vous êtes un membre d'une **équipe agile** qui souhaite mettre en place son projet instantanément et éviter de **réinventer** la roue pour les tâches habituelles comme des mécanismes Google Analytics pour vos nouveaux projets,
+- vous êtes une **société** qui accorde de l'importance à la **qualité** et la **réutilisabilité** de ses projets,
+- Vous êtes un membre super enthousiaste de la communauté *Open Source* et que vous souhaitez *partager* avec la communauté d'une façon simple.
+- Vous êtes un développeur flaimard et vous n'aimez pas vous encombrer avec des détails comme le paramétrage de chaque nouvelle bibliothèque ou intégration (quelqu'un l'aura surement déjà fait pour vous, ou vous pourriez demander à quelqu'un de la communauté de le faire).


"flémard"

J'éviterais flémard/paresseux. Pour moi dans ce contexte c'est plutôt être un développeur futé ;)

Mais un bon développeur est un développeur flémard !

Le terme est probablement péjoratif. Mais je suis pas sur non plus que se soit futé qui conviennent ici. Je vais opter pour « occupé »

Mais un bon développeur est un développeur flémar

Ahahah oui je plussoie ^^

Le terme est probablement péjoratif. Mais je suis pas sur non plus que se soit futé qui conviennent ici. Je vais opter pour « occupé »

Parfait!

rspt · 2017-09-30T14:10:15Z

en/guide/modules.md

+- vous êtes une **société** qui accorde de l'importance à la **qualité** et la **réutilisabilité** de ses projets,
+- Vous êtes un membre super enthousiaste de la communauté *Open Source* et que vous souhaitez *partager* avec la communauté d'une façon simple.
+- Vous êtes un développeur flaimard et vous n'aimez pas vous encombrer avec des détails comme le paramétrage de chaque nouvelle bibliothèque ou intégration (quelqu'un l'aura surement déjà fait pour vous, ou vous pourriez demander à quelqu'un de la communauté de le faire).
+- Vous êtes fatigué de l'utilisation des API bas niveau et de leur changement continue et vous souhaiter **simplement des choses fonctionnelles**.


"changement continu"

rspt · 2017-09-30T14:10:39Z

en/guide/modules.md

-They can be packaged as NPM modules or directly included in project source code.
+## Écrire un module basique
+
+Comme précédemment mentionné, les modules sont juste de simples fonctions. Ils peuvent être packagés en tant que modules npm ou directement inclus dans le code source du projet.


"Comme précédemment mentionnés,"

Accord avec "modules"

rspt · 2017-09-30T14:11:05Z

en/guide/modules.md

-You can directly access to Nuxt options using this reference.
-This is _nuxt.config.js_ with all default options assigned to and can be used for shared options between modules.
-
+Vous pouvez accéder directement aux options de Nuxt en utilisant cette référence. C'est la configuration `nuxt.config.js` avec ses options par défaut assignées qui peut être utilisées en tant qu'options partagées à travers les modules.


"qui peuvent être"

rspt · 2017-09-30T14:11:32Z

en/guide/modules.md

-  So if you are a module developer at least warn users about that if using them.
-  For heavily async modules or better legacy support you can use either a bundler to transform it for older node comparability or using promise method.
-</p>
+<p class="Alert Alert--orange">Faites attention avec `async` et `await`, ils sont supportés uniquement depuis Node.js 7.2+. Donc si vous êtes un développeur de modules, n'oubliez pas d'avertir vos utilisateurs si vous les utilisez. Pour des modules asynchrones plus stables ou avec un support de version antérieur vous pouvez utiliser un paqueteur pour les transformer en de vieille version de compatibilité Node.js ou utilisant des méthodes de promesse.</p>


"version antérieure"

rspt · 2017-09-30T14:11:51Z

en/guide/modules.md

-### Top level options
-Sometimes it is more convenient if we can use top level options while register modules in `nuxt.config.js`. 
-So we can combine multiply option sources.
+Parfois il est plus simple d'utiliser des options de hauts niveaux lors de l'abonnement de modules à `nuxt.config.js`. Donc nous pouvons combiner les options de sources multiples.


"haut niveau"

rspt · 2017-09-30T14:12:16Z

en/guide/modules.md

-For this we can use `this.addPlugin` helper. 
+### Fournir des plugins
+
+Il est courant que les modules fournissent un ou plusieurs plugins quand ils sont ajoutés. Par exemple le module [bootstrap-vue](https://bootstrap-vue.js.org) nécessite d'être enregistrer lui-même dans Vue. Pour cela, nous pouvons utiliser la fonction utilitaire `this.addPlugin`.


"d'être enregistré"

rspt · 2017-09-30T14:13:28Z

en/guide/modules.md


-      // Customize existing loaders
-      // Refer to source code for Nuxt internals:
+      // Personnalisation des loaders existant


"Personnalisation des loaders existants"

MachinisteWeb

Merci @rspt ! C'est dans la boîte. Juste une proposition de « occupé » à la place de « flémard »

MachinisteWeb · 2017-09-30T15:04:00Z

en/guide/modules.md

+- vous êtes un membre d'une **équipe agile** qui souhaite mettre en place son projet instantanément et éviter de **réinventer** la roue pour les tâches habituelles comme des mécanismes Google Analytics pour vos nouveaux projets,
+- vous êtes une **société** qui accorde de l'importance à la **qualité** et la **réutilisabilité** de ses projets,
+- Vous êtes un membre super enthousiaste de la communauté *Open Source* et que vous souhaitez *partager* avec la communauté d'une façon simple.
+- Vous êtes un développeur flaimard et vous n'aimez pas vous encombrer avec des détails comme le paramétrage de chaque nouvelle bibliothèque ou intégration (quelqu'un l'aura surement déjà fait pour vous, ou vous pourriez demander à quelqu'un de la communauté de le faire).


Mais un bon développeur est un développeur flémard !

Le terme est probablement péjoratif. Mais je suis pas sur non plus que se soit futé qui conviennent ici. Je vais opter pour « occupé »

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb · 2017-10-02T07:34:19Z

Top @rspt ! @Kocal ou @forresst ? Une seconde relecture ?

forresst

Quelques erreurs et remarques

forresst · 2017-09-30T20:17:42Z

en/guide/modules.md

-Modules are basically **functions** which are called sequentially when booting Nuxt and core awaits for all of them
-to be finished before continue it's job. So they have the chance to customize almost any aspect of Nuxt and thanks to modular design of nuxt itself and Webpack [Tapable](https://github.com/webpack/tapable) technology they can also register hooks
-for certain entry points like builder initialization.
+Pendant votre phase d'amélioration du passage du développement à la production avec Nuxt, vous allez découvrir que les fonctionnalités offertes par celui-ci ne sont pas complètes. Faire la configuration et ajouter les plugins de chaque projet est répétitif, ennuyant et prend du temps. Ajouter chaque nouvelle fonctionnalité dans Nuxt serait impossible sans rendre le framework lourd.


Tout en développant une application de qualité du niveau de la production en utilisant Nuxt, ...

la traduction actuelle me paraît incorrecte

Oui. J'ai bloqué sur cette traduction. Je trouve ta proposition étrange aussi cependant :)

Que penses-tu tout simplement de « Pendant la phase d'amélioration de votre application pour la production » ?

Parceque ce dont il est question ici, c'est exactement ça : tout ce que vous aller améliorer dans votre application pour qu'elle soit optimisée pour la production et facile à mettre en production. Et il s'avère que dans cette quête, on va utiliser plus que ce que fournit Nuxt de base.

Pendant la phase d'amélioration de votre application pour la production

👍

forresst · 2017-10-02T11:01:24Z

en/guide/modules.md

    src: path.resolve(__dirname, 'plugin.js'),
    options: {
-      // Nuxt will replace options.ua with 123 when copying plugin to project
+      // Nuxt va remplacer `options.ua` par `123` quand il va copier le plugin au projet.


va remplacer => remplacera
va copier => copiera

forresst · 2017-10-02T11:02:13Z

en/guide/modules.md

 module.exports = function (moduleOptions) {
  if (moduleOptions.fontAwesome !== false) {
-    // Add font-awesome
+    // Ajouter Font Awesome


Ajouter => Ajoute

Je vais mettre « Ajout de ». Ce qui me gène avec « ajoute » c'est que c'est typiquement la description de ce que fait une méthode. Hors là c'est pas vraiment le cas, c'est surtout l'utilisateur qui fait l'action en augmentant le nombre d'élément dans l'option css.

forresst · 2017-10-02T11:03:08Z

en/guide/modules.md

-        // Source can be buffer too
+
+        // Cela va générer `.nuxt/dist/info.txt' avec les contenus des variables d'information.
+        // La source peut être mise en tampon aussi


La source peut être aussi mise en tampon ~~aussi~~

forresst · 2017-10-02T11:04:20Z

en/guide/modules.md

+  // Ajouter un point d'ancrage au module
  this.nuxt.plugin('module', moduleContainer => {
-    // This will be called when all modules finished loading
+    // Ceci va être appelé quand tous les modules auront fini d'être chargés


va être => sera

forresst · 2017-10-02T11:09:47Z

en/guide/modules.md

+  // Ajouter un point d'ancrage au build
  this.nuxt.plugin('build', async builder => {
-    // This Will be called once when builder created
+    // Ceci va être appelé une fois le build fait


va être => sera

forresst · 2017-10-02T11:09:55Z

en/guide/modules.md

+    // On peut également enregistrer des points d'ancrage interne ici
    builder.plugin('compile', ({compiler}) => {
-        // This will be run just before webpack compiler starts
+        // Ceci va être lancé juste avant que le compilateur de webpack démarre


va être => sera

forresst · 2017-10-02T11:10:10Z

en/guide/modules.md

  })

-  // Add hook for generate
+  // Ajouter un point d'ancrage à la génération


Ajouter => Ajoute

forresst · 2017-10-02T11:10:29Z

en/guide/modules.md

+  // Ajouter un point d'ancrage à la génération
  this.nuxt.plugin('generate', async generator => {
-    // This Will be called when a nuxt generate starts
+    // Ceci va être appelé quand la génération de Nuxt va commencer


va être => sera

forresst · 2017-10-02T11:11:33Z

en/guide/modules.md

-  There are many many more hooks and possibilities for modules.
-  Please refer to [Nuxt Internals](/api/internals) to learn more about Nuxt internal API.
-</p>
+<p class="Alert">Il y a encore bien de points d'ancrage et de possibilités pour les modules. Consultez les [mécanismes de Nuxt](/api/internals) pour en apprendre plus à propos de l'API interne de Nuxt.</p>


Il y a encore bien de points d'ancrage => Il existe beaucoup d'autres points d'ancrage

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

forresst

Des oublis (désolé)

forresst · 2017-10-02T12:32:51Z

en/guide/modules.md

+  // Ajoute un point d'ancrage à la génération
  this.nuxt.plugin('generate', async generator => {
-    // This Will be called when a nuxt generate starts
+    // Ceci va être appelé quand la génération de Nuxt va commencer


Ceci va être appelé quand la génération de Nuxt va commencer => Ceci sera appelé quand la génération de Nuxt commencera

forresst · 2017-10-02T12:33:22Z

en/guide/modules.md

+  // Ajoute un point d'ancrage au build
  this.nuxt.plugin('build', async builder => {
-    // This Will be called once when builder created
+    // Ceci va être appelé une fois le build fait


Ceci va être appelé une fois le build fait => Ceci sera appelé une fois le build fait

forresst · 2017-10-02T12:33:37Z

en/guide/modules.md

+  // Ajoute un point d'ancrage au moteur de rendu
  this.nuxt.plugin('renderer', renderer => {
-    // This will be called when renderer was created
+    // Ceci va être appelé quand le moteur de rendu aura été créé


Ceci va être appelé quand le moteur de rendu aura été créé => Ceci sera appelé quand le moteur de rendu aura été créé

forresst · 2017-10-02T12:34:03Z

en/guide/modules.md

+  // Ajoute un point d'ancrage au module
  this.nuxt.plugin('module', moduleContainer => {
-    // This will be called when all modules finished loading
+    // Ceci va être appelé quand tous les modules auront fini d'être chargés


Ceci va être appelé quand tous les modules auront fini d'être chargés => Ceci sera appelé quand tous les modules auront fini d'être chargés

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb · 2017-10-02T14:01:56Z

Pas de soucis @forresst !

C'est dans la boîte !

MachinisteWeb · 2017-10-02T14:23:21Z

Le site fr part live ! Je voudrais passer cette dernière page. Si il y a encore des soucis, je les ajouterais manuellement dans la prochaine monté !

First part of modules.md translated

1550da6

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb added the Traduction en cours label Sep 30, 2017

MachinisteWeb self-assigned this Sep 30, 2017

Merge branch 'working' into modules

e47e808

MachinisteWeb mentioned this pull request Sep 30, 2017

État des traductions #1

Open

MachinisteWeb added 2 commits September 30, 2017 14:25

Traduction done.

be9a78e

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

Merge branch 'modules' of https://github.com/vuejs-fr/nuxt into modules

f7cf6d7

Relecture

87f8570

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

MachinisteWeb added Relecture nécessaire and removed Traduction en cours labels Sep 30, 2017

MachinisteWeb requested review from Kocal, forresst and rspt September 30, 2017 12:44

rspt suggested changes Sep 30, 2017

View reviewed changes

MachinisteWeb commented Sep 30, 2017

View reviewed changes

Revue de @rspt

361b5fe

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

rspt approved these changes Oct 1, 2017

View reviewed changes

forresst requested changes Oct 2, 2017

View reviewed changes

MachinisteWeb added 2 commits October 2, 2017 13:46

@forresst review

c85330e

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

still @forresst review

b67c31b

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

forresst requested changes Oct 2, 2017

View reviewed changes

@forresst review, the return

a352686

Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>

Merge branch 'working' into modules

3eca39f

MachinisteWeb merged commit 177e1dc into working Oct 2, 2017

MachinisteWeb deleted the modules branch October 2, 2017 14:23

Conversation

MachinisteWeb commented Sep 30, 2017

Uh oh!

MachinisteWeb commented Sep 30, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MachinisteWeb commented Sep 30, 2017

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MachinisteWeb left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MachinisteWeb commented Oct 2, 2017

Uh oh!

forresst left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

forresst left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MachinisteWeb commented Oct 2, 2017

Uh oh!

MachinisteWeb commented Oct 2, 2017

MachinisteWeb commented Sep 30, 2017 •

edited

Loading