garth-jekyll-theme 0.1.8 → 0.1.9

data/_sass/bourbon/{addons → bourbon/library}/_clearfix.scss

@@ -2,24 +2,24 @@
 
 /// Provides an easy way to include a clearfix for containing floats.
 ///
-/// @link http://cssmojo.com/latest_new_clearfix_so_far/
+/// @link http://goo.gl/yP5hiZ
 ///
-/// @example scss - Usage
+/// @example scss
 ///   .element {
 ///     @include clearfix;
 ///   }
 ///
-/// @example css - CSS Output
+/// @example css
 ///   .element::after {
 ///     clear: both;
 ///     content: "";
-///     display: table;
+///     display: block;
 ///   }
 
 @mixin clearfix {
   &::after {
     clear: both;
     content: "";
-    display: table;
+    display: block;
   }
 }

data/_sass/bourbon/bourbon/library/_contrast-switch.scss

@@ -0,0 +1,60 @@
+@charset "UTF-8";
+
+/// Switches between two colors based on the lightness of a another color. Great
+/// for building button styles.
+///
+/// @argument {color} $base-color
+///   The color to evaluate lightness against.
+///
+/// @argument {color} $dark-color [#000]
+///   The color to be output when `$base-color` is light.
+///
+/// @argument {color} $light-color [#fff]
+///   The color to be output when `$base-color` is dark.
+///
+/// @return {color}
+///
+/// @example scss
+///   .first-element {
+///     color: contrast-switch(#bae6e6);
+///   }
+///
+///   .second-element {
+///     $button-color: #2d72d9;
+///     background-color: $button-color;
+///     color: contrast-switch($button-color, #222, #eee);
+///   }
+///
+/// @example css
+///   .first-element {
+///     color: #000;
+///   }
+///
+///   .second-element {
+///     background-color: #2d72d9;
+///     color: #eee;
+///   }
+///
+/// @require {function} _is-light
+///
+/// @since 5.0.0
+
+@function contrast-switch(
+    $base-color,
+    $dark-color: _retrieve-bourbon-setting("contrast-switch-dark-color"),
+    $light-color: _retrieve-bourbon-setting("contrast-switch-light-color")
+  ) {
+
+  @if not _is-color($base-color) {
+    @error "`#{$base-color}` is not a valid color for the `$base-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else if not _is-color($dark-color) {
+    @error "`#{$dark-color}` is not a valid color for the `$dark-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else if not _is-color($light-color) {
+    @error "`#{$light-color}` is not a valid color for the `$light-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else {
+    @return if(_is-light($base-color), $dark-color, $light-color);
+  }
+}

data/_sass/bourbon/{addons → bourbon/library}/_ellipsis.scss

@@ -2,15 +2,18 @@
 
 /// Truncates text and adds an ellipsis to represent overflow.
 ///
-/// @param {Number} $width [100%]
-///   Max-width for the string to respect before being truncated
+/// @argument {number} $width [100%]
+///   The `max-width` for the string to respect before being truncated.
 ///
-/// @example scss - Usage
+/// @argument {string} $display [inline-block]
+///   Sets the display-value of the element.
+///
+/// @example scss
 ///   .element {
 ///     @include ellipsis;
 ///   }
 ///
-/// @example css - CSS Output
+/// @example css
 ///   .element {
 ///     display: inline-block;
 ///     max-width: 100%;
@@ -20,8 +23,12 @@
 ///     word-wrap: normal;
 ///   }
 
-@mixin ellipsis($width: 100%) {
-  display: inline-block;
+@mixin ellipsis(
+    $width: 100%,
+    $display: inline-block
+  ) {
+
+  display: $display;
   max-width: $width;
   overflow: hidden;
   text-overflow: ellipsis;

data/_sass/bourbon/bourbon/library/_font-face.scss

@@ -0,0 +1,65 @@
+@charset "UTF-8";
+
+/// Generates an `@font-face` declaration. You can choose the specific file
+/// formats you need to output; the mixin supports `eot`, `ttf`, `svg`, `woff2`
+/// and `woff`. The mixin also supports usage with the Rails Asset Pipeline,
+/// which you can enable per use, or globally in the `$bourbon()` settings.
+///
+/// @argument {string} $font-family
+///
+/// @argument {string} $file-path
+///
+/// @argument {string} $asset-pipeline [false]
+///   Set to `true` if you’re using the Rails Asset Pipeline (place the fonts
+///   in `app/assets/fonts/`).
+///
+/// @argument {string | list} $file-formats [("ttf", "woff2", "woff")]
+///   Pass a list of file formats to support,
+///   for example ("eot", "ttf", "svg", "woff2", "woff").
+///
+/// @content
+///   Any additional CSS properties that are included in the `@include`
+///   directive will be output within the `@font-face` declaration, e.g. you can
+///   pass in `font-weight`, `font-style` and/or `unicode-range`.
+///
+/// @example scss
+///   @include font-face(
+///       "source-sans-pro",
+///       "fonts/source-sans-pro-regular",
+///       ("woff2", "woff")
+///     ) {
+///     font-style: normal;
+///     font-weight: 400;
+///   }
+///
+/// @example css
+///   @font-face {
+///     font-family: "source-sans-pro";
+///     src: url("fonts/source-sans-pro-regular.woff2") format("woff2"),
+///          url("fonts/source-sans-pro-regular.woff") format("woff");
+///     font-style: normal;
+///     font-weight: 400;
+///   }
+///
+/// @require {function} _font-source-declaration
+///
+/// @require {function} _retrieve-bourbon-setting
+
+@mixin font-face(
+    $font-family,
+    $file-path,
+    $file-formats: _retrieve-bourbon-setting("global-font-file-formats"),
+    $asset-pipeline: _retrieve-bourbon-setting("rails-asset-pipeline")
+  ) {
+
+  @font-face {
+    font-family: $font-family;
+    src: _font-source-declaration(
+      $font-family,
+      $file-path,
+      $asset-pipeline,
+      $file-formats
+    );
+    @content;
+  }
+}

data/_sass/bourbon/bourbon/library/_font-stacks.scss

@@ -0,0 +1,87 @@
+@charset "UTF-8";
+
+////
+/// @type list
+///
+/// @link goo.gl/Cxb26i
+////
+
+$font-stack-helvetica: (
+  "Helvetica Neue",
+  "Helvetica",
+  "Arial",
+  sans-serif,
+);
+
+$font-stack-lucida-grande: (
+  "Lucida Grande",
+  "Lucida Sans Unicode",
+  "Geneva",
+  "Verdana",
+  sans-serif,
+);
+
+$font-stack-verdana: (
+  "Verdana",
+  "Geneva",
+  sans-serif,
+);
+
+$font-stack-system: (
+  -apple-system,
+  BlinkMacSystemFont,
+  "Segoe UI",
+  "Roboto",
+  "Oxygen",
+  "Ubuntu",
+  "Cantarell",
+  "Fira Sans",
+  "Droid Sans",
+  "Helvetica Neue",
+  sans-serif,
+);
+
+$font-stack-garamond: (
+  "Garamond",
+  "Baskerville",
+  "Baskerville Old Face",
+  "Hoefler Text",
+  "Times New Roman",
+  serif,
+);
+
+$font-stack-georgia: (
+  "Georgia",
+  "Times",
+  "Times New Roman",
+  serif,
+);
+
+$font-stack-hoefler-text: (
+  "Hoefler Text",
+  "Baskerville Old Face",
+  "Garamond",
+  "Times New Roman",
+  serif,
+);
+
+$font-stack-consolas: (
+  "Consolas",
+  "monaco",
+  monospace,
+);
+
+$font-stack-courier-new: (
+  "Courier New",
+  "Courier",
+  "Lucida Sans Typewriter",
+  "Lucida Typewriter",
+  monospace,
+);
+
+$font-stack-monaco: (
+  "monaco",
+  "Consolas",
+  "Lucida Console",
+  monospace,
+);

data/_sass/bourbon/bourbon/library/_hide-text.scss

@@ -0,0 +1,24 @@
+@charset "UTF-8";
+
+/// Hides the text in an element, commonly used to show an image instead. Some
+/// elements will need block-level styles applied.
+///
+/// @link http://goo.gl/EvLRIu
+///
+/// @example scss
+///   .element {
+///     @include hide-text;
+///   }
+///
+/// @example css
+///   .element {
+///     overflow: hidden;
+///     text-indent: 101%;
+///     white-space: nowrap;
+///   }
+
+@mixin hide-text {
+  overflow: hidden;
+  text-indent: 101%;
+  white-space: nowrap;
+}

data/_sass/bourbon/bourbon/library/_hide-visually.scss

@@ -0,0 +1,65 @@
+@charset "UTF-8";
+
+/// Hides an element visually while still allowing the content to be accessible
+/// to assistive technology, e.g. screen readers. Passing `unhide` will reverse
+/// the affects of the hiding, which is handy for showing the element on focus,
+/// for example.
+///
+/// @link http://goo.gl/Vf1TGn
+///
+/// @argument {string} $toggle [hide]
+///   Accepts `hide` or `unhide`. `unhide` reverses the affects of `hide`.
+///
+/// @example scss
+///   .element {
+///     @include hide-visually;
+///
+///     &:active,
+///     &:focus {
+///       @include hide-visually(unhide);
+///     }
+///   }
+///
+/// @example css
+///   .element {
+///     border: 0;
+///     clip: rect(1px, 1px, 1px, 1px);
+///     clip-path: circle(1% at 1% 1%);
+///     height: 1px;
+///     overflow: hidden;
+///     padding: 0;
+///     position: absolute;
+///     width: 1px;
+///   }
+///
+///   .hide-visually:active,
+///   .hide-visually:focus {
+///     clip: auto;
+///     clip-path: none;
+///     height: auto;
+///     overflow: visible;
+///     position: static;
+///     width: auto;
+///   }
+///
+/// @since 5.0.0
+
+@mixin hide-visually($toggle: hide) {
+  @if $toggle == "hide" {
+    border: 0;
+    clip: rect(1px, 1px, 1px, 1px);
+    clip-path: circle(1% at 1% 1%);
+    height: 1px;
+    overflow: hidden;
+    padding: 0;
+    position: absolute;
+    width: 1px;
+  } @else if $toggle == "unhide" {
+    clip: auto;
+    clip-path: none;
+    height: auto;
+    overflow: visible;
+    position: static;
+    width: auto;
+  }
+}

data/_sass/bourbon/bourbon/library/_margin.scss

@@ -0,0 +1,34 @@
+@charset "UTF-8";
+
+/// Provides a quick method for targeting `margin` on specific sides of a
+/// box. Use a `null` value to “skip” a side.
+///
+/// @argument {arglist} $values
+///   List of margin values, defined as CSS shorthand.
+///
+/// @example scss
+///   .element-one {
+///     @include margin(null auto);
+///   }
+///
+///   .element-two {
+///     @include margin(10px 3em 20vh null);
+///   }
+///
+/// @example css
+///   .element-one {
+///     margin-left: auto;
+///     margin-right: auto;
+///   }
+///
+///   .element-two {
+///     margin-bottom: 20vh;
+///     margin-right: 3em;
+///     margin-top: 10px;
+///   }
+///
+/// @require {mixin} _directional-property
+
+@mixin margin($values...) {
+  @include _directional-property(margin, false, $values...);
+}

data/_sass/bourbon/bourbon/library/_modular-scale.scss

@@ -0,0 +1,113 @@
+@charset "UTF-8";
+
+/// Increments up or down a defined scale and returns an adjusted value. This
+/// helps establish consistent measurements and spacial relationships throughout
+/// your project. We provide a list of commonly used scales as
+/// [pre-defined variables][scales].
+///
+/// [scales]: https://github.com/thoughtbot/bourbon/blob/master/core/bourbon/settings/_scales.scss
+///
+/// @argument {number (unitless)} $increment
+///   How many steps to increment up or down the scale.
+///
+/// @argument {number (with unit) | list} $value [1em]
+///   The base value the scale starts at.
+///
+/// @argument {number (unitless)} $ratio [1.25]
+///   The ratio the scale is built on.
+///
+/// @return {number (with unit)}
+///
+/// @example scss
+///   .first-element {
+///     font-size: modular-scale(2);
+///   }
+///
+///   .second-element {
+///     margin-right: modular-scale(3, 2em);
+///   }
+///
+///   .third-element {
+///     font-size: modular-scale(3, 1em 1.6em, $major-seventh);
+///   }
+///
+///   // Globally change the base ratio
+///   $bourbon: (
+///     "modular-scale-ratio": 1.2,
+///   );
+///
+///   .fourth-element {
+///     font-size: modular-scale(3);
+///   }
+///
+/// @example css
+///   .first-element {
+///     font-size: 1.5625em;
+///   }
+///
+///   .second-element {
+///     margin-right: 3.90625em;
+///   }
+///
+///   .third-element {
+///     font-size: 3em;
+///   }
+///
+///   .fourth-element {
+///     font-size: 1.728em;
+///   }
+///
+/// @require {function} _retrieve-bourbon-setting
+
+@function modular-scale(
+    $increment,
+    $value: _retrieve-bourbon-setting("modular-scale-base"),
+    $ratio: _retrieve-bourbon-setting("modular-scale-ratio")
+  ) {
+
+  $v1: nth($value, 1);
+  $v2: nth($value, length($value));
+  $value: $v1;
+
+  // scale $v2 to just above $v1
+  @while $v2 > $v1 {
+    $v2: ($v2 / $ratio); // will be off-by-1
+  }
+  @while $v2 < $v1 {
+    $v2: ($v2 * $ratio); // will fix off-by-1
+  }
+
+  // check AFTER scaling $v2 to prevent double-counting corner-case
+  $double-stranded: $v2 > $v1;
+
+  @if $increment > 0 {
+    @for $i from 1 through $increment {
+      @if $double-stranded and ($v1 * $ratio) > $v2 {
+        $value: $v2;
+        $v2: ($v2 * $ratio);
+      } @else {
+        $v1: ($v1 * $ratio);
+        $value: $v1;
+      }
+    }
+  }
+
+  @if $increment < 0 {
+    // adjust $v2 to just below $v1
+    @if $double-stranded {
+      $v2: ($v2 / $ratio);
+    }
+
+    @for $i from $increment through -1 {
+      @if $double-stranded and ($v1 / $ratio) < $v2 {
+        $value: $v2;
+        $v2: ($v2 / $ratio);
+      } @else {
+        $v1: ($v1 / $ratio);
+        $value: $v1;
+      }
+    }
+  }
+
+  @return $value;
+}