2013-07-28 06:33:41 +02:00
|
|
|
/* jshint node: true */
|
2013-08-04 01:03:38 +02:00
|
|
|
|
2013-12-07 01:51:59 +01:00
|
|
|
module.exports = function (grunt) {
|
2013-09-18 18:50:02 +02:00
|
|
|
'use strict';
|
2013-08-04 01:03:38 +02:00
|
|
|
|
2013-12-03 12:07:57 +01:00
|
|
|
// Force use of Unix newlines
|
|
|
|
grunt.util.linefeed = '\n';
|
|
|
|
|
2013-12-08 11:24:47 +01:00
|
|
|
RegExp.quote = function (string) {
|
|
|
|
return string.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&')
|
|
|
|
}
|
2013-12-28 23:33:32 +01:00
|
|
|
|
2013-10-18 04:52:16 +02:00
|
|
|
var BsLessdocParser = require('./docs/grunt/bs-lessdoc-parser.js')
|
2013-12-28 23:33:32 +01:00
|
|
|
var fs = require('fs')
|
2014-01-08 07:34:09 +01:00
|
|
|
var generateGlyphiconsData = require('./docs/grunt/bs-glyphicons-data-generator.js')
|
2014-01-08 07:15:48 +01:00
|
|
|
var generateRawFilesJs = require('./docs/grunt/bs-raw-files-generator.js')
|
2013-10-18 04:52:16 +02:00
|
|
|
var path = require('path')
|
2013-12-28 23:33:32 +01:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// Project configuration.
|
|
|
|
grunt.initConfig({
|
|
|
|
|
|
|
|
// Metadata.
|
|
|
|
pkg: grunt.file.readJSON('package.json'),
|
2013-09-11 04:21:44 +02:00
|
|
|
banner: '/*!\n' +
|
2013-11-30 16:11:41 +01:00
|
|
|
' * Bootstrap v<%= pkg.version %> (<%= pkg.homepage %>)\n' +
|
2014-01-07 01:05:24 +01:00
|
|
|
' * Copyright 2011-<%= grunt.template.today("yyyy") %> <%= pkg.author %>\n' +
|
2013-12-23 18:02:42 +01:00
|
|
|
' * Licensed under <%= _.pluck(pkg.licenses, "type") %> (<%= _.pluck(pkg.licenses, "url") %>)\n' +
|
|
|
|
' */\n',
|
2013-09-30 00:37:22 +02:00
|
|
|
jqueryCheck: 'if (typeof jQuery === "undefined") { throw new Error("Bootstrap requires jQuery") }\n\n',
|
2013-08-04 01:03:38 +02:00
|
|
|
|
|
|
|
// Task configuration.
|
|
|
|
clean: {
|
|
|
|
dist: ['dist']
|
|
|
|
},
|
|
|
|
|
|
|
|
jshint: {
|
|
|
|
options: {
|
|
|
|
jshintrc: 'js/.jshintrc'
|
|
|
|
},
|
|
|
|
gruntfile: {
|
|
|
|
src: 'Gruntfile.js'
|
|
|
|
},
|
|
|
|
src: {
|
|
|
|
src: ['js/*.js']
|
|
|
|
},
|
|
|
|
test: {
|
|
|
|
src: ['js/tests/unit/*.js']
|
2013-09-18 20:37:55 +02:00
|
|
|
},
|
|
|
|
assets: {
|
2013-12-29 07:47:03 +01:00
|
|
|
src: ['docs/assets/js/application.js', 'docs/assets/js/customizer.js']
|
2013-10-18 04:52:16 +02:00
|
|
|
},
|
|
|
|
docsGrunt: {
|
|
|
|
src: ['docs/grunt/*.js']
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
|
|
|
},
|
2013-08-08 08:06:29 +02:00
|
|
|
|
2013-12-07 01:51:38 +01:00
|
|
|
jscs: {
|
|
|
|
options: {
|
|
|
|
config: 'js/.jscs.json',
|
|
|
|
},
|
|
|
|
gruntfile: {
|
|
|
|
src: ['Gruntfile.js']
|
|
|
|
},
|
|
|
|
src: {
|
|
|
|
src: ['js/*.js']
|
|
|
|
},
|
|
|
|
test: {
|
|
|
|
src: ['js/tests/unit/*.js']
|
2014-01-06 05:52:37 +01:00
|
|
|
},
|
|
|
|
assets: {
|
|
|
|
src: ['docs/assets/js/application.js', 'docs/assets/js/customizer.js']
|
2013-10-18 04:52:16 +02:00
|
|
|
},
|
|
|
|
docsGrunt: {
|
|
|
|
src: ['docs/grunt/*.js']
|
2013-12-07 01:51:38 +01:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-12-08 12:01:18 +01:00
|
|
|
csslint: {
|
|
|
|
options: {
|
2013-12-31 22:16:28 +01:00
|
|
|
csslintrc: 'less/.csslintrc'
|
2013-12-08 12:01:18 +01:00
|
|
|
},
|
2013-12-10 15:11:08 +01:00
|
|
|
src: [
|
|
|
|
'dist/css/bootstrap.css',
|
|
|
|
'dist/css/bootstrap-theme.css',
|
2013-12-29 07:47:03 +01:00
|
|
|
'docs/assets/css/docs.css'
|
2013-12-10 15:11:08 +01:00
|
|
|
]
|
2013-12-08 12:01:18 +01:00
|
|
|
},
|
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
concat: {
|
|
|
|
options: {
|
2013-12-23 18:02:42 +01:00
|
|
|
banner: '<%= banner %>\n<%= jqueryCheck %>',
|
2013-08-04 01:03:38 +02:00
|
|
|
stripBanners: false
|
|
|
|
},
|
|
|
|
bootstrap: {
|
|
|
|
src: [
|
|
|
|
'js/transition.js',
|
|
|
|
'js/alert.js',
|
|
|
|
'js/button.js',
|
|
|
|
'js/carousel.js',
|
|
|
|
'js/collapse.js',
|
|
|
|
'js/dropdown.js',
|
|
|
|
'js/modal.js',
|
|
|
|
'js/tooltip.js',
|
|
|
|
'js/popover.js',
|
|
|
|
'js/scrollspy.js',
|
|
|
|
'js/tab.js',
|
|
|
|
'js/affix.js'
|
|
|
|
],
|
|
|
|
dest: 'dist/js/<%= pkg.name %>.js'
|
|
|
|
}
|
|
|
|
},
|
2013-08-08 08:06:29 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
uglify: {
|
|
|
|
bootstrap: {
|
2013-12-27 04:08:19 +01:00
|
|
|
options: {
|
|
|
|
banner: '<%= banner %>\n',
|
|
|
|
report: 'min'
|
|
|
|
},
|
2013-08-04 01:03:38 +02:00
|
|
|
src: ['<%= concat.bootstrap.dest %>'],
|
|
|
|
dest: 'dist/js/<%= pkg.name %>.min.js'
|
2013-09-19 16:41:14 +02:00
|
|
|
},
|
|
|
|
customize: {
|
2013-12-27 04:08:19 +01:00
|
|
|
options: {
|
|
|
|
banner: '/*!\n' +
|
|
|
|
' * Bootstrap Docs (<%= pkg.homepage %>)\n' +
|
2014-01-07 01:05:24 +01:00
|
|
|
' * Copyright 2011-<%= grunt.template.today("yyyy") %> <%= pkg.author %>\n' +
|
2013-12-27 04:08:19 +01:00
|
|
|
' * Licensed under the Creative Commons Attribution 3.0 Unported License. For\n' +
|
|
|
|
' * details, see http://creativecommons.org/licenses/by/3.0/.\n' +
|
|
|
|
' */\n',
|
|
|
|
report: 'min'
|
|
|
|
},
|
2013-09-19 16:41:14 +02:00
|
|
|
src: [
|
2013-12-29 07:47:03 +01:00
|
|
|
'docs/assets/js/less.js',
|
|
|
|
'docs/assets/js/jszip.js',
|
|
|
|
'docs/assets/js/uglify.js',
|
|
|
|
'docs/assets/js/filesaver.js',
|
|
|
|
'docs/assets/js/customizer.js'
|
2013-09-19 16:41:14 +02:00
|
|
|
],
|
2014-01-08 04:10:31 +01:00
|
|
|
dest: 'docs/assets/js/customize.min.js'
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-12-09 04:09:27 +01:00
|
|
|
less: {
|
2013-12-09 23:29:19 +01:00
|
|
|
compileCore: {
|
|
|
|
options: {
|
2013-12-18 19:22:18 +01:00
|
|
|
strictMath: true,
|
2013-12-09 23:29:19 +01:00
|
|
|
sourceMap: true,
|
|
|
|
outputSourceFiles: true,
|
|
|
|
sourceMapURL: '<%= pkg.name %>.css.map',
|
|
|
|
sourceMapFilename: 'dist/css/<%= pkg.name %>.css.map'
|
|
|
|
},
|
|
|
|
files: {
|
|
|
|
'dist/css/<%= pkg.name %>.css': 'less/bootstrap.less'
|
|
|
|
}
|
|
|
|
},
|
|
|
|
compileTheme: {
|
|
|
|
options: {
|
2013-12-18 19:22:18 +01:00
|
|
|
strictMath: true,
|
2013-12-09 23:29:19 +01:00
|
|
|
sourceMap: true,
|
|
|
|
outputSourceFiles: true,
|
|
|
|
sourceMapURL: '<%= pkg.name %>-theme.css.map',
|
|
|
|
sourceMapFilename: 'dist/css/<%= pkg.name %>-theme.css.map'
|
|
|
|
},
|
2013-12-09 04:09:27 +01:00
|
|
|
files: {
|
|
|
|
'dist/css/<%= pkg.name %>-theme.css': 'less/theme.less'
|
|
|
|
}
|
2013-08-04 01:03:38 +02:00
|
|
|
},
|
2013-12-09 09:12:11 +01:00
|
|
|
minify: {
|
|
|
|
options: {
|
|
|
|
cleancss: true,
|
|
|
|
report: 'min'
|
|
|
|
},
|
|
|
|
files: {
|
|
|
|
'dist/css/<%= pkg.name %>.min.css': 'dist/css/<%= pkg.name %>.css',
|
|
|
|
'dist/css/<%= pkg.name %>-theme.min.css': 'dist/css/<%= pkg.name %>-theme.css'
|
|
|
|
}
|
|
|
|
}
|
2013-12-09 08:48:07 +01:00
|
|
|
},
|
|
|
|
|
|
|
|
usebanner: {
|
|
|
|
dist: {
|
2013-08-04 01:03:38 +02:00
|
|
|
options: {
|
2013-12-09 08:48:07 +01:00
|
|
|
position: 'top',
|
|
|
|
banner: '<%= banner %>'
|
2013-05-04 16:55:52 +02:00
|
|
|
},
|
2013-12-09 04:09:27 +01:00
|
|
|
files: {
|
2013-12-09 08:48:07 +01:00
|
|
|
src: [
|
|
|
|
'dist/css/<%= pkg.name %>.css',
|
2013-12-09 09:12:11 +01:00
|
|
|
'dist/css/<%= pkg.name %>.min.css',
|
2013-12-09 08:48:07 +01:00
|
|
|
'dist/css/<%= pkg.name %>-theme.css',
|
2013-12-09 09:12:11 +01:00
|
|
|
'dist/css/<%= pkg.name %>-theme.min.css',
|
2013-12-09 08:48:07 +01:00
|
|
|
]
|
2013-12-09 04:09:27 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-12-09 08:48:07 +01:00
|
|
|
csscomb: {
|
|
|
|
sort: {
|
2013-08-18 03:59:50 +02:00
|
|
|
options: {
|
2013-12-31 22:16:28 +01:00
|
|
|
config: 'less/.csscomb.json'
|
2013-08-18 03:59:50 +02:00
|
|
|
},
|
2013-12-09 04:09:27 +01:00
|
|
|
files: {
|
2013-12-09 08:48:07 +01:00
|
|
|
'dist/css/<%= pkg.name %>.css': ['dist/css/<%= pkg.name %>.css'],
|
2014-01-02 15:46:13 +01:00
|
|
|
'dist/css/<%= pkg.name %>-theme.css': ['dist/css/<%= pkg.name %>-theme.css']
|
2013-12-09 04:09:27 +01:00
|
|
|
}
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-08-18 09:36:51 +02:00
|
|
|
copy: {
|
|
|
|
fonts: {
|
|
|
|
expand: true,
|
2013-09-18 18:50:02 +02:00
|
|
|
src: ['fonts/*'],
|
2013-08-18 09:36:51 +02:00
|
|
|
dest: 'dist/'
|
2013-12-29 07:47:03 +01:00
|
|
|
},
|
2013-12-31 20:38:32 +01:00
|
|
|
docs: {
|
2013-12-29 07:47:03 +01:00
|
|
|
expand: true,
|
2013-12-31 20:38:32 +01:00
|
|
|
cwd: './dist',
|
|
|
|
src: [
|
|
|
|
'{css,js}/*.min.*',
|
2014-01-08 02:08:40 +01:00
|
|
|
'css/*.map',
|
2013-12-31 20:38:32 +01:00
|
|
|
'fonts/*'
|
|
|
|
],
|
|
|
|
dest: 'docs/dist'
|
2013-08-18 09:36:51 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
qunit: {
|
|
|
|
options: {
|
|
|
|
inject: 'js/tests/unit/phantom.js'
|
|
|
|
},
|
|
|
|
files: ['js/tests/*.html']
|
|
|
|
},
|
2013-08-08 08:06:29 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
connect: {
|
|
|
|
server: {
|
|
|
|
options: {
|
|
|
|
port: 3000,
|
|
|
|
base: '.'
|
2013-05-04 16:55:52 +02:00
|
|
|
}
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-08-13 00:01:06 +02:00
|
|
|
jekyll: {
|
|
|
|
docs: {}
|
|
|
|
},
|
|
|
|
|
2013-10-18 04:52:16 +02:00
|
|
|
jade: {
|
|
|
|
compile: {
|
|
|
|
options: {
|
|
|
|
pretty: true,
|
|
|
|
data: function () {
|
|
|
|
var filePath = path.join(__dirname, 'less/variables.less');
|
|
|
|
var fileContent = fs.readFileSync(filePath, {encoding: 'utf8'});
|
|
|
|
var parser = new BsLessdocParser(fileContent);
|
|
|
|
return {sections: parser.parseFile()};
|
|
|
|
}
|
|
|
|
},
|
|
|
|
files: {
|
|
|
|
'docs/_includes/customizer-variables.html': 'docs/customizer-variables.jade'
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-08-13 00:01:06 +02:00
|
|
|
validation: {
|
|
|
|
options: {
|
2013-12-16 04:42:47 +01:00
|
|
|
charset: 'utf-8',
|
|
|
|
doctype: 'HTML5',
|
2013-12-17 10:35:16 +01:00
|
|
|
failHard: true,
|
2013-10-24 08:25:17 +02:00
|
|
|
reset: true,
|
|
|
|
relaxerror: [
|
2013-09-18 18:50:02 +02:00
|
|
|
'Bad value X-UA-Compatible for attribute http-equiv on element meta.',
|
|
|
|
'Element img is missing required attribute src.'
|
2013-10-24 08:25:17 +02:00
|
|
|
]
|
2013-08-13 00:01:06 +02:00
|
|
|
},
|
|
|
|
files: {
|
2013-09-18 18:50:02 +02:00
|
|
|
src: ['_gh_pages/**/*.html']
|
2013-08-13 00:01:06 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
watch: {
|
|
|
|
src: {
|
|
|
|
files: '<%= jshint.src.src %>',
|
|
|
|
tasks: ['jshint:src', 'qunit']
|
|
|
|
},
|
|
|
|
test: {
|
|
|
|
files: '<%= jshint.test.src %>',
|
|
|
|
tasks: ['jshint:test', 'qunit']
|
|
|
|
},
|
2013-12-09 04:09:27 +01:00
|
|
|
less: {
|
2013-08-04 01:03:38 +02:00
|
|
|
files: 'less/*.less',
|
2013-12-09 04:09:27 +01:00
|
|
|
tasks: ['less']
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
2013-11-02 02:15:25 +01:00
|
|
|
},
|
|
|
|
|
|
|
|
sed: {
|
|
|
|
versionNumber: {
|
|
|
|
pattern: (function () {
|
|
|
|
var old = grunt.option('oldver')
|
|
|
|
return old ? RegExp.quote(old) : old
|
|
|
|
})(),
|
|
|
|
replacement: grunt.option('newver'),
|
|
|
|
recursive: true
|
|
|
|
}
|
2013-12-04 03:42:31 +01:00
|
|
|
},
|
|
|
|
|
|
|
|
'saucelabs-qunit': {
|
|
|
|
all: {
|
|
|
|
options: {
|
|
|
|
build: process.env.TRAVIS_JOB_ID,
|
|
|
|
concurrency: 3,
|
|
|
|
urls: ['http://127.0.0.1:3000/js/tests/index.html'],
|
2013-12-30 05:25:40 +01:00
|
|
|
browsers: grunt.file.readYAML('test-infra/sauce_browsers.yml')
|
2013-12-04 03:42:31 +01:00
|
|
|
}
|
|
|
|
}
|
2013-08-04 01:03:38 +02:00
|
|
|
}
|
|
|
|
});
|
2013-05-04 16:55:52 +02:00
|
|
|
|
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// These plugins provide necessary tasks.
|
2013-12-10 14:47:50 +01:00
|
|
|
require('load-grunt-tasks')(grunt, {scope: 'devDependencies'});
|
2013-05-04 16:55:52 +02:00
|
|
|
|
2013-08-13 00:01:06 +02:00
|
|
|
// Docs HTML validation task
|
2013-08-18 22:43:53 +02:00
|
|
|
grunt.registerTask('validate-html', ['jekyll', 'validation']);
|
2013-08-13 00:01:06 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// Test task.
|
2013-12-15 04:09:44 +01:00
|
|
|
var testSubtasks = [];
|
|
|
|
// Skip core tests if running a different subset of the test suite
|
|
|
|
if (!process.env.TWBS_TEST || process.env.TWBS_TEST === 'core') {
|
2013-10-18 04:52:16 +02:00
|
|
|
testSubtasks = testSubtasks.concat(['dist-css', 'csslint', 'jshint', 'jscs', 'qunit', 'build-customizer-vars-form']);
|
2013-12-15 04:09:44 +01:00
|
|
|
}
|
|
|
|
// Skip HTML validation if running a different subset of the test suite
|
|
|
|
if (!process.env.TWBS_TEST || process.env.TWBS_TEST === 'validate-html') {
|
|
|
|
testSubtasks.push('validate-html');
|
|
|
|
}
|
2013-12-04 03:42:31 +01:00
|
|
|
// Only run Sauce Labs tests if there's a Sauce access key
|
2013-12-15 04:09:44 +01:00
|
|
|
if (typeof process.env.SAUCE_ACCESS_KEY !== 'undefined'
|
|
|
|
// Skip Sauce if running a different subset of the test suite
|
|
|
|
&& (!process.env.TWBS_TEST || process.env.TWBS_TEST === 'sauce-js-unit')) {
|
2013-12-04 03:42:31 +01:00
|
|
|
testSubtasks.push('connect');
|
|
|
|
testSubtasks.push('saucelabs-qunit');
|
2013-08-06 09:39:35 +02:00
|
|
|
}
|
|
|
|
grunt.registerTask('test', testSubtasks);
|
2013-05-04 16:55:52 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// JS distribution task.
|
|
|
|
grunt.registerTask('dist-js', ['concat', 'uglify']);
|
2013-05-04 16:55:52 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// CSS distribution task.
|
2013-12-09 09:12:11 +01:00
|
|
|
grunt.registerTask('dist-css', ['less', 'csscomb', 'usebanner']);
|
2013-05-04 16:55:52 +02:00
|
|
|
|
2013-12-31 22:57:35 +01:00
|
|
|
// Docs distribution task.
|
2013-12-31 20:38:32 +01:00
|
|
|
grunt.registerTask('dist-docs', ['copy:docs']);
|
2013-08-18 09:36:51 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// Full distribution task.
|
2014-01-01 03:21:41 +01:00
|
|
|
grunt.registerTask('dist', ['clean', 'dist-css', 'copy:fonts', 'dist-docs', 'dist-js']);
|
2013-05-04 16:55:52 +02:00
|
|
|
|
2013-08-04 01:03:38 +02:00
|
|
|
// Default task.
|
2013-12-19 05:15:23 +01:00
|
|
|
grunt.registerTask('default', ['test', 'dist', 'build-glyphicons-data', 'build-customizer']);
|
2013-08-08 08:06:29 +02:00
|
|
|
|
2013-11-02 02:15:25 +01:00
|
|
|
// Version numbering task.
|
|
|
|
// grunt change-version-number --oldver=A.B.C --newver=X.Y.Z
|
|
|
|
// This can be overzealous, so its changes should always be manually reviewed!
|
|
|
|
grunt.registerTask('change-version-number', ['sed']);
|
|
|
|
|
2014-01-08 07:34:09 +01:00
|
|
|
grunt.registerTask('build-glyphicons-data', generateGlyphiconsData);
|
2013-12-19 05:15:23 +01:00
|
|
|
|
2013-08-08 08:06:29 +02:00
|
|
|
// task for building customizer
|
2013-10-18 04:52:16 +02:00
|
|
|
grunt.registerTask('build-customizer', ['build-customizer-vars-form', 'build-raw-files']);
|
|
|
|
grunt.registerTask('build-customizer-vars-form', ['jade']);
|
|
|
|
grunt.registerTask('build-raw-files', 'Add scripts/less files to customizer.', generateRawFilesJs);
|
2013-09-18 08:04:09 +02:00
|
|
|
};
|