Merge branch 'release/4.0.0'

.codeclimate.yml

@@ -5,6 +5,9 @@ exclude_paths:
   - languages/
   - vendor/
   - js/vendor/
+  - _styleguide/
+  - _docs/
+  - docs/
   - ".sass-cache/"
   - "*.min.css"
   - "*.min.js"

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## Unreleased
+
+## 4.0.0
+
+* Adds CSS Grid support to the grid, with an automatic fallback to floats
+  for unsupported browsers.
+* Adds support for color stops to the linear gradient mixin. New syntax:
+  `@include linear-gradient(to right, #E47D7D 0%, #C195D3 50%, #4FB4E8 100%);`
+* Ensures BU Hub required icons are always output, even if you turn icons off.
+* Adds a skip link mixin and moves styles to the accessibility partial.
+* Fixes https://github.com/bu-ist/responsive-foundation/issues/208
+* Adds support for KSS documentation and officially switches us from SassDoc
+
 ## 3.2.2
 
 * Adds Medium, Medium Alt, and Rhett support to default icons.

Gruntfile.js

@@ -7,9 +7,13 @@ const pkg = require( './package.json' );
 
 module.exports = ( grunt ) => {
 	const docsVersionFilePath = `docs/${ pkg.version }`;
+	const kssDocsFilePath = docsVersionFilePath + '/kss-assets/docs.css';
+	const kssDocsCustomCSSPath = docsVersionFilePath + '/kss-assets/kss-custom.css';
 
 	grunt.file.mkdir( docsVersionFilePath );
 
+	require('time-grunt')(grunt);
+
 	// Configure Grunt.
 	grunt.initConfig( {
 		pkg: grunt.file.readJSON( 'package.json' ),
@@ -70,37 +74,15 @@ module.exports = ( grunt ) => {
 		browserSync: {
 			current: {
 				bsFiles: {
-					src: [
-						`${ docsVersionFilePath }/css/*.css`,
-						`${ docsVersionFilePath }/*.html`,
-					],
-				},
-				options: {
-					watchTask: true,
-					server: {
-						baseDir: docsVersionFilePath,
-					},
-					plugins: [
-						{
-							module: 'bs-html-injector',
-							options: {
-								files: `${ docsVersionFilePath }/*.html`,
-							},
-						},
-					],
-				},
-			},
-			all: {
-				bsFiles: {
-					src: [ 'docs/*.html', 'docs/css/*.css', 'docs/js/*.js' ],
+					src : docsVersionFilePath + '*.html'
 				},
 				options: {
 					watchTask: true,
 					server: {
-						baseDir: './docs',
-					},
-				},
-			},
+						baseDir: docsVersionFilePath
+					}
+				}
+			}
 		},
 		concat: {
 			docs: {
@@ -110,28 +92,17 @@ module.exports = ( grunt ) => {
 			},
 		},
 		copy: {
-			alpha: {
-				expand: true,
-				cwd: '_docs/0.1.0',
-				src: [ '**/*.html', 'vendor/**/*' ],
-				dest: 'docs/0.1.0',
-			},
-			one: {
-				expand: true,
-				cwd: '_docs/1.0.0',
-				src: [ '**/*.html', 'assets/**/*' ],
-				dest: 'docs/1.0.0',
-			},
 			docs: {
 				expand: true,
 				cwd: '_docs',
-				src: [ '**/*.html', 'vendor/**/*' ],
+				src: [ '**/*.html' ],
 				dest: 'docs',
 			},
 		},
 		'gh-pages': {
 			options: {
 				base: 'docs',
+				only: [ 'index.html', docsVersionFilePath ]
 			},
 			src: [ '**' ],
 		},
@@ -146,8 +117,8 @@ module.exports = ( grunt ) => {
 				},
 				files: {
 					'docs/css/docs.css': '_docs/css-dev/docs.scss',
-					'css/burf-base.css': 'css-dev/burf-base.scss',
-					'css/burf-theme.css': 'css-dev/burf-theme.scss',
+					kssDocsFilePath: '_docs/css-dev/docs.scss',
+					kssDocsCustomCSSPath: '_docs/css-dev/kss-custom.scss'
 				},
 			},
 		},
@@ -162,21 +133,8 @@ module.exports = ( grunt ) => {
 						autoprefixer, // add vendor prefixes.
 					],
 				},
-				src: ['css/burf-theme.css', 'css/burf-base.css'],
-			},
-			docs: {
-				options: {
-					map: {
-						inline: false, // Save all sourcemaps as separate files.
-						annotation: 'docs/css/', // Save to this specified directory.
-					},
-					processors: [
-						autoprefixer, // add vendor prefixes.
-					],
-				},
-				src: 'docs/css/docs.css',
-				dest: 'docs/css/docs.css',
-			},
+				src: [ 'css/burf-theme.css', 'css/burf-base.css' ],
+			}
 		},
 		watch: {
 			grunt: {
@@ -198,48 +156,41 @@ module.exports = ( grunt ) => {
 					'_docs/css-dev/*.scss',
 					'css-dev/**/*.scss',
 				],
-				tasks: ['sass', 'postcss'],
-			},
-			vendor: {
-				files: [ '_docs/vendor/**/*' ],
-				tasks: [ 'copy' ],
+				tasks: [ 'sass' ],
 			},
+			styleguide: {
+				files: [
+					'_docs/css-dev/*.scss',
+					'css-dev/**/*.scss',
+					'css-dev/**/*.hbs',
+				],
+				tasks: [ 'kss' ],
+			}
 		},
 		sasslint: {
 			target: 'css-dev/**/*.scss',
 			// see .sasslintrc for options.
 		},
-		sassdoc: {
-			src: 'css-dev/**/*.scss',
+		kss: {
 			options: {
-				display: {
-					access: [ 'public' ],
-				},
-				dest: docsVersionFilePath,
-				theme: 'node_modules/sassdoc-theme-budocs',
-				basePath: `https://github.com/bu-ist/responsive-foundation/tree/${
-					pkg.version
-				}/css-dev`,
-				groups: {
-					'01-config': 'Global Configuration',
-					'02-mixins': 'Helpers',
-					'03-icons': 'Icons',
-					'04-typography': 'Typography',
-					'05-grid': 'Grid',
-					'06-navigation': 'Navigation',
-					'07-branding': 'Branding',
-					'08-layout': 'Layout',
-					'09-content': 'Content',
-					'10-widgets': 'Widgets',
-					'11-forms': 'Forms',
-					'12-news': 'News',
-					'13-calendar': 'Calendar',
-					'14-profiles': 'Profiles',
-					'wp-admin': 'WordPress Admin',
-				},
+				title: 'Responsive Foundation ' + pkg.version,
+				builder: 'node_modules/id-kss-builder',
+				css: [
+				  "kss-assets/docs.css",
+				],
+				extend: 'node_modules/id-kss-builder/extend',
+				gitURL: 'https://github.com/bu-ist/responsive-foundation/',
+				gitURLCSSDEV: 'https://github.com/bu-ist/responsive-foundation/tree/master/css-dev/',
+				customCSS: 'kss-assets/kss-custom.css'
 			},
+			dist: {
+				src: [
+					'css-dev'
+				],
+				dest: docsVersionFilePath
+			}
 		},
-	} );
+	});
 
 	// Load Plugins.
 	grunt.loadNpmTasks( 'grunt-babel' );
@@ -251,16 +202,14 @@ module.exports = ( grunt ) => {
 	grunt.loadNpmTasks( 'grunt-contrib-uglify' );
 	grunt.loadNpmTasks( 'grunt-contrib-watch' );
 	grunt.loadNpmTasks( 'grunt-gh-pages' );
-  grunt.loadNpmTasks( 'grunt-postcss' );
 	grunt.loadNpmTasks( 'grunt-sass' );
 	grunt.loadNpmTasks( 'grunt-sass-lint' );
-	grunt.loadNpmTasks( 'grunt-sassdoc' );
-
-	grunt.registerTask( 'build', [ 'js', 'sassdoc' ] );
+	grunt.loadNpmTasks( 'grunt-kss' );
+	grunt.registerTask( 'build', [ 'js', 'kss', 'copy' ] );
 	grunt.registerTask( 'deploy', [ 'build', 'gh-pages' ] );
+	grunt.registerTask( 'js', [ 'clean:js', 'babel', 'browserify', 'uglify' ] );
 	grunt.registerTask( 'serve', [ 'build', 'browserSync:current', 'watch' ] );
 	grunt.registerTask( 'previewall', [ 'build', 'browserSync:all', 'watch' ] );
-	grunt.registerTask( 'js', [ 'clean:js', 'babel', 'browserify', 'uglify' ] );
 
 	// Register default `grunt` task.
 	grunt.registerTask( 'default', [ 'serve' ] );