-
Notifications
You must be signed in to change notification settings - Fork 103
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
Changes from 3 commits
b236e5d
563f843
9633425
5fae608
98c5ea2
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,17 +11,17 @@ ro_gz_size: "17.67" | |
|
||
### Compatibilité | ||
|
||
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). | ||
Vue ne supporte **pas** IE8 et les versions antérieures, car il utilise des fonctionnalités ECMAScript 5 qui ne peuvent pas être émulées sur IE8. Cela dit, Vue supporte tous les [navigateurs compatibles ECMAScript 5](http://caniuse.com/#feat=es5). | ||
|
||
### Notes de version | ||
|
||
Les notes de version détaillées pour chaque version sont disponibles sur [GitHub](https://github.com/vuejs/vue/releases). | ||
|
||
## Autonome | ||
## Standalone | ||
|
||
Il suffit de télécharger et d'inclure une balise script. `Vue` sera déclaré comme une variable globale. | ||
Il suffit de télécharger et de l'inclure avec une balise script. `Vue` sera déclaré comme une variable globale. | ||
|
||
<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> | ||
<p class="tip">N'utilisez pas la version minifiée pendant le développement car vous ne bénéficieriez alors pas des avertissements pour les erreurs courantes !</p> | ||
|
||
<div id="downloads"> | ||
<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> | ||
|
@@ -31,30 +31,30 @@ Il suffit de télécharger et d'inclure une balise script. `Vue` sera déclaré | |
|
||
### CDN | ||
|
||
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/). | ||
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 sur [unpkg.com/vue/](https://unpkg.com/vue/). | ||
|
||
É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 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). | ||
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 empaqueteurs de modules comme [Webpack](http://webpack.github.io/) ou [Browserify](http://browserify.org/). Vue fournit également des outils d'accompagnement pour la rédaction de [Composants Monopage](single-file-components.html). | ||
|
||
``` bash | ||
# latest stable | ||
$ npm install vue | ||
``` | ||
|
||
### Autonomie vs. Minimum utile | ||
### Standalone vs. Runtime | ||
|
||
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. | ||
Il y a deux builds disponibles le build standalone et le build runtime. La différence vient du fait que le premier inclut le **compilateur de template** alors que le second ne l'inclut pas. | ||
|
||
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. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. |
||
|
||
- 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.** | ||
- Le build standalone 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.** | ||
|
||
- 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. | ||
- Le build runtime 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 runtime, mais il fonctionne avec des composants monopage, car les templates de composants monopage sont pré-compilés dans `render` pendant l'étape de build. Le build runtime est à peu près 30% plus léger que le build standalone, l'amenant seulement à {{ro_gz_size}}ko min+gzip. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. garder monofichiers |
||
|
||
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 : | ||
Par défaut, c'est le build **runtime** qui est exporté par le package NPM. Pour utiliser le build standalone, il faut ajouter l'alias suivant dans la configuration Webpack : | ||
|
||
``` js | ||
resolve: { | ||
|
@@ -64,7 +64,7 @@ resolve: { | |
} | ||
``` | ||
|
||
Pour Browserify, vous pouvez ajouter l'alias dans votre package.json : | ||
Pour Browserify, vous pouvez ajouter un alias dans votre package.json : | ||
|
||
``` js | ||
"browser": { | ||
|
@@ -73,34 +73,34 @@ Pour Browserify, vous pouvez ajouter l'alias dans votre package.json : | |
``` | ||
|
||
<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> | ||
en effet, certains outils ou bibliothèques tierces peuvent également importer Vue, ce qui peut forcer l'app à charger conjointement les builds runtime et standalone et mener à des erreurs.</p> | ||
|
||
### Environnements CSP | ||
|
||
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. | ||
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 standalone a besoin de cette fonctionnalité pour compiler les templates, elle n'est donc pas utilisable dans ces environnements. | ||
|
||
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. | ||
D'un autre côté, le build runtime respecte pleinement CSP. Quand vous utilisez le build runtime 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. | ||
|
||
## CLI | ||
|
||
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 : | ||
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 Monopage 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 : | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. ne pas mettre de majuscules si les acronymes ne sont pas utilisés, et accorder les adjectifs: "d'applications monopages ambitieuses" |
||
|
||
``` bash | ||
# installer vue-cli | ||
$ npm install --global vue-cli | ||
# créer un nouveau projet en utilisant le template « webpack » | ||
# créer un nouveau projet en utilisant le template "webpack" | ||
$ vue init webpack my-project | ||
# installer les dépendances et go ! | ||
$ cd my-project | ||
$ npm install | ||
$ npm run dev | ||
``` | ||
|
||
<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> | ||
<p class="tip">Utiliser la CLI nécessite des connaissances préalables 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 aucun outil de build avant d'utiliser l'interface CLI.</p> | ||
|
||
## Build de développement | ||
|
||
**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 ! | ||
**Important**: les fichiers générés dans le dossier `/dist` sur GitHub sont seulement vérifiés lors des releases. Pour utiliser la dernière version du code source de Vue sur GitHub, vous aurez à lancer le build vous-même ! | ||
|
||
``` bash | ||
git clone https://github.com/vuejs/vue.git node_modules/vue | ||
|
@@ -118,4 +118,4 @@ $ bower install vue | |
|
||
## Chargeurs de module AMD | ||
|
||
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. | ||
Les versions standalone ou installées via Bower sont encapsulés selon UMD ce qui permet de directement les utiliser sous forme de module AMD. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
il y a mécompréhension, je n'entendais pas remplacer monofichier par monopage, je soulignais juste que monopage étant accepté on pouvait également se permettre d'accepter monofichier.