Skip to content

French translation of guide/installation.md file #9

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 5 commits into from
Jan 4, 2017
Merged
Changes from 1 commit
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
65 changes: 34 additions & 31 deletions src/v2/guide/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,50 +9,52 @@ gz_size: "25.39"
ro_gz_size: "17.67"
---

### Compatibility Note
### Compatibilité

Vue does **not** support IE8 and below, because it uses ECMAScript 5 features that are un-shimmable in IE8. However it supports all [ECMAScript 5 compliant browsers](http://caniuse.com/#feat=es5).
Vue ne supporte **pas** IE8 et les versions antérieures, car il utilise des fonctionnalités ECMAScript 5 qui sont inconcevables avec IE8. Cela dit, Vue supporte tous les [navigateurs compatibles ECMAScript 5](http://caniuse.com/#feat=es5).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

qui ne peuvent pas être émulées sur IE8


### Release Notes
### Notes de version

Detailed release notes for each version are available on [GitHub](https://github.com/vuejs/vue/releases).
Les notes de version détaillées pour chaque version sont disponibles sur [GitHub](https://github.com/vuejs/vue/releases).

## Standalone
## Autonome

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pas convaincu qu'il faille traduire... "standalone" a un sens très particulier tandis que autonome est un terme générique. On l'a déjà vu comme anglicisme dans des communications françaises. Référence: https://fr.wikipedia.org/wiki/Standalone ; J'aimerais bien avoir un autre avis sur la question

Dans le doute on peut aussi mettre "Standalone (version autonome)"


Simply download and include with a script tag. `Vue` will be registered as a global variable.
Il suffit de télécharger et d'inclure une balise script. `Vue` sera déclaré comme une variable globale.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

de l'inclure avec une balise script


<p class="tip">Don't use the minified version during development. You will miss out all the nice warnings for common mistakes!</p>
<p class="tip">N'utilisez pas la version minifiée pendant le développement car vous ne bénéficierez pas des avertissements pour les erreurs courantes !</p>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bénéficieriez (conditionnel au lieu de futur ; on peut ajouter "alors" derrière pour fluidifier la lecture)


<div id="downloads">
<a class="button" href="/js/vue.js" download>Development Version</a><span class="light info">With full warnings and debug mode</span>
<a class="button" href="./js/vue.js" download>Version de développement</a><span class="light info">Avec tous les avertissements et le mode de débogage</span>

<a class="button" href="/js/vue.min.js" download>Production Version</a><span class="light info">Warnings stripped, {{gz_size}}kb min+gzip</span>
<a class="button" href="./js/vue.min.js" download>Version de production</a><span class="light info">Avertissements retirés, {{gz_size}}ko min+gzip</span>
</div>

### CDN

Recommended: [unpkg](https://unpkg.com/vue/dist/vue.js), which will reflect the latest version as soon as it is published to npm. You can also browse the source of the npm package at [unpkg.com/vue/](https://unpkg.com/vue/).
Recommandé: [unpkg](https://unpkg.com/vue/dist/vue.js), qui reflète la dernière version aussitôt qu'elle est publiée sur npm. Vous pouvez également parcourir la source du package npm à [unpkg.com/vue/](https://unpkg.com/vue/).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

le code source du package npm sur
(en théorie on devrait dire progiciel pour package mais je déteste ce mot 🤢 )

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

J'ai mis NPM en majuscule pour la consistance à travers le fichier


Also available on [jsdelivr](//cdn.jsdelivr.net/vue/{{vue_version}}/vue.js) or [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.js), but these two services take some time to sync so the latest release may not be available yet.
Également disponible sur [jsdelivr](//cdn.jsdelivr.net/vue/{{vue_version}}/vue.js) ou [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.js), mais ces deux services mettent du temps à se synchroniser ce qui signifie que la dernière version peut ne pas être encore disponible.

## NPM

NPM is the recommended installation method when building large scale applications with Vue. It pairs nicely with module bundlers such as [Webpack](http://webpack.github.io/) or [Browserify](http://browserify.org/). Vue also provides accompanying tools for authoring [Single File Components](single-file-components.html).
NPM est la méthode d'installation recommandée lors du développement d'applications à grande échelle avec Vue. Il s'associe bien avec des modules d'empaquetage comme [Webpack](http://webpack.github.io/) ou [Browserify](http://browserify.org/). Vue fournit également des outils d'accompagnement pour la rédaction de [Composants Monofichier](single-file-components.html).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

plutôt "des empaqueteurs de modules", mais là encore pas convaincu par la traduction. "Concaténeurs" peut-être ? En fait tout dépend si l'on traduit "bundle" et par quoi.

Monofichier: un mot complètement inventé, mais que j'ai retrouvé dans d'autres sources alors pourquoi pas. Par contre il était plus souvent orthographié avec un trait d'union "mono-fichier"


``` bash
# latest stable
$ npm install vue
```

### Standalone vs. Runtime-only Build
### Autonomie vs. Minimum utile

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

je suis d'avis de conserver les termes d'origine puisqu'ils sont expliqués dans le paragraphe juste en-dessous


There are two builds available:
Il y a deux builds disponibles, le build autonome (dit *standalone*) et le build minimal (dit *runtime-only*). La différence vient du fait que le premier inclut le **compilateur de template** alors que le second ne l'inclut pas.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La décomposition de ce paragraphe est assez différente du texte d'origine, qu'est-ce qui justifie ce changement ? Aussi on perd les noms des fichiers des builds, qui est une information essentielle.


- `vue.common.js` - the standalone build - includes the template compiler and supports the `template` option. **It also relies on the presence of browser APIs so you cannot use it for server-side rendering.** The template compiler is responsible for compiling Vue template strings into pure JavaScript render functions. If you want to use the `template` option, then you need the compiler. The `Vuex` store requires the standalone build as well.
Le compilateur de template se charge de compiler les chaînes littérales de template Vue en pure fonction de rendu JavaScript. Si vous souhaitez utiliser l'option `template`, alors vous aurez besoin du compilateur.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Les textes ne correspondent pas, est-ce qu'ils ont changé entre temps ? Je referais la relecture de cette section une fois qu'on sera sûr du texte d'origine.


- `vue.js` - the runtime-only build - does not include the template compiler, and does not support the `template` option. You can use the `render` option when using the runtime-only build, but it only works with single-file components, because single-file components' templates are pre-compiled into `render` functions during the build step. The runtime-only build is roughly 30% lighter-weight than the standalone build, weighing only {{ro_gz_size}}kb min+gzip.
- Le build autonome inclut le compilateur et supporte l'option `template`. **Il s'appuie également sur les APIs navigateurs, ce qui signifie que vous ne pouvez pas l'utiliser pour du rendu côté serveur.**

By default, the NPM package exports the **runtime-only** build. To use the standalone build, add the following alias to your Webpack config:
- Le build minimal n'inclut pas le compitateur de template, et ne supporte pas l'option `template`. Vous pouvez seulement utiliser l'option `render` quand vous utilisez le build minimal, mais il fonctionne avec des composants monofichier, car les templates de composants monofichier sont pré-compilés dans `render` pendant l'étape de build. Le build minimal est à peu près 30% plus léger que le build autonome, l'amenant seulement à {{ro_gz_size}}ko min+gzip.

Par défaut, c'est le build **minimal** qui est exporté par le package NPM. Pour utiliser le build autonome, il faut ajouter l'alias suivant dans la configuration Webpack :

``` js
resolve: {
Expand All @@ -62,42 +64,43 @@ resolve: {
}
```

For Browserify, you can add an alias to your package.json:
Pour Browserify, vous pouvez ajouter l'alias dans votre package.json :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

un alias


``` js
"browser": {
"vue": "vue/dist/vue.common"
},
```

<p class="tip">Do NOT do `import Vue from 'vue/dist/vue.js'` - since some tools or 3rd party libraries may import vue as well, this may cause the app to load both the runtime and standalone builds at the same time and lead to errors.</p>
<p class="tip">Ne faites PAS `import Vue from 'vue/dist/vue.js'` —
bien que certains outils ou bibliothèques tierces peuvent également importer vue, cela peut forcer l'app à charger conjointement le build minimal et autonome en même temps et mener à des erreurs.</p>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

en effet, certains outils ou bibliothèques tierces peuvent également importer Vue, ce qui peut

charger conjointement les builds runtime et standalone (retirer en même temps, doublon avec conjointement)


### CSP environments
### Environnements CSP

Some environments, such as Google Chrome Apps, enforce Content Security Policy (CSP), which prohibits the use of `new Function()` for evaluating expressions. The standalone build depends on this feature to compile templates, so is unusable in these environments.
Certains environnements, tels que les Applications de Google Chrome, font respecter la politique de sécurité de contenu (Content Security Policy - CSP), qui ne permet pas l'utilisation de `new Function()` pour évaluer les expressions. Le build autonome a besoin de cette fonctionnalité pour compiler les templates, elle n'est donc pas utilisable dans ces environnements.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

les Applications Chrome (branding français officiel)

il n'est donc pas utilisable (le build)


On the other hand, the runtime-only build is fully CSP-compliant. When using the runtime-only build with [Webpack + vue-loader](https://github.com/vuejs-templates/webpack-simple) or [Browserify + vueify](https://github.com/vuejs-templates/browserify-simple), your templates will be precompiled into `render` functions which work perfectly in CSP environments.
D'un autre côté, le build minimal respecte pleinement CSP. Quand vous utilisez le build minimal avec [Webpack + vue-loader](https://github.com/vuejs-templates/webpack-simple) ou [Browserify + vueify](https://github.com/vuejs-templates/browserify-simple), vos templates vont être pré-compilé dans les fonctions `render` qui fonctionnent parfaitement dans des environnements CSP.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

le build runtime

pré-compilés pour devenir des fonctions render


## CLI

Vue.js provides an [official CLI](https://github.com/vuejs/vue-cli) for quickly scaffolding ambitious Single Page Applications. It provides batteries-included build setups for a modern frontend workflow. It takes only a few minutes to get up and running with hot-reload, lint-on-save, and production-ready builds:
Vue.js offre une [interface en ligne de commande officielle](https://github.com/vuejs/vue-cli) pour mettre rapidement en place les bases d'Applications Monofichier ambitieuses. Il offre une série de builds pré-configurés pour un workflow Front-end moderne. Cela ne prends que quelques minutes pour commencer et lancer des rechargements à chaud, de l'analyse syntaxique à la sauvegarde, et des builds prêt pour la production :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

les bases d'applications web monopages (SPA)
(ne garder les majuscules que si l'acronyme est largement utilisé, ici seul SPA est assez courant)

front-end (pas de majuscule requise)

Cela ne prend

pour avoir un projet prêt et fonctionnel avec rechargement à chaud, analyse syntaxique à la sauvegarde, et builds prêts pour la production:


``` bash
# install vue-cli
# installer vue-cli
$ npm install --global vue-cli
# create a new project using the "webpack" template
# créer un nouveau projet en utilisant le template « webpack »

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

à vérifier dans le doute : est-ce que les guillemets à la française posent un souci avec bash ?

$ vue init webpack my-project
# install dependencies and go!
# installer les dépendances et go !
$ cd my-project
$ npm install
$ npm run dev
```

<p class="tip">The CLI assumes prior knowledge of Node.js and the associated build tools. If you are new to Vue or front-end build tools, we strongly suggest going through <a href="./">the guide</a> without any build tools before using the CLI.</p>
<p class="tip">Utiliser le CLI présuppose des connaissances en Node.js et les outils de build associés. Si vous êtes nouveau sur Vue ou les outils de build front-end, nous vous recommandons fortement de parcourir <a href="./">le guide</a> sans aucuns outils de build avant d'utiliser le CLI.</p>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Utiliser la CLI nécessite des connaissances préalables

sans aucun outil de build

la CLI (ou mieux, l'interface CLI)


## Dev Build
## Build de développement

**Important**: the built files in GitHub's `/dist` folder are only checked-in during releases. To use Vue from the latest source code on GitHub, you will have to build it yourself!
**Important**: les fichiers générés dans le dossier `/dist` sur GitHub sont seulement pris en compte pendant la releases. Pour utiliser la dernière version du code source de Vue sur GitHub, vous devrez le construire vous-même !

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sont seulement vérifiés lors des releases.

vous aurez à lancer le build vous-même


``` bash
git clone https://github.com/vuejs/vue.git node_modules/vue
Expand All @@ -113,6 +116,6 @@ npm run build
$ bower install vue
```

## AMD Module Loaders
## Chargeurs de module AMD

The standalone downloads or versions installed via Bower are wrapped with UMD so they can be used directly as an AMD module.
Les téléchargements seuls ou les versions installées via Bower sont encapsulés selon UMD ce qui permet de directement les utiliser sous forme de module AMD.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Les versions standalone ou installées via Bower

(je serais d'avis de mettre un lien ou le détail de tous ces acronymes mais visiblement Evan n'a pas jugé ça utile dans le texte d'origine...)