Automatisez vos tâches répétitives avec

Corinne Schillinger BLEND WEB MIX 2013

Corinne Schillinger@schillinger

Pré-requis

v0.8.0 min

grunt-cli

$ npm install -g grunt-cli

en mode admin

Démarrer un nouveau projet

Pour fonctionner Grunt a besoin de 2 fichiers

• package.json : liste les dépendances nécessaires à l’exécution des différentes tâches.

• gruntfile.js (ou gruntfile.coffee) : charge les plugins et configure les tâches à exécuter.

Il se place à la racine du projet.

Créer package.json

Il doit obligatoirement renseigner le nom et le numéro de version du projet.

{ "name": "Blend", "version": "0.0.1"}

Installer Grunt et ses plugins

$ npm install <plugin> --save-dev

• <plugin> est le nom du plugin à installer.

• --save-dev actualise automatiquement la liste des dépendances.

Les plugins disponibles sont recensés sur : http://gruntjs.com/plugins

exécuté à la racine du projet

Installer Grunt et ses plugins

// Grunt$ npm install grunt --save-dev// Valide la syntaxe CSS avec CSSLint$ npm install grunt-contrib-csslint --save-dev// Concatène et minifie les fichiers CSS$ npm install grunt-contrib-cssmin --save-dev// Valide la syntaxe JS avec JSHint$ npm install grunt-contrib-jshint --save-dev// Concatène les fichiers JS$ npm install grunt-contrib-concat --save-dev// Minifie les fichiers JS avec UglifyJS$ npm install grunt-contrib-uglify --save-dev// Optimise les images (.gif, .jpg, .png)$ npm install grunt-contrib-imagemin --save-dev

Installer Grunt et ses plugins

Tous les plugins sont téléchargés et installés dans le dossier node_modules.

Installer Grunt et ses plugins

{ "name": "Blend", "version": "0.0.1", "devDependencies": { "grunt": "~0.4.1", "grunt-contrib-csslint": "~0.1.2", "grunt-contrib-cssmin": "~0.6.1", "grunt-contrib-jshint": "~0.6.4", "grunt-contrib-concat": "~0.3.0", "grunt-contrib-uglify": "~0.2.4", "grunt-contrib-imagemin": "~0.3.0" }}

Et la liste des dépendances est mise à jour.

Créer gruntfile.js

Il est composé de 4 parties distinctes :

1. La configuration du projet ;

2. La configuration des tâches ;

3. Le chargement des plugins ;

4. Et l'exécution des tâches.

Il se place à la racine du projet.

La fonction globale

module.exports = function(grunt) { // Code Grunt};

La configuration du projet

module.exports = function(grunt) { grunt.initConfig({ // Configuration du projet et des tâches });};

La méthode d'initialisation grunt.initConfig() abrite les paramètres de configuration.

La configuration du projet

module.exports = function(grunt) { grunt.initConfig({ // Import des données du projet pkg: grunt.file.readJSON('package.json') });};

Les données projet et la liste des dépendances sont importées dans la configuration de grunt.

La configuration des tâches

grunt.initConfig({ pkg: grunt.file.readJSON('package.json'), csslint: { // Configuration de la tâche csslint }, cssmin: { // Configuration de la tâche cssmin }});

Les données de configuration d'une tâche sont contenues dans une propriété du même nom.

La configuration des tâches

csslint: { options: { // Options de la tâche qui écrasent celles par défaut. },},cssmin: { options: { // Options de la tâche qui écrasent celles par défaut. },}

Chaque tâche est dotée d’une propriété options

qui permet de surcharger les options par défaut.

csslint

Les options du plugin correspondent aux règles de CSSLint (il faut donc s'y reporter pour en connaître la signification).

Par défaut, toutes les règles retournent des avertissements. Pour chaque option, il est possible d'utiliser la valeur false pour ignorer la règle ou 2 pour renvoyer une erreur.

csslinthttps://github.com/gruntjs/grunt-contrib-csslint

csslint: { // Surcharge des options par défaut options: { 'adjoining-classes': false, 'empty-rules': 2, // Génération automatique d’un rapport XML formatters: [{ id: 'csslint-xml', dest: 'report/csslint.xml' }] }, // Fichiers à vérifier src: ['www/css/*.css']}

cssminhttps://github.com/gruntjs/grunt-contrib-mincss

cssmin: { combine: { files: { // Fichier de destination 'www/css/style.css': // Fichiers à concaténer ['www/css/normalize.css', 'www/css/typography.css', 'www/css/layout.css', 'www/css/element.css', 'www/css/js.css', 'www/css/ie.css' ] } }}

jshint

Les options du plugin correspondent aux règles de JSHint (il faut donc s'y reporter pour en connaître la signification).

Par défaut, toutes les règles retournent des avertissements. Pour chaque option, il est possible d'utiliser la valeur false pour ignorer la règle ou 2 pour renvoyer une erreur.

jshinthttps://github.com/gruntjs/grunt-contrib-jshint

jshint: { // Fichiers à vérifier files: ['gruntfile.js', 'www/js/*.js'], // Surcharge des options par défaut options: { eqeqeq: true, es3: true, indent: 2, undef: true, globals: { jQuery: true }, // Génération automatique d’un rapport XML reporter: 'jslint', reporterOutput: 'report/jshint.xml' }}

concathttps://github.com/gruntjs/grunt-contrib-concat

concat: { options: { // Caractère à utiliser pour séparer les fichiers concaténés separator: ';' }, dist: { // Fichiers à concaténer src: ['www/js/library.js', 'www/js/behaviour.js'], // Fichier de destination dest: 'www/js/script.js' }}

uglifyhttps://github.com/gruntjs/grunt-contrib-uglify

uglify: { options: { // La date et le nom des fichiers minifiés sont insérés en commentaire en début de fichier banner: '/* <%= grunt.template.today("dd-mm-yyyy, HH:MM") %> \n <%= concat.dist.src %> */\n' }, dist: { files: { // Fichier de destination 'www/js/script.min.js': // Fichier minifié ['<%= concat.dist.dest %>'] } }}

imageminhttps://github.com/gruntjs/grunt-contrib-imagemin

imagemin: { dynamic: { files: [{ // Mode de ciblage dynamique expand: true, // Dossier contenant les sources cwd: 'www/img/', // Fichiers à prendre en compte src: ['*.{png,jpg,gif}'], // Dossier de destination dest: 'www/img' }] }}

Le chargement des plugins

grunt.initConfig({ …});

grunt.loadNpmTasks('grunt-contrib-csslint');grunt.loadNpmTasks('grunt-contrib-cssmin');grunt.loadNpmTasks('grunt-contrib-jshint');grunt.loadNpmTasks('grunt-contrib-concat');grunt.loadNpmTasks('grunt-contrib-uglify');grunt.loadNpmTasks('grunt-contrib-imagemin');

L’exécution des tâches

// Tâche par défautgrunt.registerTask('default', ['csslint', 'cssmin', 'jshint', 'concat', 'uglify', 'imagemin']);

$ grunt

Elles sont exécutées grâce à la commande :

exécuté à la racine du projet

L’exécution des tâches

// Tâche personnalisée pour le développementgrunt.registerTask('dev', ['csslint', 'cssmin', 'jshint', 'concat', 'uglify']);

// Tâche personnalisée pour la mise en productiongrunt.registerTask('prod', ['imagemin']);

$ grunt dev$ grunt prod

Elles sont exécutées grâce aux commandes :

Forcer l’exécution des tâches

$ grunt dev --force

Lorsque des avertissements sont renvoyés par csslint ou jshint, l’exécution du processus global s’arrête. Pour passer outre et forcer l’exécution de toutes les tâches sans tenir compte des avertissements, il faut passer l’option --force.

Surveiller les fichiershttps://github.com/gruntjs/grunt-contrib-watch

// Permet d’exécuter des tâches prédéfinies si les fichiers surveillés sont ajoutés, modifiés ou supprimés.$ npm install grunt-contrib-watch --save-dev

Installation du plugin

Surveiller les fichiershttps://github.com/gruntjs/grunt-contrib-watch

watch: { // Fichiers à surveiller files: ['www/js/library.js', 'www/js/behaviour.js', 'www/css/normalize.css', 'www/css/typography.css', 'www/css/layout.css', 'www/css/element.css', 'www/css/js.css', 'www/css/ie.css'], // Tâche à exécuter tasks: ['csslint', 'cssmin', 'jshint', 'concat']}

Définition de la tâche

Surveiller les fichiershttps://github.com/gruntjs/grunt-contrib-watch

grunt.loadNpmTasks('grunt-contrib-watch');

Chargement du plugin

grunt.registerTask('dev', ['csslint', 'cssmin', 'jshint', 'concat', 'watch']);

Exécution de la tâche

Merci !des questions ?

Corinne Schillinger @schillinger

BLEND WEB MIX 2013