Merge branch 'release/3.1.0'

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 3.1.0
+
+* Replaces `grunt-contrib-sass` with `grunt-sass` (uses `node-sass` under the hood)
+* Uses full path to node modules depenencies, rather than depending on loadPath
+* Small bugfixes when trying to compile sass locally in this repo, due to
+incorrect paths.
+* Add a new partial, `burf-tools`, for minimal uses of Foundation
+* Adds mega menu support for child themes by default.
+* Fixes an issue preventing the icons mixin from being used inside media queries
+* Icon placeholders and classes are now generated from the $icons-responsive map
+* Adds the ability to change the before/after placement of icons globally across
+the theme
+* Fixes skip link issues [#173](https://github.com/bu-ist/responsive-foundation/issues/173)
+* Fixes a spacing issue with hidden page titles [#174](https://github.com/bu-ist/responsive-foundation/issues/174)
+* Adds variable to control gallery margin [#174](https://github.com/bu-ist/responsive-foundation/issues/174)
+* Fixes [#103](https://github.com/bu-ist/responsive-foundation/issues/103)
+* Fixes [#97](https://github.com/bu-ist/responsive-foundation/issues/97) with new `$padding-banner` and `$padding-banner-window-width` variables
+* Fixes [#84](https://github.com/bu-ist/responsive-foundation/issues/84)
+
 ## 3.0.1
 
 * Correct paths from bower_components to node_modules.
@@ -13,6 +32,7 @@
 ## 2.1.12
 
 * Fixed size and positioning of skip-link.
+* Migrate from Bower to npm for frontend dependencies
 
 ## 2.1.11
 * Fixes an issue with external linking. This is a required update for all 2.0 themes.

Gruntfile.js

@@ -1,12 +1,15 @@
 module.exports = function(grunt) {
+
+	// Require external packages.
+	var sass = require('node-sass');
+
 	// Set up a versioned folder for SassDoc
 	var pkg = require('./package.json'),
 		 docsVersionFilePath = 'docs/' + pkg.version;
 
 	grunt.file.mkdir( docsVersionFilePath );
 
-	// Configure Grunt
-
+	// Configure Grunt.
 	grunt.initConfig({
 		pkg: grunt.file.readJSON('package.json'),
 		browserSync: {
@@ -78,14 +81,13 @@ module.exports = function(grunt) {
 			src: ['**']
 		},
 		sass: {
+			options: {
+				implementation: sass,
+				sourceMap: true
+			},
 			docs: {
 				options: {
 					style: 'compressed',
-					loadPath: [
-						'node_modules/normalize-scss/sass',
-						'node_modules/mathsass/dist/',
-						'css-dev'
-					],
 				},
 				files: {
 					'docs/css/docs.css': '_docs/css-dev/docs.scss',
@@ -151,20 +153,23 @@ module.exports = function(grunt) {
 		}
 	});
 
+	// Load Plugins.
 	grunt.loadNpmTasks('grunt-browser-sync');
 	grunt.loadNpmTasks('grunt-contrib-concat');
 	grunt.loadNpmTasks('grunt-contrib-copy');
-	grunt.loadNpmTasks('grunt-contrib-sass');
 	grunt.loadNpmTasks('grunt-contrib-watch');
 	grunt.loadNpmTasks('grunt-gh-pages');
+	grunt.loadNpmTasks('grunt-sass');
 	grunt.loadNpmTasks('grunt-sassdoc');
 	grunt.loadNpmTasks('grunt-version');
 
+	// Register Tasks.
 	grunt.registerTask('build', ['sassdoc']);
 	grunt.registerTask('deploy', ['build', 'gh-pages']);
 	grunt.registerTask('serve', ['build', 'browserSync:current', 'watch']);
 	grunt.registerTask('previewall', ['build', 'browserSync:all', 'watch']);
 
+	// Register default `grunt` task.
 	grunt.registerTask('default', ['serve']);
 
 };

css-dev/burf-base.scss

@@ -3,25 +3,26 @@
 // =================================================================
 
 // dependencies and resets
-@import "normalize/import-now";
-@import "math";
+@import 'node_modules/normalize-scss/sass/normalize/import-now';
+@import 'node_modules/mathsass/dist/math';
 
 // Utilities
-@import "burf-base/config";
-@import "burf-base/mixins";
-@import "burf-base/fonts";
-@import "burf-base/icons/package";
+@import 'burf-base/config';
+@import 'burf-base/mixins';
+@import 'burf-base/fonts';
+@import 'burf-base/icons/package';
 
 // Styles
 @import "burf-base/normalize";
 @import "burf-base/grid/package";
 @import "burf-base/typography";
 @import "burf-base/tables";
 @import "burf-base/forms";
+@import 'burf-base/print';
 
 // =================================================================
 // Tests
 // TODO: Remove before release
 // =================================================================
 
-@import "burf-base/tests";
+@import 'burf-base/tests';

css-dev/burf-base/_config.scss

@@ -2,6 +2,17 @@
 // Variables
 // =================================================================
 
+/// Turns a number of extra classes on or off. This is really only
+/// for the tools partial - you shouldn't use it in a custom theme
+/// unless you're VERY sure you will never need it. Placeholders will
+/// still work when this is set to false. Affects friendly grid classes,
+/// utility classes,
+/// @group grid
+/// @access public
+/// @since 2.1.11
+
+$burf-extras:                                       true !default;
+
 /// Whether or not to print media queries in your stylesheet.
 /// If you set this to false, it will print media queries in the
 /// order they are declared so that desktop styles will always

css-dev/burf-base/_fonts.scss

@@ -83,18 +83,3 @@
 	font-style: italic;
 	font-weight: 700;
 }
-
-// BU Default Icons
-// -----------------------------------------------------------------
-
-@font-face {
-	font-family: 'BU-Default-Icons';
-	src: url( '//www.bu.edu/cdn/fonts/icons/bu-default-icons/bu-default-icons.eot' );
-	src: url( '//www.bu.edu/cdn/fonts/icons/bu-default-icons/bu-default-icons.eot?#iefix' ) format( 'embedded-opentype' ),
-		url( '//www.bu.edu/cdn/fonts/icons/bu-default-icons/bu-default-icons.woff' ) format( 'woff' ),
-		url( '//www.bu.edu/cdn/fonts/icons/bu-default-icons/bu-default-icons.ttf' ) format( 'truetype' ),
-		url( '//www.bu.edu/cdn/fonts/icons/bu-default-icons/bu-default-icons.svg#bu-default-icons' ) format( 'svg' );
-	font-style: normal;
-	font-weight: 400;
-	// unicode-range:U+??????; /* Include all Unicode possiblities */
-}

css-dev/burf-base/_mixins.scss

@@ -23,15 +23,20 @@
 /// @access public
 /// @since 1.0.0
 
-%clearfix,
-.u-clearfix {
+%clearfix {
 	&::after {
 		display: table;
 		clear: both;
 		content: "";
 	}
 }
 
+@if $burf-extras {
+	.u-clearfix {
+		@extend %clearfix;
+	}
+}
+
 /// A mixin for border-radius. Takes care of browser
 /// prefixes for you. You should always use this mixin
 /// when writing border-radius rules to ensure you're
@@ -558,13 +563,18 @@
 /// @access public
 /// @since 1.0.0
 
-%hide-text,
-.u-hide-text {
+%hide-text {
 	overflow: hidden;
 	text-indent: 100%;
 	white-space: nowrap;
 }
 
+@if $burf-extras {
+	.u-hide-text {
+		@extend %hide-text;
+	}
+}
+
 /// Hides entire elements visually, but preserves visibility for
 /// screen readers. Use this placeholder when an element is only
 /// for screen readers and needs no visual representation on the site.
@@ -581,8 +591,7 @@
 /// @access public
 /// @since 1.0.0
 
-%visually-hidden,
-.u-visually-hidden {
+%visually-hidden {
 	border: 0;
 	clip: rect( 0, 0, 0, 0 ); // Deprecated. Remove when clip-path support is better.
 	-webkit-clip-path: inset( 50% );
@@ -595,6 +604,12 @@
 	width: 1px;
 }
 
+@if $burf-extras {
+	.u-visually-hidden {
+		@extend %visually-hidden;
+	}
+}
+
 /// Reverses `%visually-hidden`. Helpful if you want to
 /// unhide a previously hidden label.
 /// @example
@@ -626,8 +641,10 @@
 /// @access public
 /// @since 2.0.0
 
-.u-hide {
-	display: none;
+@if $burf-extras {
+	.u-hide {
+		display: none;
+	}
 }
 
 /// A class for developers to use to quickly prototype filtering.
@@ -639,8 +656,10 @@
 /// @access public
 /// @since 2.0.0
 
-.u-show {
-	display: block;
+@if $burf-extras {
+	.u-show {
+		display: block;
+	}
 }
 
 /// A class for developers to use to enable style matching to
@@ -652,8 +671,10 @@
 /// @access public
 /// @since 2.0.0
 
-.u-padding {
-	padding: $padding;
+@if $burf-extras {
+	.u-padding {
+		padding: $padding;
+	}
 }
 
 /// A class for developers to use to enable style matching to
@@ -665,8 +686,10 @@
 /// @access public
 /// @since 2.0.0
 
-.u-margin {
-	margin: $margin;
+@if $burf-extras {
+	.u-margin {
+		margin: $margin;
+	}
 }
 
 /// A safe way to including responsive styles on old browers which
@@ -712,7 +735,7 @@
 		@error 'The breakpoint shortcut "#{$point}" is no longer supported as of Responsive 2.0. \a Use the direct breakpoint variable ($#{$point}) instead. \a If want to use max-width, write a plain @media query.';
 	}
 	@if ( $mqs ) {
-		@media screen and ( min-width: $point ) {
+		@media ( min-width: $point ) {
 			@content;
 		}
 	} @else {

css-dev/burf-base/_normalize-variables.scss

@@ -0,0 +1,20 @@
+// =================================================================
+// Global Settings
+// =================================================================
+
+/// Controls the default color used for text across the site.
+/// Affects body text and anything else that isn't
+/// specifically overridden.
+/// @group 01-config
+/// @access public
+/// @since 1.0.0
+/// @accessibility AA
+
+$color-base:                                $color-grayscale-5 !default;
+
+/// Base margin for the section tag.
+/// @group 01-config
+/// @access public
+/// @since 2.0.0
+
+$margin-section:                            $margin-large 0 0 !default;