Gruntfile.js

/* To prevent jshint from yelling at module.exports. */
/* jshint node:true */

'use strict';

var LIVERELOAD_PORT = 35729;
var SERVER_HOST = process.env.DOCKER ? '0.0.0.0' : 'localhost';

module.exports = function(grunt) {

  // Loads all grunt tasks
  require('matchdep').filterDev('grunt-*').forEach(grunt.loadNpmTasks);
  require('time-grunt')(grunt);
  var fs = require('fs');

  // App configuration
  var config = grunt.file.readYAML('config/common.yml');

  // Tasks configuration
  grunt.initConfig({

    config: config,

    clean: {
      destination: {
        files: [{
          dot: true,
          src: '<%= config.destination %>/*'
        }]
      },
      icons: {
        files: [{
          dot: true,
          src: '<%= config.source %>/icons/icons*.*'
        }]
      }
    },

    copy: {
      cssToDest: {
        src: '*.css',
        dest: '<%= config.destination %>/css/',
        flatten: true,
        filter: 'isFile',
        expand: true,
        nonull: true,
        cwd: '<%= config.source %>/css/'
      }
    },

    csslint: {
      options: {
        csslintrc: '.csslintrc'
      },
      lax: {
        src: '<%= config.destination %>/css/*.css',
        options: {
          import: false
        }
      },
      strict: {
        src: '<%= config.destination %>/css/*.css',
        options: {
          import: 2
        }
      }
    },

    cssmin: {
      css: {
        src: '<%= config.source %>/css/styles.css',
        dest: '<%= config.source %>/css/styles.min.css',
        options: {
          keepSpecialComments: 0
        }
      }
    },

    /*jshint camelcase: false */
    gae: {
      options: {
        path: 'appengine',
        auth: 'oauth2'
      },
      deploy: {
        action: 'update'
      },
      local: {
        action: 'run',
        options: {
          async: true,
          asyncOutput: true,
          args: {
            host: SERVER_HOST,
            port: config.port,
            skip_sdk_update_check: true
          }
        }
      },
      stop: {
        action: 'kill'
      }
    },
    /*jshint camelcase: true */

    htmlmin: {
      all: {
        options: {
          removeCommentsFromCDATA: true,
          // https://github.com/yeoman/grunt-usemin/issues/44
          collapseWhitespace: true,
          collapseBooleanAttributes: true,
          // removeAttributeQuotes: true,
          removeRedundantAttributes: true,
          useShortDoctype: true,
          removeEmptyAttributes: true,
          removeOptionalTags: true
        },
        files: [{
          expand: true,
          cwd: '<%= config.destination %>',
          src: ['**/*.html'],
          dest: '<%= config.destination %>'
        }]
      }
    },

    imagemin: {
      normal: {
        options: {
          optimizationLevel: 7
        },
        files: [{
          expand: true,
          src: ['**/*.png']
        }]
      },
      o2: {
        options: {
          optimizationLevel: 2
        },
        files: [{
          expand: true,
          src: ['**/*.png']
        }]
      }
    },

    jshint: {
      options: {
        jshintrc: '.jshintrc'
      },
      source: [
        'Gruntfile.js',
        '<%= config.source %>/**/*.js',
        '!<%= config.source %>/**/_code/**/*.js'
      ]
    },

    open: {
      local: {
        path: 'http://localhost:<%=config.port%>/web'
      },
      staging: {
        path: 'http://web-central.appspot.com/web'
      },
    },

    sass: {
      options: {
        precision: 10,
        includePaths: ['<%= config.source %>/css'],
        imagePath: '<%= config.source %>/imgs',
        outputStyle: 'nested'
      },
      all: {
        files: {
          '<%= config.source %>/css/styles.css': '<%= config.source %>/_sass/styles.scss'
        }
      }
    },

    watch: {
      // When styles change, recompile them
      styles: {
        files: [
          '<%= config.source %>/_sass/**/*.scss',
          '<%= config.source %>/css/**/*.css',
          '!<%= config.source %>/css/**/*.min.css'
        ],
        tasks: ['sass', 'cssmin', 'copy:cssToDest']
      },

      // when jekyll source changes, recompile them
      jekyll: {
        files: [
          '<%= config.source %>/**/*.liquid',
          '<%= config.source %>/**/**/*.markdown',
          '<%= config.source %>/**/*.rb',
          '<%= config.source %>/**/**/*.md',
          '<%= config.source %>/**/*.xml',
          '<%= config.source %>/**/*.yaml',
          '<%= config.source %>/**/*.html'
        ],
        tasks: ['jekyll:appengine']
      },

      // when served files change, reload them in the browser
      served: {
        options: {
          livereload: LIVERELOAD_PORT
        },
        files: [
          '<%= config.destination %>/**/*.html',  // view files (from jekyll)
          '<%= config.destination %>/css/*.css'   // css files (from sass)
        ]
      }
    },

    webfont: {
      icons: {
        src: '<%= config.source %>/icons/*.svg',
        dest: '<%= config.source %>/icons/',
        destCss: '<%= config.source %>/_sass/_components/',
        options: {
          autoHint: false,
          hashes: false,
          stylesheet: 'scss',
          relativeFontPath: '../icons',
          htmlDemo: false,
          template: '<%= config.source %>/_templates/icons-template.css'
        }
      }

    }
  });

  // jekyll:target [--lang <lang_code,lang_code,...|all>]
  // where 'target' is config/target.yml file.
  // defaults to '--lang all'.
  // 'all' builds for all languages specified in config.yml/langs_available + 'en'.
  // builds w/o multilang support if config.yml is missing langs_available.
  grunt.registerTask('jekyll', 'Run jekyll build.\nOptions:\n  [--lang]: list of languages or "all"\n  [--section]: optional subfolder. If passed, only rebuilds that section', function() {
    var langs = grunt.option('lang') || 'all';
    var section = grunt.option('section') || 'all';

    // configure the watcher so it only watches the current section, otherwise it'll create and endless loop
    if(section !== 'all') {
      var watchConfig = grunt.config.get('watch');
      watchConfig.jekyll.files = [
        'src/_langs/*/' + section + '/**/*.liquid',
        'src/_langs/*/' + section + '/**/*.markdown',
        'src/_langs/*/' + section + '/**/*.xml',
        'src/_langs/*/' + section + '/**/*.yaml',
        'src/_langs/*/' + section + '/**/*.html',
        'src/**/*.rb',
        'src/_includes/**/*.liquid',
        'src/_layouts/**/*.liquid'
      ];
      grunt.config.set('watch', watchConfig);
    }

    var cfgname = this.args[0] || 'appengine';

    // read langs from config/target.yml
    // returns langs_available + prime_lang
    //         or [] if langs_available is not defined.
    var langsFromConfig = function() {
      /*jshint camelcase: false */
      var cfg = grunt.file.readYAML('config/common.yml');
      if (typeof cfg.langs_available === 'undefined') {
        return [];
      }
      cfg.langs_available.unshift(cfg.prime_lang);
      return cfg.langs_available;
      /*jshint camelcase: true */
    };

    if (langs === 'all' ) {
      langs = langsFromConfig();
    } else {
      langs = langs.split(/,|\s/).filter(function(item) {
        return item.length > 0;
      });
    }

    var cfgfiles = 'config/common.yml,config/' + cfgname + '.yml';
    var args = ['exec', 'jekyll', 'build', '--config', cfgfiles, '-t'];
    var spawnJekyll = function(lang, callback) {
      var opts = {env: process.env, stdio: 'inherit'};
      if (lang !== null) {
        opts.env.TRANS_LANG = lang;
        // opts.env.MENTOS_TIMEOUT = 32;
      }

      // if a section has been passed, move other folders temporarily out of the
      // src folder
      if(section !== 'all') {
        var srcDir = 'src/_langs/' + lang + '/';
        var tmpDir = '.tmp' + lang + '/';
        var otherSections = [];

        // create tmp folder
        if(!fs.existsSync(tmpDir)) {
          fs.mkdirSync(tmpDir);
        }

        // move other sections out of the src folder temporarily
        var dir = fs.readdirSync(srcDir);
        for (var i = 0; i < dir.length; i++) {
          if(fs.statSync(srcDir + dir[i]).isDirectory() && dir[i] !== section && !(section === 'updates' && (dir[i] === 'showcase')) && !(section === 'tools' && (dir[i] === 'updates' || dir[i] === 'showcase'))) {
            otherSections.push(dir[i]);
            fs.renameSync(srcDir + dir[i], tmpDir + dir[i]);
          }
        }

      }

      var sectionCallback = function(err, res, code) {

        // move other sections back to where they belong
        for (var i = 0; i < otherSections.length; i++) {
          fs.renameSync(tmpDir + otherSections[i], srcDir + otherSections[i]);
        }

        // remove tmp folder
        if(fs.existsSync(tmpDir)) {
          fs.rmdirSync(tmpDir);
        }

        callback(err, res, code);
      };

      grunt.util.spawn({cmd: 'bundle', args: args, opts: opts}, section !== 'all' ? sectionCallback : callback);
    };

    var done = this.async();
    var count = 0;
    var waitAll = function(err, res, code) {
      if (err) {
        grunt.fatal(String(res), code);
      }
      if (++count >= langs.length) {
        done();
      }
    };

    // multilang build
    for (var i = 0; i < langs.length; i++) {
      spawnJekyll(langs[i], waitAll);
    }
    // simple build (no multilang support)
    if (langs.length === 0) {
      spawnJekyll(null, waitAll);
    }
  });

  // Test task
  grunt.registerTask('test', 'Lints all javascript and CSS sources.', 'jshint:source');

  grunt.registerTask('prepare', ['test', 'clean:destination', 'sass', 'cssmin']);

  // Build task
  grunt.registerTask('build', 'Runs the "test" task, then builds the website.', [
    'prepare',
    'jekyll:appengine'   // Build the site with Jekyll
  ]);

  // Develop task
  grunt.registerTask('develop', 'The default task for developers.\nRuns the tests, builds the minimum required, serves the content and watches for changes.', [
    'build',   // Build the site with Jekyll
    'gae:local',
    'open:local',
    'watch'
  ]);

  // Develop task for docker-based env
  grunt.registerTask('develop-no-open', 'The default task for developers.\nRuns the tests, builds the minimum required, serves the content and watches for changes.\nDoes not open URL.', [
    'build',   // Build the site with Jekyll
    'gae:local',
    'watch'
  ]);

  // Devsite task
  grunt.registerTask('devsite', 'Runs the build steps with devsite config', [
    'clean:icons',        // Clean up icon font files for regeneration
    'webfont:icons',      // Generate icon font files and SASS
    'prepare',
    'jekyll:devsite',     // Build the site with Jekyll
    'htmlmin:all'         // Minify the final HTML
  ]);

  // Devsite task
  grunt.registerTask('samples', 'Builds the samples to publish to GH Pages', [
    'prepare',
    'jekyll:devsite',     // Build the site with Jekyll
  ]);

  // Default task
  grunt.registerTask('default', 'develop');

};